Hello www maintainers! here's a proposed patch to the "How is www.d.o made" page [1] (it's also attached to this email):
.../debian-www/webwml/english/devel/website$ cvs diff -u desc.wml Index: desc.wml =================================================================== RCS file: /cvs/webwml/webwml/english/devel/website/desc.wml,v retrieving revision 1.33 diff -u -r1.33 desc.wml --- desc.wml 30 Apr 2014 06:33:12 -0000 1.33 +++ desc.wml 5 Aug 2014 11:38:33 -0000 @@ -9,10 +9,11 @@ <p>The site is generated in one of three ways: <ul> - <li>the bulk of it is generated using WML, from the 'webwml' CVS tree + <li>the bulk of it is generated using WML, from the + <a href="https://alioth.debian.org/projects/webwml/";>'webwml' CVS tree</a> <li>the documentation is generated using DocBook XML (use of DebianDoc - SGML is being phased out), from the 'ddp' - Subversion repository + SGML is being phased out), from the + <a href="https://alioth.debian.org/projects/ddp/";>'ddp' Subversion repository</a> <li>parts of the site are generated using scripts using other sources, e.g. the mailing list (un)subscription pages </ul> Rationale: * make it as easy as possible for others to contribute to Debian's web pages. * make inclusion of contributions as easy as possible to apply for the www-team Means: * make it as easy as possible for potential contributors to find the source code of the web pages * nudge the contributor to provide cleanly applying patches to the source code If you will apply this patch, then I'll try to port it to all the other translations. A further improvement to the work flow would IMO be to migrate from CVS to git, then all the comfort features of git could be used such as easy forking and merging of the docu. But that's out of scope of this patch. Comments? Thanks, *t [1] https://www.debian.org/devel/website/desc PS: does the web maintainers prefer to have bugs filled against debian-www or to have proposed changes posted here on the ML?
Index: desc.wml =================================================================== RCS file: /cvs/webwml/webwml/english/devel/website/desc.wml,v retrieving revision 1.33 diff -u -r1.33 desc.wml --- desc.wml 30 Apr 2014 06:33:12 -0000 1.33 +++ desc.wml 5 Aug 2014 11:41:53 -0000 @@ -9,10 +9,11 @@ <p>The site is generated in one of three ways: <ul> - <li>the bulk of it is generated using WML, from the 'webwml' CVS tree + <li>the bulk of it is generated using WML, from the + <a href="https://alioth.debian.org/projects/webwml/";>'webwml' CVS tree</a> <li>the documentation is generated using DocBook XML (use of DebianDoc - SGML is being phased out), from the 'ddp' - Subversion repository + SGML is being phased out), from the + <a href="https://alioth.debian.org/projects/ddp/";>'ddp' Subversion repository</a> <li>parts of the site are generated using scripts using other sources, e.g. the mailing list (un)subscription pages </ul>
