[kde-community] Re: Applications Lifecycle Policy

[Luigi Toscano]

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