[glue-wg] GLUE2 enumerations

Fri Jul 31 13:58:44 EDT 2020

Hi Alan,

Please send me an invitation to setup the GLUE WG team on gitbook.com. Will I be able to invite or add other GLUE WG folks, or do we need to identify all the GLUE WG contributors?

Are there specific current best practices in the online community that we should pay special attention to?

Thanks,

JP

> On Jul 31, 2020, at 11:17 AM, Sill, Alan <alan.sill at ttu.edu> wrote:
> 
> We have been able to arrange permanent free access to the GitBook tool (https://gitbook.com <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 <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 at mcs.anl.gov <mailto:navarro at 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 <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 at ttu.edu <mailto:alan.sill at ttu.edu>> wrote:
>>> 
>>> The OGF GLUE group began to use GitHub before OGF created the official github.com/opengridforum <http://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 at hep.lu.se <mailto:florido.paganelli at 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&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&sdata=Q3elZh0Vaz5PyolJ9EdzduuIOfiHdzhwa59IMOZg3Sc%3D&reserved=0 <https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FOGF-GLUE&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&sdata=Q3elZh0Vaz5PyolJ9EdzduuIOfiHdzhwa59IMOZg3Sc%3D&reserved=0>
>>>> and
>>>> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FOpenGridForum%2FOGF-GLUE&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&sdata=umJbgisxGRTCvg6%2Bvq%2BSEebJqC87aT%2Bje8yb9jcvIfU%3D&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&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&sdata=umJbgisxGRTCvg6%2Bvq%2BSEebJqC87aT%2Bje8yb9jcvIfU%3D&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 at hep.lu.se <mailto:florido.paganelli at 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&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269651626&sdata=qJyKcPRx5g052OrSkAih09qM7n436gUpBU8Zx6lM1EQ%3D&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 at hep.lu.se <mailto:florido.paganelli at 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&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=Yk5q69rlrfZYPuZpO3m5BgglDazN3ArUZB%2FcE2FGhRg%3D&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&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=OR6q7ksSqaUulZtum%2FeLm7pN7U1oFBA99jga367A2J4%3D&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&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=mT8JZRIM%2BBikULrZh%2FOymvF4Dt23sw66Ngr6rEf%2BoRo%3D&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 at REMOVE_THIShep.lu.se <mailto:florido.paganelli at remove_thishep.lu.se>
>>>>>>>> Homepage:https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.hep.lu.se%2Fstaff%2Fpaganelli&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=zHSwH4pcttBavE1z6nJAH02utSvroCiDzORlK%2FkaNdQ%3D&reserved=0
>>>>>>>> ==================================================
>>>>>>>> 
>>>>>>>> _______________________________________________
>>>>>>>> glue-wg mailing list
>>>>>>>> glue-wg at ogf.org <mailto:glue-wg at ogf.org>
>>>>>>>> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ogf.org%2Fmailman%2Flistinfo%2Fglue-wg&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=GwSn%2BKlTaPrDvLWZPNEuSXcq13%2Bsv4brIXbcoSxAixI%3D&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 at REMOVE_THIShep.lu.se <mailto:florido.paganelli at remove_thishep.lu.se>
>>>>>> Homepage:https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.hep.lu.se%2Fstaff%2Fpaganelli&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=zHSwH4pcttBavE1z6nJAH02utSvroCiDzORlK%2FkaNdQ%3D&reserved=0
>>>>>> ==================================================
>>>>>> _______________________________________________
>>>>>> glue-wg mailing list
>>>>>> glue-wg at ogf.org <mailto:glue-wg at ogf.org>
>>>>>> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ogf.org%2Fmailman%2Flistinfo%2Fglue-wg&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=GwSn%2BKlTaPrDvLWZPNEuSXcq13%2Bsv4brIXbcoSxAixI%3D&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 at REMOVE_THIShep.lu.se
>>>> Homepage: https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.hep.lu.se%2Fstaff%2Fpaganelli&data=02%7C01%7CAlan.Sill%40ttu.edu%7Cc7cc3d930be247523b0308d835610ec8%7C178a51bf8b2049ffb65556245d5c173c%7C0%7C0%7C637318038269661624&sdata=zHSwH4pcttBavE1z6nJAH02utSvroCiDzORlK%2FkaNdQ%3D&reserved=0
>>>> ==================================================
>>> 
>> 
> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.ogf.org/pipermail/glue-wg/attachments/20200731/3df454cd/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 873 bytes
Desc: Message signed with OpenPGP
URL: <http://www.ogf.org/pipermail/glue-wg/attachments/20200731/3df454cd/attachment-0001.pgp>