Test copy of GLUE 2.1 latest edited draft imported into GitBook

We are making progress on learning to use GitBook for document production. It’s a bit of a manual process, but features have been improving and we have worked out a pretty straightforward importing process. I've taken the latest draft I could find with edits suggested by Jens’s and Björn's feedback posted here: https://redmine.ogf.org/boards/43/topics/506?r=522 (cf. Shiraz’z notes from the GLUE WG teleconference, Tuesday, November 12, 2019 sent November 13, 2019) and built a test document in Word to use for import testing. Note in this test document, I have accepted all changes and suppressed comments; we can start from another version if desired. Note also that GitBook has its own branching and merging functions as well as the ability to edit, and there is an integration that we have turned on to GitHub that should allow for pull requests and issues in addition to the GitBook draft and merge functionality. The GitBook version of this test document is at the following link: https://open-grid-forum.gitbook.io/glue-2-1-test/ This should be readable by anyone and editable by anyone in the GitBook OGF-GLUE team from within GitBook. The GitHub synchronized copy is at the following link: https://github.com/OpenGridForum/OGF-GLUE-2.1-test The navigation there is by “slug” (the page/section label used within GitBook) and so the document does not display as prettily in GitHub, but should be navigable and suitable for branching, editing, and pull requests as well as discussion of issues in the GitHub setting. this repository is readable and clone-able by anyone in the OGF-GLUE GitHub team (https://github.com/orgs/OpenGridForum/teams/ogf-glue/members) which at this point is different from the GitBook teams. but I or JP should be able to add members with write or other levels of editing and maintaining privileges to either team, or both. Documentation on use of GitBook is available at the following link. https://docs.gitbook.com Please try this out (you won’t be harming anything permanent as this is a test copy) and let me know if we can do anything further to help move the GLUE group to this new document production process. Thanks, Alan

Hi Alan, On 11/09/2020 22:28, Sill, Alan wrote:
We are making progress on learning to use GitBook for document production. [...] The GitBook version of this test document is at the following link: https://open-grid-forum.gitbook.io/glue-2-1-test/
Found something amusing. In "04.-general-statements"
As regards units of measure, multiples of bytes MUST refer to the SI (Le Système International d'Unités) prefix (http://en.wikipedia.org/wiki/SI_prefix), therefore GB is 109 Bytes and not 230 Bytes (the latter are GibiBytes). I was staring at 109, trying to figure out how 1,000,000,000 had morphed into 109.
The "109 Bytes" *should* have been "10^9 Bytes", and "230 Bytes" should have been "2^30 Bytes". I've created an issue: https://github.com/OpenGridForum/OGF-GLUE-2.1-test/issues/1 And a proposed (but untested) fix is here: https://github.com/OpenGridForum/OGF-GLUE-2.1-test/pull/2 Cheers, Paul.

Thanks! I can process this request, and will do so in this case because it is an initial import problem and not a substantive change to the document but rather something to get the Markdown copy to be faithful to the original document, I think it would be good or the GLUE group to migrate to a. workflow in which pull requests, fixes, and edit discussions are handled in regular meetings or resolved by the group leaders themselves. Let me know who should be given appropriate GitBook and/or GitHub merge privileges. Alan
On Sep 16, 2020, at 3:39 AM, Paul Millar <paul.millar@desy.de> wrote:
Hi Alan,
On 11/09/2020 22:28, Sill, Alan wrote:
We are making progress on learning to use GitBook for document production. [...] The GitBook version of this test document is at the following link: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fopen-grid-...
Found something amusing. In "04.-general-statements"
As regards units of measure, multiples of bytes MUST refer to the SI (Le Système International d'Unités) prefix (https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fen.wikipedi...), therefore GB is 109 Bytes and not 230 Bytes (the latter are GibiBytes). I was staring at 109, trying to figure out how 1,000,000,000 had morphed into 109.
The "109 Bytes" *should* have been "10^9 Bytes", and "230 Bytes" should have been "2^30 Bytes".
I've created an issue:
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com...
And a proposed (but untested) fix is here:
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com...
Cheers, Paul. _______________________________________________ glue-wg mailing list glue-wg@ogf.org https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ogf.or...

Update: I tried a couple of ways of resolving the superscript problem and ran into problems - have escalated to GitBook support. Thanks, Alan
On Sep 16, 2020, at 9:29 AM, Sill, Alan <Alan.Sill@ttu.edu> wrote:
Thanks! I can process this request, and will do so in this case because it is an initial import problem and not a substantive change to the document but rather something to get the Markdown copy to be faithful to the original document, I think it would be good or the GLUE group to migrate to a. workflow in which pull requests, fixes, and edit discussions are handled in regular meetings or resolved by the group leaders themselves.
Let me know who should be given appropriate GitBook and/or GitHub merge privileges.
Alan
On Sep 16, 2020, at 3:39 AM, Paul Millar <paul.millar@desy.de> wrote:
Hi Alan,
On 11/09/2020 22:28, Sill, Alan wrote:
We are making progress on learning to use GitBook for document production. [...] The GitBook version of this test document is at the following link: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fopen-grid-...
Found something amusing. In "04.-general-statements"
As regards units of measure, multiples of bytes MUST refer to the SI (Le Système International d'Unités) prefix (https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fen.wikipedi...), therefore GB is 109 Bytes and not 230 Bytes (the latter are GibiBytes). I was staring at 109, trying to figure out how 1,000,000,000 had morphed into 109.
The "109 Bytes" *should* have been "10^9 Bytes", and "230 Bytes" should have been "2^30 Bytes".
I've created an issue:
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com...
And a proposed (but untested) fix is here:
https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com...
Cheers, Paul. _______________________________________________ glue-wg mailing list glue-wg@ogf.org https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ogf.or...
participants (2)
-
Paul Millar
-
Sill, Alan