--- Begin Message ---
Package: www.debian.org
Severity: wishlist
Tags: patch
Hello debian-www team,
as reported and discussed here [1]:
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.
Thanks,
*t
[1] https://www.debian.org/devel/website/desc
[1] https://lists.debian.org/debian-www/2014/08/msg00010.html
-- System Information:
Debian Release: 7.6
APT prefers stable
APT policy: (500, 'stable'), (500, 'oldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386
Kernel: Linux 3.14-0.bpo.2-amd64 (SMP w/8 CPU cores)
Locale: LANG=de_CH.UTF-8, LC_CTYPE=de_CH.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
--- 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>
--- 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>
--- End Message ---