[Qgis-developer] 3.0 Documentation and branching
yjacolin
yjacolin at free.fr
Tue Mar 7 02:40:58 PST 2017
Agreed, note that you can also use the visual changelog as reference when it already released and you are working on the documentation.
Y.
Envoyé depuis mon appareil Samsung
-------- Message d'origine --------
De : Alexandre Neto <senhor.neto at gmail.com>
Date : 07/03/2017 11:21 (GMT+01:00)
À : DelazJ <delazj at gmail.com>, Nyall Dawson <nyall.dawson at gmail.com>
Cc : qgis-developer <qgis-developer at lists.osgeo.org>
Objet : Re: [Qgis-developer] 3.0 Documentation and branching
Totally agree with Harrissou. A good description in the commit with the rigth tags should be enough.
Alex Neto
A ter, 7/03/2017, 10:06, DelazJ <delazj at gmail.com> escreveu:
Hi,
2017-03-07 5:58 GMT+01:00 Nyall Dawson <nyall.dawson at gmail.com>:
I think a better solution is to hook into the current
[FEATURE]/[NEEDS-DOCS] hooks which auto-open issues on the
documentation repo. We could *require* that all developers who push a
new feature commit have to post on the corresponding documentation
auto-opened issue with at least very rough notes about how the feature
is supposed to work. The documentation team could then polish these
up, add screenshots, etc (and merge when the timing is right for the
team). This would also keep things as easy as possible for devs so
that they (*cough*... i mean me *cough*) have no excuse not to do it!
You are right, Nyall.
However, I do not think that they later need to add information in the auto-opened issue in Doc repository. By default the generated issue is populated with all the information in the commit. So a really descriptive commit to QGIS repository with those tags should be enough. There are some very good (from a doc writer pov of course) commits where you only need to find the right place in the doc and copy paste the description with minor adjustments. Unfortunately, they are currently far from being the majority. On the other side, there still are many with simply the title (which sometimes can be helpful) or do use a dev language (too much cryptic?).
Also note that a verbose commit benefits to the Changelog team, when time comes....
Harrissou
Nyall
_______________________________________________
Qgis-developer mailing list
Qgis-developer at lists.osgeo.org
List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer--
Alexandre Neto--------------------- at AlexNetoGeohttp://sigsemgrilhetas.wordpress.comhttp://gisunchained.wordpress.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20170307/663ef9e3/attachment-0001.html>
More information about the Qgis-developer
mailing list