Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread exarkun
On 04:20 am, t...@recursivedream.com wrote: >Finally, my biggest hurdle right now is not knowing how to *find* said >branches. I don't see "documentation" as a category in Trac and common >keyword searches didn't show up much for me. I'm sure this is an easy >question to answer, though. http://twi

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Glyph Lefkowitz
On Jan 21, 2011, at 8:29 AM, exar...@twistedmatrix.com wrote: > I don't think it makes sense to put anything on Launchpad for now. > Eventually it needs to go into the canonical Twisted repository, but if > it's easier to leave it in GitHub for now, that's fine. The only reason I even suggeste

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Tom Davis
On Fri, Jan 21, 2011 at 5:35 PM, Glyph Lefkowitz wrote: > > On Jan 21, 2011, at 8:29 AM, exar...@twistedmatrix.com wrote: > > I don't think it makes sense to put anything on Launchpad for now. > Eventually it needs to go into the canonical Twisted repository, but if > it's easier to leave it in Gi

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Michael Thompson
On 21 January 2011 22:35, Glyph Lefkowitz wrote: >  I don't believe we have a mirror on > github, but maybe somebody could correct me. There are 79 repos on github that match the word twisted. This one claims to be updated every 15 minutes and seems to be pretty up to date (has a commit from 13

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread James Y Knight
> On 21 January 2011 22:35, Glyph Lefkowitz wrote: >> �I don't believe we have a mirror on >> github, but maybe somebody could correct me. > > There are 79 repos on github that match the word twisted. > > This one claims to be updated every 15 minutes and seems to be pretty > up to date (has a com

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Glyph Lefkowitz
On Jan 20, 2011, at 1:54 PM, Kevin Horn wrote: > The biggest problem with this is that you will find that a very small group > of people have created the vast majority of this stuff and don't have time to > maintain it all any more :). We certainly don't have a separate dedicated > maintainer

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Glyph Lefkowitz
On Jan 20, 2011, at 7:43 PM, Kevin Horn wrote: > It could even use Lore's parser, twisted.lore.tree.parseFileAndReport ;) > > Jean-Paul > > > Yes, but: > > - The docs (well, docstrings) aren't very clear about exactly what that does, > or what quirks it might or might not have. The source

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Glyph Lefkowitz
I have a lot of input here, but as the guys actually doing the work, the final say is mostly with you and Tom. So, please feel free to take everything here with a grain of salt. On Jan 20, 2011, at 2:58 PM, Kevin Horn wrote: > Here's some things I had "planned" (yes, I'm using the term loosely

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread Glyph Lefkowitz
On Jan 20, 2011, at 11:20 PM, Tom Davis wrote: > I definitely agree that resolving the low-hanging fruit first is a good idea. > For finishing "docs branch X" to make sense, my personal belief is that X > should: > Still be relevant in terms of best practices and simply what's available > If pro

Re: [Twisted-Python] Refactoring Documentation

2011-01-21 Thread exarkun
On 03:00 am, gl...@twistedmatrix.com wrote: >>Finally, my biggest hurdle right now is not knowing how to find said >>branches. I don't see "documentation" as a category in Trac and common >>keyword searches didn't show up much for me. I'm sure this is an easy >>question to answer, though. > >