[GeoNetwork-devel] CFV / Documentation for GeoNetwork 3+

GeoNetwork GeoNetwork Developer
1

Dear PSC,

Here is a proposal for starting a new documentation for GeoNetwork 3: https://github.com/geonetwork/core-geonetwork/wiki/Documentation-Improvement . The proposal describes the table of content and how the documentation will be maintained and embedded into the application.

Looking forward to your votes.

Thanks.

Francois

2

Hi Francois

+1 for me.

Related to the submodule, don’t like them too much, but I guess to have committers only for documentation is the only way.

Regards,
Jose García

···

On Mon, May 4, 2015 at 3:36 PM, Francois Prunayre <fx.prunayre@anonymised.com> wrote:

Dear PSC,

Here is a proposal for starting a new documentation for GeoNetwork 3: https://github.com/geonetwork/core-geonetwork/wiki/Documentation-Improvement . The proposal describes the table of content and how the documentation will be maintained and embedded into the application.

Looking forward to your votes.

Thanks.

Francois

One dashboard for servers and applications across Physical-Virtual-Cloud
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y

GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

–

GeoCat Bridge for ArcGIS allows instant publishing of data and metadata on GeoServer and GeoNetwork. Visit http://geocat.net for details.

Jose García
GeoCat bv
Veenderweg 13
6721 WD Bennekom
The Netherlands
http://GeoCat.net

3

2015-05-04 15:48 GMT+02:00 Jose Garcia <jose.garcia@anonymised.com>:

Hi Francois

+1 for me.

Related to the submodule, don't like them too much, but I guess to have
committers only for documentation is the only way.

Yes I agree, but we get use to them at some point !

Francois

Regards,
Jose García

On Mon, May 4, 2015 at 3:36 PM, Francois Prunayre <fx.prunayre@anonymised.com>
wrote:

Dear PSC,

Here is a proposal for starting a new documentation for GeoNetwork 3:
https://github.com/geonetwork/core-geonetwork/wiki/Documentation-Improvement
. The proposal describes the table of content and how the documentation
will be maintained and embedded into the application.

Looking forward to your votes.

Thanks.

Francois

------------------------------------------------------------------------------
One dashboard for servers and applications across Physical-Virtual-Cloud
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at
http://sourceforge.net/projects/geonetwork

--

*GeoCat Bridge for ArcGIS allows instant publishing of data and metadata
on GeoServer and GeoNetwork. Visit http://geocat.net
<http://geocat.net/&gt; for details. _________________________Jose
GarcíaGeoCat bvVeenderweg 136721 WD BennekomThe
Netherlandshttp://GeoCat.net/>*

4

On Mon, May 4, 2015 at 3:50 PM, Francois Prunayre <fx.prunayre@anonymised.com>
wrote:

2015-05-04 15:48 GMT+02:00 Jose Garcia <jose.garcia@anonymised.com>:

Hi Francois

+1 for me.

Related to the submodule, don't like them too much, but I guess to have
committers only for documentation is the only way.

Yes I agree, but we get use to them at some point !

Francois

Having a submodule is better, because that means that we can download and
build GeoNetwork without having to download also the docs :slight_smile:

+1 for the proposal (although I don't vote)

Regards,
Jose García

On Mon, May 4, 2015 at 3:36 PM, Francois Prunayre <fx.prunayre@anonymised.com>
wrote:

Dear PSC,

Here is a proposal for starting a new documentation for GeoNetwork 3:
https://github.com/geonetwork/core-geonetwork/wiki/Documentation-Improvement
. The proposal describes the table of content and how the documentation
will be maintained and embedded into the application.

Looking forward to your votes.

Thanks.

Francois

------------------------------------------------------------------------------
One dashboard for servers and applications across Physical-Virtual-Cloud
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at
http://sourceforge.net/projects/geonetwork

--

*GeoCat Bridge for ArcGIS allows instant publishing of data and metadata
on GeoServer and GeoNetwork. Visit http://geocat.net
<http://geocat.net/&gt; for details. _________________________Jose
GarcíaGeoCat bvVeenderweg 136721 WD BennekomThe
Netherlandshttp://GeoCat.net/>*

------------------------------------------------------------------------------
One dashboard for servers and applications across Physical-Virtual-Cloud
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at
http://sourceforge.net/projects/geonetwork

5

Hi Francois,

er.. why do we need to add the doc as a submodule?
Can't it be an independent github repo that can be cloned and built on its own
only when needed?

   Cheers,
   Emanuele

Alle 16:28:55 di Monday 4 May 2015, María Arias de Reyna ha scritto:

On Mon, May 4, 2015 at 3:50 PM, Francois Prunayre <fx.prunayre@anonymised.com>

wrote:
> 2015-05-04 15:48 GMT+02:00 Jose Garcia <jose.garcia@anonymised.com>:
>> Hi Francois
>>
>> +1 for me.
>>
>> Related to the submodule, don't like them too much, but I guess to have
>> committers only for documentation is the only way.
>
> Yes I agree, but we get use to them at some point !
>
> Francois

Having a submodule is better, because that means that we can download and
build GeoNetwork without having to download also the docs :slight_smile:

+1 for the proposal (although I don't vote)

>> Regards,
>> Jose García
>>
>> On Mon, May 4, 2015 at 3:36 PM, Francois Prunayre
>> <fx.prunayre@anonymised.com>
>>
>> wrote:
>>> Dear PSC,
>>>
>>> Here is a proposal for starting a new documentation for GeoNetwork 3:
>>> https://github.com/geonetwork/core-geonetwork/wiki/Documentation-Improv
>>> ement . The proposal describes the table of content and how the
>>> documentation will be maintained and embedded into the application.
>>>
>>> Looking forward to your votes.
>>>
>>> Thanks.
>>>
>>> Francois
>>>
>>>
>>> -----------------------------------------------------------------------
>>> ------- One dashboard for servers and applications across
>>> Physical-Virtual-Cloud Widest out-of-the-box monitoring support with
>>> 50+ applications Performance metrics, stats and reports that give you
>>> Actionable Insights Deep dive visibility with transaction tracing
>>> using APM Insight.
>>> http://ad.doubleclick.net/ddm/clk/290420510;117567292;y

--

GeoServer Professional Services from the experts! Visit
http://goo.gl/NWWaa2 for more information.

Ing. Emanuele Tajariol
Technical Lead

GeoSolutions S.A.S.
Via Poggio alle Viti 1187
55054 Massarosa (LU)
Italy
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 380 2116282

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

-------------------------------------------------------

6

Hi Emanuele,

···

2015-05-04 19:50 GMT+02:00 Emanuele Tajariol <etj@anonymised.com>:

Hi Francois,

er… why do we need to add the doc as a submodule?
Can’t it be an independent github repo that can be cloned and built on its own
only when needed?

An idea of this proposal is also to more closely link the documentation to the application so when you have a feature that sounds interesting in the app, provide a link to the user to the documentation for that feature. That will also probably “force” us to make more docs on each features I think (eg. from the admin panel, virtual CSW configuration, link to a section “Configuring virtual CSW” where the user can understand What’s a virtual CSW ? How to configure it ?..). For this, the doc module needs to be embedded into the app and maintaining a submodule is not that difficult.

Cheers.

Francois

Cheers,
Emanuele

Alle 16:28:55 di Monday 4 May 2015, María Arias de Reyna ha scritto:

On Mon, May 4, 2015 at 3:50 PM, Francois Prunayre <fx.prunayre@anonymised.com>

wrote:

2015-05-04 15:48 GMT+02:00 Jose Garcia <jose.garcia@anonymised.com>:

Hi Francois

+1 for me.

Related to the submodule, don’t like them too much, but I guess to have
committers only for documentation is the only way.

Yes I agree, but we get use to them at some point !

Francois

Having a submodule is better, because that means that we can download and
build GeoNetwork without having to download also the docs :slight_smile:

+1 for the proposal (although I don’t vote)

Regards,
Jose García

On Mon, May 4, 2015 at 3:36 PM, Francois Prunayre
<fx.prunayre@anonymised.com…>

wrote:

Dear PSC,

Here is a proposal for starting a new documentation for GeoNetwork 3:
https://github.com/geonetwork/core-geonetwork/wiki/Documentation-Improv
ement . The proposal describes the table of content and how the
documentation will be maintained and embedded into the application.

Looking forward to your votes.

Thanks.

Francois

------- One dashboard for servers and applications across
Physical-Virtual-Cloud Widest out-of-the-box monitoring support with
50+ applications Performance metrics, stats and reports that give you
Actionable Insights Deep dive visibility with transaction tracing
using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y

–

GeoServer Professional Services from the experts! Visit
http://goo.gl/NWWaa2 for more information.

Ing. Emanuele Tajariol
Technical Lead

GeoSolutions S.A.S.
Via Poggio alle Viti 1187
55054 Massarosa (LU)
Italy
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 380 2116282

http://www.geo-solutions.it
http://twitter.com/geosolutions_it

7

Hi, so if there is no more comment, I’ll start by moving the repository from geosource organisation (https://github.com/geosource-catalogue/doc) to geonetwork and next week in Bolsena we could add the submodule and start working on it.

Cheers.

Francois

···

2015-05-04 20:00 GMT+02:00 Francois Prunayre <fx.prunayre@anonymised.com.31…>:

Hi Emanuele,

2015-05-04 19:50 GMT+02:00 Emanuele Tajariol <etj@anonymised.com>:

Hi Francois,

er… why do we need to add the doc as a submodule?
Can’t it be an independent github repo that can be cloned and built on its own
only when needed?

An idea of this proposal is also to more closely link the documentation to the application so when you have a feature that sounds interesting in the app, provide a link to the user to the documentation for that feature. That will also probably “force” us to make more docs on each features I think (eg. from the admin panel, virtual CSW configuration, link to a section “Configuring virtual CSW” where the user can understand What’s a virtual CSW ? How to configure it ?..). For this, the doc module needs to be embedded into the app and maintaining a submodule is not that difficult.

Cheers.

Francois

Cheers,
Emanuele

Alle 16:28:55 di Monday 4 May 2015, María Arias de Reyna ha scritto:

On Mon, May 4, 2015 at 3:50 PM, Francois Prunayre <fx.prunayre@anonymised.com>

wrote:

2015-05-04 15:48 GMT+02:00 Jose Garcia <jose.garcia@anonymised.com>:

Hi Francois

+1 for me.

Related to the submodule, don’t like them too much, but I guess to have
committers only for documentation is the only way.

Yes I agree, but we get use to them at some point !

Francois

Having a submodule is better, because that means that we can download and
build GeoNetwork without having to download also the docs :slight_smile:

+1 for the proposal (although I don’t vote)

Regards,
Jose García

On Mon, May 4, 2015 at 3:36 PM, Francois Prunayre
<fx.prunayre@anonymised.com>

wrote:

Dear PSC,

Here is a proposal for starting a new documentation for GeoNetwork 3:
https://github.com/geonetwork/core-geonetwork/wiki/Documentation-Improv
ement . The proposal describes the table of content and how the
documentation will be maintained and embedded into the application.

Looking forward to your votes.

Thanks.

Francois

------- One dashboard for servers and applications across
Physical-Virtual-Cloud Widest out-of-the-box monitoring support with
50+ applications Performance metrics, stats and reports that give you
Actionable Insights Deep dive visibility with transaction tracing
using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y

–

GeoServer Professional Services from the experts! Visit
http://goo.gl/NWWaa2 for more information.

Ing. Emanuele Tajariol
Technical Lead

GeoSolutions S.A.S.
Via Poggio alle Viti 1187
55054 Massarosa (LU)
Italy
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 380 2116282

http://www.geo-solutions.it
http://twitter.com/geosolutions_it