← Back to team overview

kicad-developers team mailing list archive

Re: New feature notifications

 

On 11/22/2017 08:55 AM, Maciej Sumiński wrote:
> On 11/22/2017 02:48 PM, Marco Ciampa wrote:
> [snip]
>> Please please please,
>>
>> when some new feature is accepted (code merged in master branch), either
>> write it in the dev (master) branch of the documentation or somewhere to
>> enable doc writers to describe the new feature... (wiki? txt in the
>> source code? Bug Report?)
>>
>> I think that a simple description in a bug report is the easiest way to
>> assure that new features get correctly described in the docs.
>> Parsing dev ml messages for these "hints" is IMHO unmanageable...
>>
>> TIA
>>
> 
> Hi Marco,
> 
> I thought we are supposed to use tags in commit messages (NEW, CHANGE)
> [1]. I can create a bug report in the documentation repository, if this
> is the preferred way. If so, then I suppose it should be made a policy.

You are and you did.  Nice job!  The real question is how does this
information make it from the source repo commit messages to doc devs so
the docs can be updated accordingly?

> 
> I am afraid it might be hard to follow for occasional patch submitters,
> should it be the committer responsible for creating a bug report?
> 
> Regards,
> Orson
> 
> 1. https://git.launchpad.net/kicad/commit/?id=527c6f0014b03
> 
> 
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~kicad-developers
> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-developers
> More help   : https://help.launchpad.net/ListHelp
> 


Follow ups

References