[QGIS-Developer] Fwd: [qgis/QGIS-Enhancement-Proposals] Translation of .qgs project files (#90)

Andreas Neumann a.neumann at carto.net
Wed Jan 16 07:10:29 PST 2019


Yes - it is actually an example where the feature is already quite 
documented. Just not in the manual.

It is one of the better cases, when it comes to documentation.

Andreas

Am 16.01.19 um 16:07 schrieb Marco Bernasocchi:
>
> Well to be fair, in this (and many) other cases, the "Naughty Dev" 
> provided an amazingly well written description of the feature. That 
> can just be copy pasted to the docs.
>
> But yes, I think minimal docs, or maybe a changelog entry or a link to 
> a blogpost would be good
>
> Cheers
>
> Marco
>
>
> On 16.01.19 14:39, Alexandre Neto wrote:
>> +1
>>
>> No more "the naughty developer didn't provide a description" 
>> messages, please.
>>
>> Best regards,
>>
>> Alexandre Neto
>>
>> Paolo Cavallini <cavallini at faunalia.it 
>> <mailto:cavallini at faunalia.it>> escreveu no dia quarta, 16/01/2019 às 
>> 09:02:
>>
>>     Totally agreed:
>>     * pushing at least a minimal documentation has to be a
>>     requirement, just
>>     like unit tests
>>     * an automatic system is far preferable to a manual one.
>>     Topic added to the TODO for the HF:
>>     https://github.com/qgis/QGIS/wiki/22nd-Developer-Meeting-in-A-Coru%C3%B1a,-Spain
>>     Thanks.
>>
>>     On 16/01/19 09:14, Andreas Neumann wrote:
>>     > Hi Richard,
>>     >
>>     > It is something to consider - I agree that we have a
>>     documentation crisis.
>>     >
>>     > On the other hand - I never see any QGIS user
>>     reading/consulting that
>>     > manual we provide (because it is hard to read a manual) -
>>     that's why I
>>     > sometimes - if a question from a user about feature x is raised - I
>>     > don't answer directly but point to the chapter in the manual -
>>     just to
>>     > show users, that they should first read that manual, then
>>     Google and
>>     > consult stack exchange and then only ask if the other information
>>     > sources don't help. Or attend a course ...
>>     >
>>     > Perhaps there are also other forms to consider besides the
>>     manual to
>>     > reveal hidden features?
>>     >
>>     > The visual changelog is a good resource to find out about new
>>     and hidden
>>     > features - but even that is often only a title and no text and
>>     screenshot.
>>     >
>>     > Let's discuss it in A Coruna at the meeting. Perhaps we should
>>     try your
>>     > proposal, even if I expect some resistance from some
>>     devs/customers.
>>     >
>>     > Greetings,
>>     > Andreas
>>     >
>>     > Am 16.01.19 um 08:42 schrieb Richard Duivenvoorde:
>>     >> Hi Devs,
>>     >>
>>     >> As I see we are in a "Documentation crisis" and seeing the
>>     comment below
>>     >> in a discussion (please do not take this personal!!!):
>>     >>
>>     >> """
>>     >> No. From my side it's no documentation PR planned at the
>>     moment. Feel
>>     >> free to do something and to take the stuff from my blogpost.
>>     >> """
>>     >>
>>     >> I think our project has to do something. Even throwing money
>>     at people
>>     >> (we did as PSC!) does not help...
>>     >>
>>     >> I'm really afraid QGIS will end up with a lot of HIDDEN
>>     features and
>>     >> possibilities. A lot of it's functionality is hiding because
>>     it isn't
>>     >> mentioned in the QGIS docs or blogs (maybe in other (company)
>>     blogs),
>>     >> but only in the code ...
>>     >>
>>     >> I do not want to be a PITA, but can we maybe add a mandatory
>>     requirement
>>     >> for a pull request that in case of a new feature the dev adds some
>>     >> mandatory Text and Images about the feature IN the PR?
>>     >>
>>     >> He/she can also ask a community member to do that by giving some
>>     >> interview.
>>     >>
>>     >> It is really NO fun for doc writers to find a [FEATURE] issue
>>     in the doc
>>     >> writing issues list. He/she has to start guessing how it was
>>     >> implemented, try it out, or google for some blogpost or start
>>     talking to
>>     >> the dev etcetc. Really NO fun if you want to work on the
>>     documenation
>>     >> because it takes so much time!
>>     >>
>>     >> I think implementing developer is just the best person to
>>     write one or
>>     >> two paragraphs (and add some images, hey he has also tested during
>>     >> coding isn't it?).
>>     >> In this way doc writing could then be just 'copy and paste'
>>     the text, do
>>     >> some grammar fixes and add images from the PR of the dev in
>>     the docs.
>>     >>
>>     >> I know a project like MapProxy handles it's PR's even more
>>     rigid: if
>>     >> Documentation is not part of the code PR, it is just nog
>>     pulled. It is
>>     >> easier there because they have text only docs IN the src tree;
>>     that is
>>     >> why I propose to do only text + images.
>>     >>
>>     >> I know this is an old idea, but seeing one dev asking about
>>     already
>>     >> implemented features to another dev was the drop...
>>     >> And I'm aware that you cannot prevent this anyway.... as
>>     nobody likes to
>>     >> RTFM :-)
>>     >>
>>     >> Regards,
>>     >>
>>     >> Richard Duivenvoorde
>>     >>
>>     >>
>>     >> -------- Forwarded Message --------
>>     >> Subject:     Re: [qgis/QGIS-Enhancement-Proposals] Translation
>>     of .qgs
>>     >> project files (#90)
>>     >> Date:     Tue, 15 Jan 2019 12:28:40 -0800
>>     >>
>>     >> ...
>>     >>
>>     >> No. From my side it's no documentation PR planned at the
>>     moment. Feel
>>     >> free to do something and to take the stuff from my blogpost.
>>     >>
>>     >> —
>>     >> You are receiving this because you are subscribed to this thread.
>>     >> Reply to this email directly, view it on GitHub
>>     >>
>>     <https://github.com/qgis/QGIS-Enhancement-Proposals/issues/90#issuecomment-454539249>
>>     >>
>>     >>
>>     >>
>>     >> _______________________________________________
>>     >> QGIS-Developer mailing list
>>     >> QGIS-Developer at lists.osgeo.org
>>     <mailto: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
>>     > _______________________________________________
>>     > QGIS-Developer mailing list
>>     > QGIS-Developer at lists.osgeo.org
>>     <mailto: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
>>
>>     -- 
>>     Paolo Cavallini - www.faunalia.eu <http://www.faunalia.eu>
>>     QGIS.ORG <http://QGIS.ORG> Chair:
>>     http://planet.qgis.org/planet/user/28/tag/qgis%20board/
>>     _______________________________________________
>>     QGIS-Developer mailing list
>>     QGIS-Developer at lists.osgeo.org
>>     <mailto: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
>> ---------------------
>> @AlexNetoGeo
>> http://sigsemgrilhetas.wordpress.com
>> http://gisunchained.wordpress.com
>>
>> _______________________________________________
>> 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
> -- 
> Marco Bernasocchi
> QGIS.org Co-chair
> marco at opengis.ch <mailto:marco at opengis.ch>
> +41 (0)79 467 24 70 <tel:+41794672470>
>
> OPENGIS.ch Logo <https://www.opengis.ch>
>
> _______________________________________________
> 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20190116/df90ae11/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 6671 bytes
Desc: not available
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20190116/df90ae11/attachment-0001.png>


More information about the QGIS-Developer mailing list