Removing the contributor documentation from the default build targets

David Pires slickymaster at
Mon Mar 21 12:49:31 UTC 2016

Since just the user-docs are release-specific, not the contributor-docs, I
don't see no reason to go ahead and implement it.


On 18 March 2016 at 23:24, Pasi Lallinaho <pasi at> wrote:

> Hello documentation zealots,
> here's a brief summary of a discussion [1] on the IRC channel today:
> - The user and contributor documentation are tracked on the same branch
> because they have many common assets
> - The user and contributor documentation are however very different in
> nature; the former is and needs to be release-specific and the latter is
> never release-specific
> That said, I would like to propose the following:
> - While keeping both documentation sources in the same branch, drop
> contributor documentation from the default build target, thus, not shipping
> it with the built documentation on the ISO
> - As a consequence of the above, a slight content change needs to be done
> for the start page to point to the online documentation (I can take this
> item)
> - The contributor documentation can then be changed when needed and
> updated with it, without explicitly requiring an upload
> for the package.
> - Since the contributor documentation would still be available in the
> source package, make sure the source has a note pointing to the newest
> branch in case somebody wants to build the contributor documentation (I can
> take this item too)
> Technically, this is only a slight change and we can fortunately keep on
> using the current Makefiles and build scripts.
> Any comments? Agree or disagree?
> Cheers,
> Pasi
> [1] Starting from
> --
> Pasi Lallinaho (knome)                »
> Leader of Shimmer Project             »
> Ubuntu member, Xubuntu Website Lead   »
> --
> xubuntu-devel mailing list
> xubuntu-devel at
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <>

More information about the xubuntu-devel mailing list