On 02:35 pm, [email protected] wrote:
Hi,
I would like to talk about moving Twisted development documentation out
of
official Twisted doc.
They can be moved either into the Trac wiki or a separate project ...
maybe twisted-dev-tools
The problem with Twisted main repo is that (AFAIK) updates are done
only after a release... so I change might be delay quite a lot (6
months)
The coding standard really shouldn't be changing so frequently that this
is a major concern. Additionally, everyone who is developing Twisted
has a Twisted checkout with the most recent version of the information
anyway.
Also, releases *should* be happening more frequently than every six
months.
This doesn't seem like a very compelling reason to make this change.
Jean-Paul
We already have a lot of info inside the Trac wiki..
My plan it to move the following docs into Trac and organize existing
specification and development wiki pages:
http://twistedmatrix.com/documents/current/core/specifications/index.html
http://twistedmatrix.com/documents/current/core/specifications/banana.html
http://twistedmatrix.com/documents/current/core/development/index.html
http://twistedmatrix.com/documents/current/core/development/naming.html
http://twistedmatrix.com/documents/current/core/development/philosophy.html
http://twistedmatrix.com/documents/current/core/development/security.html
I would also move the following docs to Trac so that they can be
updated much faster.
http://twistedmatrix.com/documents/current/core/development/policy/svn-
dev.html
http://twistedmatrix.com/documents/current/core/development/policy/index.html
http://twistedmatrix.com/documents/current/core/development/policy
/coding-standard.html
http://twistedmatrix.com/documents/current/core/development/policy
/writing-standard.html
http://twistedmatrix.com/documents/current/core/development/policy
/test-standard.html
http://twistedmatrix.com/documents/current/core/development/policy/doc-
standard.html
Do we still use XHTML ?
Trac support RST format, so we can maintain those pages in RST... and
trac wiki allow to view changes as diffs.
Having docs in repo is nice as you can send them for review, but i
feel that this is counter-productive for the current case.
What do you think?
Thanks!
--
Adi Roiban
_______________________________________________
Twisted-Python mailing list
[email protected]
http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
_______________________________________________
Twisted-Python mailing list
[email protected]
http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
