From 223cbe30cbcf2197d4318d515f7148d24998e3e3 Mon Sep 17 00:00:00 2001 From: Callum Rollo Date: Thu, 27 Apr 2023 10:28:43 +0200 Subject: [PATCH 1/4] move history from main document to history.adoc --- OG_Format.adoc | 13 ------------- history.adoc | 17 +++++++++++++++++ 2 files changed, 17 insertions(+), 13 deletions(-) diff --git a/OG_Format.adoc b/OG_Format.adoc index 392b26dc..36365ce2 100644 --- a/OG_Format.adoc +++ b/OG_Format.adoc @@ -5,20 +5,7 @@ OceanGliders 1.0 format - Terms of References |=========================================================================================== -//// -* [[History]] -//// -== History -_Drafted: Victor Turpin – 13/12/2019__ -_Edited: Daniel Hayes -18/12/2019_ -_Reviewed: data format harmonization working group – 07/05/2020_ -_Reviewed: Victor Turpin – 17/11/2020_ -_Edited: Justin Buck/Emma Slater – 26/11/2020_ -_Edited: Thierry Carval – 17/03/2021_ -_Edited: Emma Slater – 24/08/2022_ -_Reviewed: data format harmonization working group – 24/04/2023_ -_Finalized and proposed: data format harmonization group – _ //// * [[Endorsment]] diff --git a/history.adoc b/history.adoc index 124e7b80..767c2df2 100644 --- a/history.adoc +++ b/history.adoc @@ -10,3 +10,20 @@ Approved on 2022-09-12 by: @callumrollo, @vturpin, @JuangaSocib, @emmerbodc, @gl notes: - @JuangaSocib had proposed before alternative solutions (#45 & #69), and later agreed with #103 . - @emmerbodc and @vturpin did intensive and careful review providing a lot of improvements. + + +//// +* [[History]] +//// +== History + +_Drafted: Victor Turpin – 13/12/2019__ +_Edited: Daniel Hayes -18/12/2019_ +_Reviewed: data format harmonization working group – 07/05/2020_ +_Reviewed: Victor Turpin – 17/11/2020_ +_Edited: Justin Buck/Emma Slater – 26/11/2020_ +_Edited: Thierry Carval – 17/03/2021_ +_Edited: Emma Slater – 24/08/2022_ +_Reviewed: data format harmonization working group – 24/04/2023_ +_Finalized and proposed: data format harmonization group – _ + From d7156b04a0d2abf3116346ccd5af551ee1721624 Mon Sep 17 00:00:00 2001 From: Callum Rollo Date: Thu, 27 Apr 2023 10:52:49 +0200 Subject: [PATCH 2/4] add methodology section --- OG_Format.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/OG_Format.adoc b/OG_Format.adoc index 36365ce2..23ceec43 100644 --- a/OG_Format.adoc +++ b/OG_Format.adoc @@ -5,6 +5,15 @@ OceanGliders 1.0 format - Terms of References |=========================================================================================== +//// +* [[Methodology]] +//// +== Methodology + +A working group on harmonization of the glider format was set in September 2020 at the request of the OceanGliders steering team. All volunteers from the OceanGliders data management team was invited to join. +The three existing format (at the time) were analysed and compared by the group. Regular technical meetings occurred and the format harmonization process was managed with a google doc. In late 2021 the group decided to move the document to https://github.com/OceanGlidersCommunity/OG-format-user-manual[GitHub] to better manage the issues, work synchronously and contribute to the community open source policy. +The GitHub repository was open to any comment from the community and validation rules by the working group were created. +From there the working group organized regular meeting to validate the evolution of the format, discuss issues that needed oral explanations and finally reach a consensus on the OG1.0 format. //// From 3791ac73291d89d5c95340aceb6f7f69f662070c Mon Sep 17 00:00:00 2001 From: Callum Rollo Date: Thu, 27 Apr 2023 10:55:04 +0200 Subject: [PATCH 3/4] reformat history bullets --- history.adoc | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/history.adoc b/history.adoc index 767c2df2..3031fc56 100644 --- a/history.adoc +++ b/history.adoc @@ -17,13 +17,13 @@ notes: //// == History -_Drafted: Victor Turpin – 13/12/2019__ -_Edited: Daniel Hayes -18/12/2019_ -_Reviewed: data format harmonization working group – 07/05/2020_ -_Reviewed: Victor Turpin – 17/11/2020_ -_Edited: Justin Buck/Emma Slater – 26/11/2020_ -_Edited: Thierry Carval – 17/03/2021_ -_Edited: Emma Slater – 24/08/2022_ -_Reviewed: data format harmonization working group – 24/04/2023_ -_Finalized and proposed: data format harmonization group – _ +* _Drafted: Victor Turpin – 13/12/2019__ +* _Edited: Daniel Hayes -18/12/2019_ +* _Reviewed: data format harmonization working group – 07/05/2020_ +* _Reviewed: Victor Turpin – 17/11/2020_ +* _Edited: Justin Buck/Emma Slater – 26/11/2020_ +* _Edited: Thierry Carval – 17/03/2021_ +* _Edited: Emma Slater – 24/08/2022_ +* _Reviewed: data format harmonization working group – 24/04/2023_ +* _Finalized and proposed: data format harmonization group – _ From b0ba390bb06db3b0f74bb352f107201147c0e35b Mon Sep 17 00:00:00 2001 From: Callum Rollo Date: Thu, 27 Apr 2023 16:20:59 +0200 Subject: [PATCH 4/4] spelling and grammar --- OG_Format.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/OG_Format.adoc b/OG_Format.adoc index 23ceec43..6653b776 100644 --- a/OG_Format.adoc +++ b/OG_Format.adoc @@ -10,10 +10,10 @@ OceanGliders 1.0 format - Terms of References //// == Methodology -A working group on harmonization of the glider format was set in September 2020 at the request of the OceanGliders steering team. All volunteers from the OceanGliders data management team was invited to join. -The three existing format (at the time) were analysed and compared by the group. Regular technical meetings occurred and the format harmonization process was managed with a google doc. In late 2021 the group decided to move the document to https://github.com/OceanGlidersCommunity/OG-format-user-manual[GitHub] to better manage the issues, work synchronously and contribute to the community open source policy. -The GitHub repository was open to any comment from the community and validation rules by the working group were created. -From there the working group organized regular meeting to validate the evolution of the format, discuss issues that needed oral explanations and finally reach a consensus on the OG1.0 format. +A working group on harmonization of the glider data format was set up in September 2020 at the request of the OceanGliders steering team. All members of the OceanGliders data management team were invited to join. +The three existing formats (at the time) were analysed and compared by the group. Regular technical meetings occurred and the format harmonization process was managed via a google doc. In late 2021 the group decided to move the document to https://github.com/OceanGlidersCommunity/OG-format-user-manual[GitHub] to better manage the issues, work asynchronously and contribute to the open source community. +The GitHub repository was open to any comments from the community and validation rules were created by the working group. +From there the working group organized regular meetings to validate the evolution of the format, discuss issues and finally reach a consensus on the OG1.0 format. ////