Re: [Twisted-Python] Pydoc parameter formatting and explaining interfaces

2016-07-26 Thread Clayton Daley
Speaking just from my own experience, I don't think it's a problem with the docs per se. Rather, I think there's often a disconnect between the answers people are looking for and the nature of Twisted. It's hard to explain, but this is the best I can manage: - If you're used to using framewor

Re: [Twisted-Python] Pydoc parameter formatting and explaining interfaces

2016-07-26 Thread Glyph Lefkowitz
> On Jul 26, 2016, at 9:37 AM, Daniel Sank wrote: > > This is a branch from the thread with subject "Request for help with Twisted > bindings in M2Crypt". > > Regarding my inability to read documentation: > > > This does at least point to a real problem with pydoctor in the way it > > presen