Bug#899405: tracker: Default documentation is not user-oriented
Control: tag -1 + newcomer
Control: severity -1 + important
Hello,
On Wed, 23 May 2018, Guillem Jover wrote:
> The tracker provides links to its documentation (at [T]), but that
> looks rather developer oriented. If you want to get some user
> documentation it seems that currently the main source is the
> developer-reference (!? at [D]). I think either the information in
> the second should be merged into the former, or the links changed to
> point to the latter which would be more useful than information on
> how to hack on or setup the tracker, TBH.
Definitely! This is now even more needed because we have a few interesting
team-oriented features that really need to be documented.
I would like https://qa.pages.debian.net/distro-tracker/ to provide
user-oriented documentation (as well as developer/contributor docs)
so the plan is to merge what is in the developers reference
into the distro-tracker doc, expand it, and then replace the section
in the developer's reference with a link to the distro-tracker
documentation.
I will gladly take patches or merge requests to improve the situation
of the documentation.
Cheers,
--
Raphaël Hertzog ◈ Debian Developer
Support Debian LTS: https://www.freexian.com/services/debian-lts.html
Learn to master Debian: https://debian-handbook.info/get/
Reply to: