[Lexicon] Getting started with Glossarist: contributing to the terminology workflow
Cameron Shorter
cameron.shorter at gmail.com
Tue Jul 7 12:24:14 PDT 2020
Jorge,
The decision making process we set up is based on other OSGeo projects (and
other open source projects), and written here:
https://wiki.osgeo.org/wiki/Lexicon_Committee#Decisions
It is basically the principle of do-ocracy. If you are prepared to do the
work, and you appear to know what you are talking about, then you get to
make the decisions.
What is basically saying "Thanks for your interest and contributions, we
encourage you to continue with your enthusiasm, and want to make space for
you to push through on ideas you have, and support you where we can."
My personal involvement is minimal at the moment. At some point in the
future I'm hoping that we can signal boost what you develop at the OSGeo
level into the greater Open Source Technical Writing space (through The
Good Docs Project).
On Wed, 8 Jul 2020 at 03:28, Reese Plews (ISO/TC211 - TMG) <
rplews at tc211tmg.org> wrote:
> hello Jorge,
>
> thank you very much for your interest in the Lexicon Group.
>
> i was working a couple months back with Cameron and Ron to prepare some
> initial documents on how the group may "operate." you can see them at
> the following links.
>
>
> https://docs.google.com/document/d/1wdthaqg2ag-GMharAMZO8xSVK5IH1IXQvtCW5YOF6Cw/edit?usp=sharing
>
>
> https://docs.google.com/document/d/1s3mnlXc7E41olpqSO24x7c_sfg4UtZSHy-r7xnJfNOw/edit?usp=sharing
>
> earlier in the spring we had a telecon to discuss some initial
> abbreviated terms and acronyms and wanted to get those cleaned up and
> categorized. after that, issues with the virus and other matters took
> precedence and i have not had much time to try and work on the file or
> communicate with the members.
>
>
> https://docs.google.com/spreadsheets/d/1nFOa7qE309C6rbnhJXd0EjUKEiqCDYvgpCJpyTjbhmo/edit?usp=sharing
>
>
> https://docs.google.com/document/d/1-ArCFVj38Jsg7qD-90JybI74810hRi_w03GzLjVHZLo/edit?usp=sharing
>
> in the initial documents that were prepared, i tried to model some
> aspects of how this group may operate similar to how ISO/TC 211 manages
> terminology entries. however there are two major differences between ISO
> terminology activities and how i assumed those in OSGEO may operate. it
> stands to reason there would be differences as the focus of the groups
> are different.
>
> for me, the questions that need more discussion or are perhaps
> unanswered: 1) how does this group identify terminology entries, and 2)
> how can the OSGEO members or others collaborate or be involved with
> feedback on the proposed entries. the documents made some proposals but
> testing and discussions were still needed.
>
> in addition to the abbreviated terms and acronyms there are some
> collected terms in that spreadsheet (other worksheet) and the group was
> going to consider how to address them after the work on the abbreviated
> terms and acronyms was finished.
>
> after a terminology entry was "approved by the group" it could be
> translated. a number of members were interested in this translation
> aspect. however, approved entries were needed first.
>
> the glossarist app which you have discovered is being developed by Ron
> and his team to aid in terminology translation in TC211 and elsewhere.
> it conforms to a number of ISO terminology standards and will be used
> for members in TC211 to translate terminology entries for the ISO/TC 211
> Multi-Lingual Glossary of Terms (MLGT) of which a new edition was
> released in early June.
>
> https://isotc211.geolexica.org/
>
> or in excel & word
>
> https://github.com/ISO-TC211/TMG/releases
>
> you can browse the MLGT directly using the Geolexica Framework, also
> developed by Ron's team.
>
> OSGeo's geolexica prototype site is available and will be used by OSGEO
> when terms are "approved", by the lexicon group. after that, those
> approved terms would be available for translation through the glossarist
> app. however a similar discussion and approval process for the
> translated terms should be undertaken by translators of the same
> language. in tc211 the national members organize these groups.
>
> i look forward to hearing from you along with your feedback on the
> documents listed above. thank you for your interest in the group.
>
> best regards,
>
> reese plews
> convenor
> iso/tc211 terminology maintenance group (TMG)
> https://github.com/ISO-TC211/TMG
>
>
>
>
>
>
>
>
>
> ---
>
>
> On 2020-07-08 00:12, Jorge Gustavo Rocha wrote:
> > Hi Ron,
> >
> > Thanks for the feedback. Now I think I understood the entire workflow
> > (which is really the usual git workflow). I think it is a very nice way
> > to have people contributing to the terminology in a open and
> > transparent
> > way. For developers, the workflow is quite simple.
> >
> > I'll wait for the update to the osgeo-glossary repo.
> >
> > By the way, who will have permission to merge PR on this osgeo-glossary
> > repo? Is this already defined?
> >
> > Regards,
> >
> > Jorge
> >
> > On 07/07/20 11:21, Ronald Tse wrote:
> >> Hi Jorge,
> >>
> >> Thank you for trying out Glossarist!
> >>
> >> Actually the OSGeo glossary repository needs to be updated to suit the
> >> latest version of Glossarist — which we are going to do so today. The
> >> current repo is using an older data schema. The unexpected diffs are
> >> due
> >> to this reason.
> >>
> >> In order to submit change requests, you will need write access to the
> >> repository. Should the group discuss about it?
> >>
> >> Now to the questions:
> >>> 2) To change something, I must start a change request and make my
> >>> changes, right?
> >>
> >> Yes, you’re right. A change request can contain multiple changes.
> >>
> >>> 3) Afterwards, in my local
> >>> ~/.config/Electron/glossarist-database/change-requests I have the
> >>> changes from my change request.
> >>
> >> Correct. The git “upstream” remote is a deprecated artifact, it will
> >> be
> >> removed in the next version of Glossarist.
> >>
> >>> 4) Question: If I want to contribute to the OSGeo terminology, what
> >>> should I do next?
> >>>
> >>> Should I push my changes from the command line or there is some
> >>> button
> >>> on Glossarist to submit the change request?
> >>
> >> Glossarist has the Review pane where you can “Propose” a CR, after
> >> which
> >> you can “Sync” (top left of window) — it will upload the CR.
> >>
> >> In this case, since you don’t have direct write access, you could:
> >> 1. First, work on your fork of the repository — i.e. fork
> >> https://github.com/geolexica/osgeo-glossary , and make that your new
> >> remote in Glossarist.
> >> 2. Create a CR in your own fork
> >> 3. Make a Pull Request to submit your CR to the master branch of
> >> https://github.com/geolexica/osgeo-glossary
> >> 4. Whoever has access to merge can bring in your CR to master and
> >> review/approve the CR.
> >>
> >> Would you mind waiting until tomorrow for the new version of
> >> Glossarist
> >> (due tonight) and the upgrade of the data repo schema?
> >>
> >> Thanks!
> >>
> >> Ron
> >>
> >> _____________________________________
> >>
> >> Ronald Tse
> >> Ribose Inc.
> >>
> >> +=========================================================+
> >> This message may contain confidential and/or privileged
> >> information. If you are not the addressee or authorized to
> >> receive this for the addressee, you must not use, copy,
> >> disclose or take any action based on this message or any
> >> information herein. If you have received this message in
> >> error, please advise the sender immediately by reply e-mail
> >> and delete this message. Thank you for your cooperation.
> >> +=========================================================+
> >>
> >>> On Jul 7, 2020, at 5:03 PM, Jorge Gustavo Rocha <jgr at osgeopt.pt
> >>> <mailto:jgr at osgeopt.pt>> wrote:
> >>>
> >>> Hi all,
> >>>
> >>> I've clone the Glossarist desktop tool repo and started to use it. It
> >>> work pretty well on my Ubuntu. Thanks for those working on it.
> >>>
> >>> I would like to understand the workflow behind it and how can we use
> >>> it
> >>> in OSGeo.
> >>>
> >>> 1) I've started Glossarist, identified my self with my Github
> >>> account. I
> >>> can browse existent entries and the application is working smoothly.
> >>> Great!
> >>>
> >>> 2) To change something, I must start a change request and make my
> >>> changes, right?
> >>>
> >>> 3) Afterwards, in my local
> >>> ~/.config/Electron/glossarist-database/change-requests I have the
> >>> changes from my change request.
> >>>
> >>> The folder ~/.config/Electron/glossarist-database is under git
> >>> control
> >>> (setup done by Glossarist).
> >>>
> >>> The remote repos are:
> >>>
> >>> jgr at zoe:~/.config/Electron/glossarist-database$ git remote -v
> >>> originhttps://github.com/geolexica/osgeo-glossary (fetch)
> >>> originhttps://github.com/geolexica/osgeo-glossary (push)
> >>> upstreamhttps://github.com/ISO-TC211/geolexica-database (fetch)
> >>> upstreamhttps://github.com/ISO-TC211/geolexica-database (push)
> >>>
> >>> 4) Question: If I want to contribute to the OSGeo terminology, what
> >>> should I do next?
> >>>
> >>> Should I push my changes from the command line or there is some
> >>> button
> >>> on Glossarist to submit the change request?
> >>>
> >>> Note: All local files were rewritten and git reports changes in all
> >>> terms. I didn't expect such changes. As far as I can understand, git
> >>> should report only changes in `change-requests` folder, right?
> >>>
> >>> My local --stats are:
> >>>
> >>> jgr at zoe:~/.config/Electron/glossarist-database$ git diff --stat
> >>> --cached
> >>> origin/master | head -10
> >>> change-requests/7a5c63.yaml | 37 +++++++++++++
> >>> change-requests/bd20b0.yaml | 61 ++++++++++++++++++++++
> >>> concepts/concept-1.yaml | 30 +++++++++--
> >>> concepts/concept-10.yaml | 30 +++++++++--
> >>> concepts/concept-100.yaml | 30 +++++++++--
> >>> concepts/concept-101.yaml | 30 +++++++++--
> >>> concepts/concept-102.yaml | 30 +++++++++--
> >>> concepts/concept-103.yaml | 30 +++++++++--
> >>> concepts/concept-104.yaml | 30 +++++++++--
> >>> concepts/concept-105.yaml | 30 +++++++++--
> >>>
> >>> Unexpected changes (for me!) are like this one:
> >>>
> >>> jgr at zoe:~/.config/Electron/glossarist-database$ git diff --cached
> >>> origin/master concepts/concept-10.yaml
> >>> diff --git a/concepts/concept-10.yaml b/concepts/concept-10.yaml
> >>> index 0c68c10..54ae114 100644
> >>> --- a/concepts/concept-10.yaml
> >>> +++ b/concepts/concept-10.yaml
> >>> @@ -1,4 +1,3 @@
> >>> ----
> >>> term: AM/FM
> >>> termid: 10
> >>> eng:
> >>> @@ -8,8 +7,29 @@ eng:
> >>> notes: []
> >>> examples: []
> >>> authoritative_source:
> >>> - link:
> >>> https://www.osgeo.org/wp-content/uploads/Newsletter-Vol-5_01.pdf
> >>> + link:
> >>> 'https://www.osgeo.org/wp-content/uploads/Newsletter-Vol-5_01.pdf'
> >>> terms:
> >>> - - type: expression
> >>> - designation: AM/FM
> >>> - normative_status:
> >>> + - type: expression
> >>> + designation: AM/FM
> >>> + normative_status: null
> >>> + _revisions:
> >>> + current: 0c7724
> >>> + tree:
> >>> + 0c7724:
> >>> + object:
> >>> + id: 10
> >>> + definition: Automated Mapping/Facilities Management
> >>> + language_code: eng
> >>> + notes: []
> >>> + examples: []
> >>> + authoritative_source:
> >>> + link:
> >>> 'https://www.osgeo.org/wp-content/uploads/Newsletter-Vol-5_01.pdf'
> >>> + terms:
> >>> + - type: expression
> >>> + designation: AM/FM
> >>> + normative_status: null
> >>> + parents: []
> >>> + timeCreated: 2020-07-06T21:28:14.660Z
> >>> + author:
> >>> + name: Glossarist bot
> >>> + email: glossarist at ribose.com
> >>> <mailto:glossarist at ribose.com>
> >>>
> >>> Sorry for this newbie question.
> >>>
> >>> But soon as I understand the workflow, I can write a short tutorial
> >>> about how to use Glossarist to maintain and improve OSGeo
> >>> terminology.
> >>>
> >>> Regards,
> >>>
> >>> Jorge
> >>>
> >>>
> >>> On 04/07/20 13:47, Richard Duivenvoorde wrote:
> >>>> Nice Nice!!!
> >>>>
> >>>> And good to lift this to an higher (OSGeo) plan!!
> >>>>
> >>>> Go go! :-)
> >>>>
> >>>> Regards,
> >>>>
> >>>> Richard Duivenvoorde
> >>>>
> >>>> (bcc to our dutch translation master)
> >>>>
> >>>> On 7/4/20 11:01 AM, Jorge Gustavo Rocha wrote:
> >>>>> Hi Ron,
> >>>>>
> >>>>> Thank you for the update.
> >>>>>
> >>>>> I've looked in the current https://osgeodev.geolexica.org and on
> >>>>> yours
> >>>>> Glossarist desktop tool. Looks like very promising.
> >>>>>
> >>>>> OSGeo and QGIS in particular would benefit from such a well defined
> >>>>> glossary.
> >>>>>
> >>>>> I'll be watching the project. I'll try to contribute with build
> >>>>> instructions for Linux :-)
> >>>>>
> >>>>> Best regards,
> >>>>>
> >>>>> Jorge
> >>>>>
> >>>>> On 04/07/20 04:56, Ronald Tse wrote:
> >>>>>> Hi Jorge,
> >>>>>>
> >>>>>> Thank you for spreading the news!
> >>>>>>
> >>>>>> The current development site with loaded terms is located here:
> >>>>>> https://osgeodev.geolexica.org
> >>>>>>
> >>>>>> I believe the group is still waiting for some confirmation on
> >>>>>> terminology across OSGeo. As you can see on the site, a number of
> >>>>>> conflicting definitions exist and the group would need some effort
> >>>>>> to
> >>>>>> discuss and attempt to settle these — since they are used across
> >>>>>> different OSGeo projects.
> >>>>>>
> >>>>>> Geolexica has also been working with ISO/TC 211 on their latest
> >>>>>> efforts
> >>>>>> in translating the 5th edition of the TC 211 Multi-Lingual
> >>>>>> Glossary of
> >>>>>> Terms (MLGT). There is now have a desktop application for managing
> >>>>>> translations through change requests, all based off a git
> >>>>>> repository on
> >>>>>> GitHub:
> >>>>>> https://www.glossarist.org
> >>>>>>
> >>>>>> I agree that more love is needed to the lexicon group to move
> >>>>>> things ahead!
> >>>>>>
> >>>>>> Kind regards,
> >>>>>> Ron
> >>>>>>
> >>>>>> _____________________________________
> >>>>>>
> >>>>>> Ronald Tse
> >>>>>> Ribose Inc.
> >>>>>>
> >>>>>> +=========================================================+
> >>>>>> This message may contain confidential and/or privileged
> >>>>>> information. If you are not the addressee or authorized to
> >>>>>> receive this for the addressee, you must not use, copy,
> >>>>>> disclose or take any action based on this message or any
> >>>>>> information herein. If you have received this message in
> >>>>>> error, please advise the sender immediately by reply e-mail
> >>>>>> and delete this message. Thank you for your cooperation.
> >>>>>> +=========================================================+
> >>>>>>
> >>>>>>> On Jul 4, 2020, at 6:23 AM, Jorge Gustavo Rocha <jgr at di.uminho.pt
> >>>>>>> <mailto:jgr at di.uminho.pt>> wrote:
> >>>>>>>
> >>>>>>> Hi Ian, hi all,
> >>>>>>>
> >>>>>>> There are people trying to run an OSGeo "Interest group" on
> >>>>>>> "Terminology", to be transversal to all OSGeo projects.
> >>>>>>>
> >>>>>>> They created a proof of concept, called "geolexica", available
> >>>>>>> at:
> >>>>>>>
> >>>>>>> https://osgeo.geolexica.org/concepts/
> >>>>>>>
> >>>>>>> Sources on: https://github.com/geolexica/osgeo.geolexica.org
> >>>>>>>
> >>>>>>> It would be awesome if we were able to fill the translation for
> >>>>>>> the
> >>>>>>> different languages associated with the English concept, right on
> >>>>>>> the
> >>>>>>> origin.
> >>>>>>>
> >>>>>>> As far I as know (I'm cc to lexica group), this project needs
> >>>>>>> some
> >>>>>>> additional "love" to go on.
> >>>>>>>
> >>>>>>> Maybe Cameron (in cc) or someone else can make an update on the
> >>>>>>> lexicon
> >>>>>>> activities/plans.
> >>>>>>>
> >>>>>>> Regards,
> >>>>>>>
> >>>>>>> Jorge
> >>>>>>>
> >>>>>>> On 30/06/20 10:57, Ian Turton wrote:
> >>>>>>>>
> >>>>>>>>
> >>>>>>>> On Tue, 30 Jun 2020 at 10:40, Bo Victor Thomsen
> >>>>>>>> <bo.victor.thomsen at gmail.com
> >>>>>>>> <mailto:bo.victor.thomsen at gmail.com>> wrote:
> >>>>>>>>
> >>>>>>>> Dear developers:
> >>>>>>>>
> >>>>>>>> As a former translator of the Danish version of QGIS I have a
> >>>>>>>> few -
> >>>>>>>> very personal, perhaps a bit caustic - comments:
> >>>>>>>>
> >>>>>>>> * Create a group or list of highly technical GIS related
> >>>>>>>> terms
> >>>>>>>> that is *not* to be translated. There is a lot of GIS
> >>>>>>>> terms that
> >>>>>>>> is English in origin, but haven't a well defined local
> >>>>>>>> translation. (With some hilarious results if they are
> >>>>>>>> translated). Not all translators is well versed in every
> >>>>>>>> aspect
> >>>>>>>> of GIS.
> >>>>>>>>
> >>>>>>>>
> >>>>>>>>
> >>>>>>>> Is this something that OSGEO can help to oversee and/or maintain
> >>>>>>>> as I
> >>>>>>>> suspect that this list would be useful across many projects.
> >>>>>>>>
> >>>>>>>> Ian
> >>>>>>>>
> >>>>>>>> --
> >>>>>>>> Ian Turton
> >>>>>>>>
> >>>>>>>> _______________________________________________
> >>>>>>>> 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
> >>>>>>>>
> >>>>>>>
> >>>>>>> J. Gustavo
> >>>>>>> --
> >>>>>>> Jorge Gustavo Rocha
> >>>>>>> Departamento de Informática
> >>>>>>> Universidade do Minho
> >>>>>>> 4710-057 Braga
> >>>>>>> Gabinete 3.29 (Piso 3)
> >>>>>>> Tel: +351 253604480
> >>>>>>> Fax: +351 253604471
> >>>>>>> Móvel: +351 910333888
> >>>>>>> skype: nabocudnosor
> >>>>>>> _______________________________________________
> >>>>>>> Lexicon mailing list
> >>>>>>> Lexicon at lists.osgeo.org
> >>>>>>> https://lists.osgeo.org/mailman/listinfo/lexicon
> >>>>>>
> >>>>>
> >>>>> J. Gustavo
> >>>>>
> >>>>
> >>>> _______________________________________________
> >>>> Lexicon mailing list
> >>>> Lexicon at lists.osgeo.org <mailto:Lexicon at lists.osgeo.org>
> >>>> https://lists.osgeo.org/mailman/listinfo/lexicon
> >>>>
> >>>
> >>> --
> >>> OSGeo Portugal
> >>> NIF: 509588190
> >>> email: geral at osgeopt.pt <mailto:geral at osgeopt.pt>
> >>> https://www.osgeopt.pt/
> >>>
> >>> Próximo evento: SASIG 2017, 20 a 22 de novembro, Porto
> >>> Mais informações: http://osgeopt.pt/sasig2017/
> >>> _______________________________________________
> >>> Lexicon mailing list
> >>> Lexicon at lists.osgeo.org
> >>> https://lists.osgeo.org/mailman/listinfo/lexicon
> >>
> _______________________________________________
> Lexicon mailing list
> Lexicon at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/lexicon
>
--
Cameron Shorter
Technical Writer, Google
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/lexicon/attachments/20200708/4ad5c3f1/attachment-0001.html>
More information about the Lexicon
mailing list