OSGeo - User contributions [en]

Glossary-Project

2021-03-23T15:55:30Z

Wiki-Ankitatripathi:

The OSGeo glossary project is building processes and tools for setting up cross-domain, inter-operable glossaries. The focus is initially on OSGeo and spatial projects, but the patterns will be equally applicable and usable within other domains as well.

== Goals ==
Glossaries are easy to set up for simple examples but extremely hard to scale - especially when trying to inherit terms from other organizations. The collaborative overhead becomes overwhelming. Communities struggle to agree upon:
* Term definitions,
* Field and sentence structure,
* Tooling,
* Governance, and more.

== Challenges ==
Here we cover some of the key challenges we’ve been working through.
=== Sharing Terms ===
We’ve been working on how to share terms between glossaries.
[[File:Sharing terms.png|thumb]]
=== Information Schemas ===
We’ve been establishing standardized information structures.
[[File:Information schema.png|thumb]]
=== Governance ===
We’ve been working on governance models that projects can adopt.
[[File:Governance real.png|thumb]]
=== Open-source software tooling ===
For building better cross-organizational glossaries, we are using [https://www.glossarist.org/ Glossarist]: an open-source tool to create, maintain, and update glossaries hassle-free. Glossarist is already in use by the ISO/TC 211 spatial standards body.
=== OSGeo Terminology ===
We’ve established an initial [https://osgeodev.geolexica.org/ GeoLexica glossary] covering English terminology used within OSGeo.

== Next Steps ==
In 2021 and onwards, we aim to achieve the following:
* Create best practices in cross-domain glossary management, for adoption by the open-source and technical writing communities.
* Build a community that defines and manages geospatial terms across multiple geospatial projects and communities.
* Set up processes collated in explanations and how-tos which are easy-to-follow by everyday people wanting to stand up an interoperable glossary.

== More Info ==
To know more about the project, refer to our [https://docs.google.com/document/d/1Fjrl34ErnYammel9WmvXJ3rMWFANjoSiiGyyNSYOXUg/edit# project manifesto] or read about our [https://docs.google.com/presentation/d/1WZw1_iAC8uWTqFo335i5h_q8IbEYLqzNRYYWBRNtkd0/edit#slide=id.g98573dba11_0_10 pilot project].

== Point of Contact ==
We communicate on the [https://lists.osgeo.org/mailman/listinfo/lexicon OSGeo Lexicon email list]. (Note: After subscribing, check your email spam for your subscription confirmation email. It is sent straight after subscribing. Or ask cameron . shorter AT gmail .com for help.)
== Want to be a part of our community? ==
If you wish to be a part of this challenging glossary management project, then please reach out to us through our mailing list or our slack channel:
* Try setting up your own glossary using the tools and processes we are establishing. Help us improve in the process.
* Help research and then document best practices in glossary management.
* Help with whatever dirty work is required to keep the project moving forward.

Glossary-Project

2021-03-23T15:55:14Z

Wiki-Ankitatripathi: Created page with "OSGeo Glossary Project The OSGeo glossary project is building processes and tools for setting up cross-domain, inter-operable glossaries. The focus is initially on OSGeo and..."

OSGeo Glossary Project

The OSGeo glossary project is building processes and tools for setting up cross-domain, inter-operable glossaries. The focus is initially on OSGeo and spatial projects, but the patterns will be equally applicable and usable within other domains as well.

== Goals ==
Glossaries are easy to set up for simple examples but extremely hard to scale - especially when trying to inherit terms from other organizations. The collaborative overhead becomes overwhelming. Communities struggle to agree upon:
* Term definitions,
* Field and sentence structure,
* Tooling,
* Governance, and more.

== Challenges ==
Here we cover some of the key challenges we’ve been working through.
=== Sharing Terms ===
We’ve been working on how to share terms between glossaries.
[[File:Sharing terms.png|thumb]]
=== Information Schemas ===
We’ve been establishing standardized information structures.
[[File:Information schema.png|thumb]]
=== Governance ===
We’ve been working on governance models that projects can adopt.
[[File:Governance real.png|thumb]]
=== Open-source software tooling ===
For building better cross-organizational glossaries, we are using [https://www.glossarist.org/ Glossarist]: an open-source tool to create, maintain, and update glossaries hassle-free. Glossarist is already in use by the ISO/TC 211 spatial standards body.
=== OSGeo Terminology ===
We’ve established an initial [https://osgeodev.geolexica.org/ GeoLexica glossary] covering English terminology used within OSGeo.

== Next Steps ==
In 2021 and onwards, we aim to achieve the following:
* Create best practices in cross-domain glossary management, for adoption by the open-source and technical writing communities.
* Build a community that defines and manages geospatial terms across multiple geospatial projects and communities.
* Set up processes collated in explanations and how-tos which are easy-to-follow by everyday people wanting to stand up an interoperable glossary.

== More Info ==
To know more about the project, refer to our [https://docs.google.com/document/d/1Fjrl34ErnYammel9WmvXJ3rMWFANjoSiiGyyNSYOXUg/edit# project manifesto] or read about our [https://docs.google.com/presentation/d/1WZw1_iAC8uWTqFo335i5h_q8IbEYLqzNRYYWBRNtkd0/edit#slide=id.g98573dba11_0_10 pilot project].

== Point of Contact ==
We communicate on the [https://lists.osgeo.org/mailman/listinfo/lexicon OSGeo Lexicon email list]. (Note: After subscribing, check your email spam for your subscription confirmation email. It is sent straight after subscribing. Or ask cameron . shorter AT gmail .com for help.)
== Want to be a part of our community? ==
If you wish to be a part of this challenging glossary management project, then please reach out to us through our mailing list or our slack channel:
* Try setting up your own glossary using the tools and processes we are establishing. Help us improve in the process.
* Help research and then document best practices in glossary management.
* Help with whatever dirty work is required to keep the project moving forward.

File:Governance real.png

2021-03-23T15:54:27Z

Wiki-Ankitatripathi:

Governance

File:Governance.png

2021-03-23T15:45:55Z

Wiki-Ankitatripathi:

Governance

File:Information schema.png

2021-03-23T15:45:09Z

Wiki-Ankitatripathi:

Information schema

File:Sharing terms.png

2021-03-23T15:44:15Z

Wiki-Ankitatripathi:

Sharing terms