Re: direct link to sources from "How www.d.o is made" page
Dear Debian www maintainers,
the proposed change below is quite trivial, but I think very helpful.
Please could you review and possibly apply it?
*t
Am 05.08.2014 13:47, schrieb Tomas Pospisek:
> 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?
>
Reply to: