Jonathan Riddell ha scritto: > On Wed, Jul 05, 2017 at 01:45:14PM +0200, Luigi Toscano wrote: >> Jonathan Riddell ha scritto: >> >>> I used the Sanity Checklist I made for the releasing extragear page as >>> the list of some stuff people will look at in kdereview >>> https://techbase.kde.org/ReleasingExtragearSoftware#Sanity_Checklist >>> what else should go in here? It doesn't require docbook docs, they >>> seem to be out of fashion. >> >> Can we make this point still valid? If you don't like docbook, fine, but docs >> should be still a requirement (maybe not for KIOs, but apps should have >> docs). > > How's this line I added to sanity checklist? > > "Documentation appropriate to the project. This could be docbook in the Git > repo, a userbase page or API documentation." > > https://techbase.kde.org/ReleasingExtragearSoftware#Sanity_Checklist
The user documentation and the API documentation are not or... or.... Maybe something like: "Documentation appropriate to the project: API documentation, user documentation (including docbook or other format documented by the Documentation team)" which leaves the door open to future changes. Ciao -- Luigi