Re: [Rdkit-discuss] looking for feedback on new python API documentation format

2017-03-29 Thread Rocco Moretti
One potential issue with the new pdoc documentation is how it handles (or rather doesn't) namespace transclusions. For example, say you were looking for documentation on rdkit.Chem.MolFromMolFile. If you go to the rdkit.Chem page for pdoc ( http://rdkit.org/docs_temp/Chem/index.html) MolFromMolFil

Re: [Rdkit-discuss] looking for feedback on new python API documentation format

2017-03-28 Thread Juuso Lehtivarjo
Hi Greg, Here's my user case: usually I want to find out the details of a certain class/function I already know of, but I may not have a clue to which module that class/function belongs to. This is where the alphabetical index of epydoc is often quite handy. Of course a proper search within the doc

Re: [Rdkit-discuss] looking for feedback on new python API documentation format

2017-03-28 Thread Peter S. Shenkin
Hi, Greg, Here are my comments. - Formatting - pdoc at a glance is certainly more handsome than epydoc - To my eye, there is a huge amount of wasted space in the pdoc documentation. - The line spacing is hugely disproportional to the font size - Maybe this