[Packaging-handbook-project] Cooperation between Miriam's course on Debian packages and the Debian Packaging Handbook project

[Luca Brivio]

Hi François,

mer 29 agosto 2007, François Févotte ha scritto:

> However, I am not much in favor of having two different versions of
> text: it could take a very long time to spot the differences, merge
> the different parts and adapt them to each project's goals. Although I
> do not have yet any idea how this could be done, I think it would be
> better to have a common base for both documents, and to consider each
> document as a branch derived from it (much as a VCS would do). Then
> there could be easy ways to propagate changes from one branch to the
> other.

Please note that our texts will likely be very different. Anyway I think that 
to have both a good RCS and a wiki would be helpful.

> The first solution I can think of to do this would be to use a
> text-based format for the documents and a VCS to manage the two
> branches (svn, svk, bzr, ...?) but this also entails some drawbacks
> (e.g. it's not compatible with the wiki that has been used for the
> Debian handbook packaging project).

Maybe a distributed RCS is what would best fit to our needs. We may use our 
own wiki instead of wiki.debian.org. I might set up Ikiwiki[1] on Alioth 
(http://packaging-handbook.alioth.debian.org), it supports at least SVN and 
git, IIRC. We may also port the Docbook XML export from MoinMoin to Ikiwiki 
as a plugin (both are written in Python), maybe Joey may be helpful. It was a 
move that I planned for the long term, but if it can be useful, IMHO we can 
do this just now. 

[1] http://ikiwiki.info/

--
Luca Brivio