#readthedocs

oh wait it uses epydoc

so pydoctor is more getting the docstrings out, doing html on them, and spitting them out

the actual parsing of epydoc docstrings is still done by epydoc

but pydoctor figures things out like subclasses of the object, object bases, zope.interface junk

cool

we don't care about epydoc docstrings -- we just want raw docstrings

hopefully in rst

right :)

well pydoctor will get you the raw docstrings no problem

i just want to be able to take a bunch of .py files and output a python object hierarchy with docstrings

yup :)

Documentable.docstring will get it for you

awesome

plus do the aforementioned stuff like subclasses

i'll likely keep going w/ epydoc for now, since I already wrote it, but I've already hit a few bugs -- and swapping out pydoctor seems like it should be easy

ericholscher: also worth noting

pydoctor has "systems"

which is a collection of packages i guess

which is where it figures out the subclasses and things

may or may not be useful depending on whether that information is useful to you

ericholscher: also mandatory epydoc format > rst ;)

heh

well. epydoc > whatever on earth autodoc uses

if there's something that's not the weird :param foo: thing then :)

ericholscher: do ping me when you have something workable

yup -- will do

ericholscher: i would love to evaluate whether it's something the twisted project could make use of

will likely be a few more weeks -- time is hard

for sure

rtd is already useful for trunk docs

we're figuring out how to do that for apidocs

(because in twisted theyre generated by two different things)

yup, thats what we're trying to fix as well :)

and unfortunately there is no pydoctor-aaS

I hate sphinx's apidoc stuff

at least for our use case

i tried to use it at oldwork

old coworkers loved import-time side effects.

you can imagine where this got us

haha, indeed

Hi, is there anyone that can help me here?

I've got a project hosted in readthedocs and it works fine. http://zanata.readthedocs.org/en/latest/, but when I try to navigate from my own domain (with CNAMe config), the generated link on the left doesn't work after first click. http://docs.zanata.org/

anyone here have any luck getting a mkdocs github project to compile? Mine seems to fail at finding my .md files yet when I build on my machine it is fine

aeng: probably a mkdocs bug

we don't really support mkdocs

probably best to ask the maintainers of it

ericholscher, i've filed a bug in the github

hopefully they reply

hmm, might be an nginx bug -- no sure

hmmm. I thought according to this it was supported http://docs.readthedocs.org/en/latest/builds.html

Plus, the Getting Started Guide for the latest version says it supports it as well: http://docs.readthedocs.org/en/latest/getting_s...