Sanic: Sanic Documentation

[sinahmr]

I'm going to use Sanic 0.4 (or maybe 0.5 in few days), but it seems the documentation here is out of date.
Am I right? Won't you update documents in readthedocs?
Thanks.

[qwexvf]

maybe there's a few things outdated, but you can do almost everything the same.

at least what i can confirm is that listeners are not working for me...

[messense]

The documentation on ReadTheDocs is apparently out of date, the title says Sanic 0.31 documentation while the latest version is 0.4.1.

Something is wrong with ReadTheDocs build I think.

[r0fls]

@channelcat @seemethere @kdelwat I can't even log into my http://readthedocs.io account (apparently I have two and can't reset the one with access to Github). If any of you can look into why the build is breaking that would be awesome.

[sinahmr]

@messense
So can you help me to build it myself?
When I write "make html" command in my sanic/docs directory, I get the following error:
Running Sphinx v1.3.6 Exception occurred: File "conf.py", line 14, in <module> from recommonmark.parser import CommonMarkParser ImportError: No module named recommonmark.parser The full traceback has been saved in /tmp/sphinx-err-M6Tal3.log, if you want to report the issue to the developers. Please also report this if it was a user error, so that a better error message can be provided next time. A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks! Makefile:20: recipe for target 'html' failed make: *** [html] Error 1
(recommonmark itself is installed in my system)

[messense]

@sinahmr pip install -Ur requirements-dev.txt

[sinahmr]

@messense Tnx

[kdelwat]

@r0fls I will look into the issue in the next day or two.

[messense]

After #561 merged ReadTheDocs build still seems broken.
Would you guys consider uploading documentation to http://pythonhosted.org/ for now?

[seemethere]

Doesn't appear to be broken, I think it just generates docs on a release.

[seemethere]

Just manually triggered a build and it seems to be working fine when I trigger it manually.

[kdelwat]

@messence @seemethere On my test ReadTheDocs account it definitely now works fine. Could be a problem with the Git hook?

[seemethere]

@kdelwat I'd believe so but I don't have admin access to the repo so it could be difficult to discern.

@channelcat to the rescue?

[r0fls]

This looks to be working fine now. Anyone feel free to reopen if there is still an issue.