direct link to sources from "How www.d.o is made" page
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>
Reply to: