Glossary-Project - Revision history

Wiki-Camerons: Code of Conduct

2021-03-27T05:21:53Z

Code of Conduct

Wiki-Camerons: resize images

2021-03-26T06:16:19Z

resize images

Wiki-Labrinos: /* Project budget */

2021-03-25T08:27:10Z

Project budget

Wiki-Camerons: /* Next Steps */

2021-03-24T19:27:38Z

Next Steps

Wiki-Camerons: /* Next Steps */

2021-03-24T19:19:29Z

Next Steps

Wiki-Labrinos: /* Project budget */

2021-03-24T15:14:13Z

Project budget

Wiki-Labrinos at 15:12, 24 March 2021

2021-03-24T15:12:36Z

Wiki-Camerons: /* Want to be a part of our community? */

2021-03-23T22:33:23Z

Want to be a part of our community?

Wiki-Ankitatripathi at 15:55, 23 March 2021

2021-03-23T15:55:30Z

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..."

2021-03-23T15:55:14Z

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..."

New page

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.

← Older revision		Revision as of 05:21, 27 March 2021
Line 65:		Line 65:
	* Help research and then document best practices in glossary management.		* Help research and then document best practices in glossary management.
	* Help with whatever dirty work is required to keep the project moving forward.		* Help with whatever dirty work is required to keep the project moving forward.
		+
		+	== Code of Conduct ==
		+	We are respectful to each other, and welcoming, in line with [https://www.osgeo.org/code_of_conduct/ \| OSGeo's Code of Conduct] policies.

@@ Line 37: / Line 37: @@
 | Total || 5,000 ||
 |}
 == Next Steps ==

@@ Line 33: / Line 33: @@
 | Supporting organization overheads || 300 || Incidentals such as bank processing fees, and general good will.
 |-
-| Swag || 200 || Due to our high mentor:writer and likely high community:writer ratios, we would prefer to invest more than the $200 minimum for goodwill with our community. Details to be confirmed, but may cover something like 10 tee shirts for volunteers.
+| Swag || 200 || Due to our high mentor:writer and likely high community:writer ratios, we would prefer to invest more than the $200 minimum for goodwill with our community.
 |-
 | Total || 5,000 ||

← Older revision		Revision as of 15:55, 23 March 2021
Line 1:		Line 1:
−	~~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.		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.

@@ Line 12: / Line 12: @@
 === 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.
 == Umbrella project ==

@@ Line 43: / Line 43: @@
 * 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 ==

@@ Line 37: / Line 37: @@
 == 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.
+* Try setting up your own glossary using the tools and processes we are establishing. Help us improve 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.