We have been able to arrange permanent free access to the GitBook tool (https://gitbook.com) used by many European projects for OGF use as a non-profit organization. This tool provides many features to enable conversion of documents from various source formats (e.g., Microsoft Word) to Markdown and/or rich text format and maintenance of these documents in a repository-friendly way (e.g., on GitHub). We think this will be a viable way of producing and maintaining documents that does not tie us unduly to GitBook but will allow the option of a rich feature set. Details are at https://docs.gitbook.com and I can send you an invitation to set up a team that you can then tie to the preferred OGF-GLUE repository through their GitHub integration.

In general we are trying to migrate to have OGF document production practices more in line with current best practices in the online community for ease of maintenance and long-term continuity. We’re open to any other suggestions along these lines, of course.

Alan 

On Jul 31, 2020, at 10:28 AM, Navarro, JP <navarro@mcs.anl.gov> wrote:

Alan,

Could you please elaborate on the “further features” that are under development and any transition or new tools?

Are there any guidelines or best practices on how to organize GitHub content consistently between working groups?

I want to organize GLUE WG migration to https://github.com/OpenGridForum/OGF-GLUE right away so that we leverage any tools you have and not duplicate effort where avoidable.

Thanks,

JP

On Jul 31, 2020, at 9:55 AM, Sill, Alan <alan.sill@ttu.edu> wrote:

The OGF GLUE group began to use GitHub before OGF created the official github.com/opengridforum area. For continuity and ease of finding the official areas, we are encouraging OGF groups to migrate their work to the official OGF community pages areas. Further features of this are under development to transition the old OGF Redmine git repositories and to introduce new tools to make online preparation of documents easier for all groups.

Alan

On Jul 31, 2020, at 9:50 AM, Florido Paganelli <florido.paganelli@hep.lu.se> wrote:

Hi Alan,

I am a bit confused. Can you clarify why there's two github repos now? I see

https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FOGF-GLUE&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&amp;sdata=Q3elZh0Vaz5PyolJ9EdzduuIOfiHdzhwa59IMOZg3Sc%3D&amp;reserved=0
and
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FOpenGridForum%2FOGF-GLUE&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&amp;sdata=umJbgisxGRTCvg6%2Bvq%2BSEebJqC87aT%2Bje8yb9jcvIfU%3D&amp;reserved=0

You mean the latter is the actual official one?
I do not remember any longer how we got into the former one.

Also the former currently has well-defined teams as long as I can see. But probably they no longer make any sense.

How would you keep the two in sync if it makes any sense to do that?

Cheers,
Florido

On 2020-07-31 16:00, Sill, Alan wrote:
For long-term maintainability, it might be valuable to move the official GLUE files as well as the document source to the OGF GLUE WG pages https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FOpenGridForum%2FOGF-GLUE&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&amp;sdata=umJbgisxGRTCvg6%2Bvq%2BSEebJqC87aT%2Bje8yb9jcvIfU%3D&amp;reserved=0
We’ll be happy to provide full administrative access to the current group leadership and sere as a focal point for maintaining this area going forward.
Alan
On Jul 31, 2020, at 3:41 AM, Florido Paganelli <florido.paganelli@hep.lu.se <mailto:florido.paganelli@hep.lu.se>> wrote:

Hi all,

On 2020-07-30 22:50, Navarro, JP wrote:
Hello Florido,
Reviewing our last GLUE2 WG meeting on November 12, 2019 I see that we have not made visible progress on GLUE 2.1 action items. That is in part my fault which I’ll try to correct soon.

I think some of the enumerations introduced with GLUE2.1 are not part of the list on github. Actually the github repo itself is far from complete. But I guess due to the best effort basis of this work we stick to the enumerations that are most important, I guess ServiceType_t at the moment.

As for the languishing Enumerations pull requests, since this GLUE effort is purely volunteer, others can volunteer to review the pull requests and merge them. If nobody volunteers, and we don’t hear from David, I’m willing to help out.
Would you be willing to review and accept the changes to your "OGF GLUE2 Enumerations procedures and best practices” document so that we can post it and make it official after a brief comment period? With that document in hand it will be easier for myself or others to help maintain the list of Enumerations.

I can do.

Once the procedure is clear I have no problem accepting pull requests and doing the merges from time to time. Of course others are warmly welcome.

I also noticed a copy of the document is here in wiki format:

https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fredmine.ogf.org%2Fprojects%2Fglue-wg%2Fwiki%2FEnumerations_procedures_and_best_practices_v10&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&amp;sdata=qJyKcPRx5g052OrSkAih09qM7n436gUpBU8Zx6lM1EQ%3D&amp;reserved=0

Which is referenced in the GLUE2.1 specification so it must be kept up to date.

I guess the best is to keep that page and eventually change the version in the page but not the link.

Cheers,
Florido

Regards,
JP
p.s. as you can see, we/XSEDE still want to engage and contribute to the GLUE WG
On Jul 30, 2020, at 3:54 AM, Florido Paganelli <florido.paganelli@hep.lu.se <mailto:florido.paganelli@hep.lu.se>> wrote:

Hi all

I haven't been following the progress in this group for quite a while,
as a matter of fact I do not even know if this channel is still official.

I've been asked by Greg from UKRI STFC in UK (in CC) about the status of
the Open Enumerations registry at

https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FOGF-GLUE%2FEnumerations&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=Yk5q69rlrfZYPuZpO3m5BgglDazN3ArUZB%2FcE2FGhRg%3D&amp;reserved=0

I recall David Meredith was taking care of merging pull requests but I
do not see any updated procedure anywhere and I think he is no longer
actively doing the merges.

I wonder how we should go about it. Right now most of my research group
is on vacation and I do not know how much NorduGRID/ARC is interested in
being part of this. If Greg and UKRI STFC are interested in maintaining
the registry I will gladly give them rights to approve merge requests.

My only complaint after a quick look at the current pull requests

https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FOGF-GLUE%2FEnumerations%2Fpulls&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=OR6q7ksSqaUulZtum%2FeLm7pN7U1oFBA99jga367A2J4%3D&amp;reserved=0

Is that some of the new strings are not all lowercase. I would prefer
they are all lowercase at least, to be consistent with the rest of
GLUE2. But I do not know what happened in GLUE2.1 and how much you kept
consistency. I must sadly say I lost interest long ago in the group
activities mainly for the lack of consistency in some that I believe
were critical decisions so my enthusiasm about the subject is low.

About the pending merge requests, I think the namespaces in the pull
requests are all well formed, one should check case by case how much
they conform to the expected values and how good the descriptions are, I
remember we had different opinions about these details as well but I
forgot what it was about.

I have the feeling the word ServiceType is overused as there is some
confusion about what is a GLUE2 ServiceType and what is a GOCDB
servicetype, but as said I've been far from this and lost track.

I'd say from my side as long as it doesn't affect ARC/NorduGRID
negatively I don't really care about which strings end up in this registry.

I think the main point is, was there ever consensus on this document
which defines formats and other similar things?

https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fredmine.ogf.org%2Fdmsf_files%2F13224%3Fdownload%3D&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=mT8JZRIM%2BBikULrZh%2FOymvF4Dt23sw66Ngr6rEf%2BoRo%3D&amp;reserved=0

Clearly not since the document suggest scheduled venues for the merges
that clearly never happened. Sad. But partly also my bad for not
following up.

Would be nice to update such document and the information on github with
the actual procedure including pull requests.

Cheers,
Florido
--
==================================================
Florido Paganelli
ARC Middleware Developer - NorduGrid Collaboration
System Administrator
Lund University
Department of Physics
Division of Particle Physics
BOX118
221 00 Lund
Office Location: Fysikum, Hus A, Rum A403
Office Tel: 046-2220272
Email:florido.paganelli@REMOVE_THIShep.lu.se <mailto:florido.paganelli@remove_thishep.lu.se>
Homepage:https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.hep.lu.se%2Fstaff%2Fpaganelli&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=zHSwH4pcttBavE1z6nJAH02utSvroCiDzORlK%2FkaNdQ%3D&amp;reserved=0
==================================================

_______________________________________________
glue-wg mailing list
glue-wg@ogf.org <mailto:glue-wg@ogf.org>
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ogf.org%2Fmailman%2Flistinfo%2Fglue-wg&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=GwSn%2BKlTaPrDvLWZPNEuSXcq13%2Bsv4brIXbcoSxAixI%3D&amp;reserved=0

--
==================================================
Florido Paganelli
ARC Middleware Developer - NorduGrid Collaboration
System Administrator
Lund University
Department of Physics
Division of Particle Physics
BOX118
221 00 Lund
Office Location: Fysikum, Hus A, Rum A403
Office Tel: 046-2220272
Email:florido.paganelli@REMOVE_THIShep.lu.se <mailto:florido.paganelli@remove_thishep.lu.se>
Homepage:https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.hep.lu.se%2Fstaff%2Fpaganelli&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=zHSwH4pcttBavE1z6nJAH02utSvroCiDzORlK%2FkaNdQ%3D&amp;reserved=0
==================================================
_______________________________________________
glue-wg mailing list
glue-wg@ogf.org <mailto:glue-wg@ogf.org>
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ogf.org%2Fmailman%2Flistinfo%2Fglue-wg&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=GwSn%2BKlTaPrDvLWZPNEuSXcq13%2Bsv4brIXbcoSxAixI%3D&amp;reserved=0

--
==================================================
Florido Paganelli
ARC Middleware Developer - NorduGrid Collaboration
System Administrator
Lund University
Department of Physics
Division of Particle Physics
BOX118
221 00 Lund
Office Location: Fysikum, Hus A, Rum A403
Office Tel: 046-2220272
Email: florido.paganelli@REMOVE_THIShep.lu.se
Homepage: https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.hep.lu.se%2Fstaff%2Fpaganelli&amp;data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&amp;sdata=zHSwH4pcttBavE1z6nJAH02utSvroCiDzORlK%2FkaNdQ%3D&amp;reserved=0
==================================================