background on maintaining the documentation (was RE: Mailman-Developers Digest, Vol 286, Issue 9)

thanks guys - that helps me get going with things..like documentation probably should, huh? :)
the Moin system will get us away from the Atlassian licensing hassle AND would tie in great for enabling a new website for the MM3 release, - it would be cool, IMO, if we got to explore the RSS feature's ( http://moinmo.in/MoinMoinSyndication) working since we could generate recent changes outputting onto a feed, and from there, either give the RSS page some nice CSS or display the feed on the new site main-page if it was being served up separately from the moin system. I also checked using the w3c validator and moin outputs its pages in valid-xhtml mark-up so that's good for accessibility, which seems like a good goal for Mailman too, seeing as its role is a communications medium
so +++1 for the moin cms transfer (/RSS?) - I don't have much familiarity with moin blogspaces, but it'll work fine I bet
The documentation is maintained to some level in Atlassian, pythonhosted.org, and the bzr repos (, other places?) per package, so Terri explained that Atlassian is the main location for how-to's, admin guides, and GSOC stuff. Otherwise, for simplicity, the packages have docs and doctests, in the individual package themselves
on Tue, 26 Feb 2013 10:38 Terri Oda wrote:
Would the merges accepted propogate document changes to the package repos or are we referring to a merge against a documents-repo that is somewhere I don't know of. I'm still confused on where the sphinx documentation plays into it (is that maybe like building javadocs only, instead it does so for python, maybe)
r/Chris
participants (1)
-
Chris Cargile