Re: [Qgis-developer] New QGIS Generic Help

2017-01-15 Thread Paolo Cavallini
Il 13/01/2017 12:03, Matthias Kuhn ha scritto:
> On 01/13/2017 11:54 AM, Paolo Cavallini wrote:
>> Il 13/01/2017 11:52, Matthias Kuhn ha scritto:
>>
>>> Agreed, do you know someone with experience and connections who could
>>> check with them how collaboration could work, especially
>>> also w.r.t. to translation of algorithm documentation?
>>
>> doing it right now
>> thanks
>>
> 
> thanks a lot!

OK, so it turned out this is a long standing issue:
https://trac.osgeo.org/grass/ticket/846
I suggested to move the translation files to Transifex, so we could
motivate more people to contribute:
https://trac.osgeo.org/grass/ticket/846#no4
Let's see how it goes.
For now, I think having the EN GRASS help everywhere is good enough for
our users.
All the best.
-- 
Paolo Cavallini - www.faunalia.eu
QGIS & PostGIS courses: http://www.faunalia.eu/training.html
https://www.google.com/trends/explore?date=all=IT=qgis,arcgis
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

Re: [Qgis-developer] New QGIS Generic Help

2017-01-13 Thread Matthias Kuhn
On 01/13/2017 11:54 AM, Paolo Cavallini wrote:
> Il 13/01/2017 11:52, Matthias Kuhn ha scritto:
> 
>> Agreed, do you know someone with experience and connections who could
>> check with them how collaboration could work, especially
>> also w.r.t. to translation of algorithm documentation?
> 
> doing it right now
> thanks
> 

thanks a lot!
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

Re: [Qgis-developer] New QGIS Generic Help

2017-01-13 Thread Paolo Cavallini
Il 13/01/2017 11:52, Matthias Kuhn ha scritto:

> Agreed, do you know someone with experience and connections who could
> check with them how collaboration could work, especially
> also w.r.t. to translation of algorithm documentation?

doing it right now
thanks

-- 
Paolo Cavallini - www.faunalia.eu
QGIS & PostGIS courses: http://www.faunalia.eu/training.html
https://www.google.com/trends/explore?date=all=IT=qgis,arcgis
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

Re: [Qgis-developer] New QGIS Generic Help

2017-01-13 Thread Matthias Kuhn
Hi Paolo

On 01/13/2017 11:43 AM, Paolo Cavallini wrote:

>> What about translation?
> 
> I'm not sure it is translated upstream - if not, however, it shuld be
> done at that level, it makes no sense to do it downstream.

Agreed, do you know someone with experience and connections who could
check with them how collaboration could work, especially
also w.r.t. to translation of algorithm documentation?

All the best
Matthias
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

Re: [Qgis-developer] New QGIS Generic Help

2017-01-13 Thread Paolo Cavallini
Hi Matthias,

Il 13/01/2017 11:38, Matthias Kuhn ha scritto:

> Are you referring to the quality of the upstream help?

yes

> My proposal offers to do both:
> 
>  * By default use the upstream help if quality is good enough
>  * Override *where necessary*

agreed

> What about translation?

I'm not sure it is translated upstream - if not, however, it shuld be
done at that level, it makes no sense to do it downstream.

All the best.
-- 
Paolo Cavallini - www.faunalia.eu
QGIS & PostGIS courses: http://www.faunalia.eu/training.html
https://www.google.com/trends/explore?date=all=IT=qgis,arcgis
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

Re: [Qgis-developer] New QGIS Generic Help

2017-01-13 Thread Matthias Kuhn
Hi Paolo,

Are you referring to the quality of the upstream help?

My proposal offers to do both:

 * By default use the upstream help if quality is good enough
 * Override *where necessary*

What about translation?

Matthias

On 01/13/2017 11:26 AM, Paolo Cavallini wrote:
> Il 13/01/2017 11:11, Matthias Kuhn ha scritto:
> 
>> What would also be nice if someone with experience and connections could
>> check with saga, grass, etc. how collaboration could work, especially
>> also w.r.t. to translation of algorithm documentation.
> 
> IMHO the GRASS help is fine as it is, and should not be rewritten, just
> made it available to the user. The current situation is fine, I think.
> Main problems are with SAGA and our own algs.
> All the best.
> 
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

Re: [Qgis-developer] New QGIS Generic Help

2017-01-13 Thread Paolo Cavallini
Il 13/01/2017 11:11, Matthias Kuhn ha scritto:

> What would also be nice if someone with experience and connections could
> check with saga, grass, etc. how collaboration could work, especially
> also w.r.t. to translation of algorithm documentation.

IMHO the GRASS help is fine as it is, and should not be rewritten, just
made it available to the user. The current situation is fine, I think.
Main problems are with SAGA and our own algs.
All the best.

-- 
Paolo Cavallini - www.faunalia.eu
QGIS & PostGIS courses: http://www.faunalia.eu/training.html
https://www.google.com/trends/explore?date=all=IT=qgis,arcgis
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

Re: [Qgis-developer] New QGIS Generic Help

2017-01-13 Thread Matthias Kuhn
Hi Matteo,

Yes, this is the idea as far as I understand.
What's missing is the concept.

Here a proposal:

 * Add a new helpTag property to the processing GeoAlgorithm class

 * Set the help tag to something like
processing_algs/saga/grid_analysis/aggregation-index

 * Within our documentation server
   * Create pages where we have extra docs for algorithms
   * Add a rewrite rule (or some other script logic) to forward the
 browser to the upstream documentation, where no override exists.

What would also be nice if someone with experience and connections could
check with saga, grass, etc. how collaboration could work, especially
also w.r.t. to translation of algorithm documentation.

Matthias

On 01/13/2017 10:40 AM, matteo wrote:
> Hi devs,
> 
> I saw the PR to improve/start the QGIS Generic Help system [0], thanks Alex!
> 
> I was just thinking a way to take advantages of this new method for
> improving the help files of Processing, especially for SAGA.
> 
> I know I'm boring, but IMHO having super algorithm without any guide on
> the input, output and parameter is barely useless (except if the user
> knows already the algorithm).
> 
> In December I pointed out a similar question [1], could we make some
> default link to the SAGA url(s) and algorithms?
> 
> Just my 2 cent
> 
> Cheers
> 
> Matteo
> 
> 
> [0] https://github.com/qgis/QGIS/pull/3911
> [1]
> https://lists.osgeo.org/pipermail/qgis-developer/2016-December/046290.html
> ___
> Qgis-developer mailing list
> Qgis-developer@lists.osgeo.org
> List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
> Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer
> 
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer

[Qgis-developer] New QGIS Generic Help

2017-01-13 Thread matteo
Hi devs,

I saw the PR to improve/start the QGIS Generic Help system [0], thanks Alex!

I was just thinking a way to take advantages of this new method for
improving the help files of Processing, especially for SAGA.

I know I'm boring, but IMHO having super algorithm without any guide on
the input, output and parameter is barely useless (except if the user
knows already the algorithm).

In December I pointed out a similar question [1], could we make some
default link to the SAGA url(s) and algorithms?

Just my 2 cent

Cheers

Matteo


[0] https://github.com/qgis/QGIS/pull/3911
[1]
https://lists.osgeo.org/pipermail/qgis-developer/2016-December/046290.html
___
Qgis-developer mailing list
Qgis-developer@lists.osgeo.org
List info: http://lists.osgeo.org/mailman/listinfo/qgis-developer
Unsubscribe: http://lists.osgeo.org/mailman/listinfo/qgis-developer