From c4b3152066dd8f37557b84abae5de7c7adc8a8eb Mon Sep 17 00:00:00 2001
From: Jutta Schnabel <jschnabel@km3net.de>
Date: Mon, 19 Oct 2020 02:37:50 +0200
Subject: [PATCH] shuffle chapters

---
 Deliverable Description 4.8 Outline.md | 29 ++++++++++++++------------
 filelist_D4-8.txt                      |  6 ++++--
 pages/Dataformats.md                   |  2 --
 pages/Detector.md                      |  2 --
 pages/FAIR.md                          |  5 +++--
 pages/Infrastructure.md                |  1 +
 pages/ScienceTargets.md                |  2 ++
 7 files changed, 26 insertions(+), 21 deletions(-)

diff --git a/Deliverable Description 4.8 Outline.md b/Deliverable Description 4.8 Outline.md
index a92946b..a919787 100644
--- a/Deliverable Description 4.8 Outline.md	
+++ b/Deliverable Description 4.8 Outline.md	
@@ -1,25 +1,28 @@
 # Deliverable 4.8 - Description (D)
 ## 0 Introduction
-1. FAIR principles
-2. Scientific targets
-3. Architecture overview
+  Open Science System
+  1) Which science?
+  2) How to make it open
+  3) description of the system
 
-## Implementation
-### I Data generation
+### I Science in KM3NeT
+2. Scientific targets
 1. Detector description
 2. Particle event data
 3. Environmental data
 5. Alert system
 6. Event simulation
 
-### II Data processing & monitoring
-1. Data management overview
-2. Workflow management
-3. Metadata generation
-4. Quality management
-5. Publication procedures
+### II Meeting criteria for FAIR data
+1. FAIR principles
+2. Data management overview
+3. Workflow management
+4. Metadata generation
+5. Quality management
+6. Publication procedures
 
-### III Archiving and access
+### III The KM3NeT Open Science System
+2. Architecture overview
 1. Open data formats per data type
 2. Platforms and servers
   * VO server
@@ -43,7 +46,7 @@
 3. Environmental data
 4. Example Alert
 
-## V Test
+## V Testing
 ### By external user
 1. Test of data access
 2. Test of software installation
diff --git a/filelist_D4-8.txt b/filelist_D4-8.txt
index 341f414..f26f85f 100644
--- a/filelist_D4-8.txt
+++ b/filelist_D4-8.txt
@@ -1,15 +1,17 @@
-pages/FAIR.md
 pages/ScienceTargets.md
-pages/Infrastructure.md
 pages/Detector.md
 pages/SeaScience.md
 pages/Multimessenger.md
 pages/Simulation.md
 pages/Processing.md
+
+pages/FAIR.md
 pages/Workflows.md
 pages/Datamodels.md
 pages/Quality.md
 pages/Procedures.md
+
+pages/Infrastructure.md
 pages/Dataformats.md
 pages/VOserver.md
 pages/KM3NeTserver.md
diff --git a/pages/Dataformats.md b/pages/Dataformats.md
index 8c74072..98423c0 100644
--- a/pages/Dataformats.md
+++ b/pages/Dataformats.md
@@ -8,8 +8,6 @@ Topics:
     - different example data: antares events, plots, orca events, acoustic
 ---
 
-# Access and Archiving
-
 ## Open data sets and formats
 
 As all of the following data is published, inter alia, via the Open Data Center, the data sets are all enriched with metadata following the [KM3OpenResource description](Datamodels.md#resource-description).
diff --git a/pages/Detector.md b/pages/Detector.md
index 3563c51..f0a9e38 100644
--- a/pages/Detector.md
+++ b/pages/Detector.md
@@ -6,8 +6,6 @@ Reviewer: Tamas
 Comment: Mainly based on LoI
 ---
 
-# Data generation
-
 ## Detector
 
 The KM3NeT Research Infrastructure will consist of a network of deep-sea neutrino detectors in the Mediterranean Sea with user ports for Earth and Sea sciences.
diff --git a/pages/FAIR.md b/pages/FAIR.md
index 09031ef..5d4e417 100644
--- a/pages/FAIR.md
+++ b/pages/FAIR.md
@@ -7,12 +7,13 @@ Topics:
 Reviewer: Jannik
 status: reviewed
 ---
-# Introduction
+# Meeting criteria for FAIR data
 
-## Publishing FAIR data
+## Making data FAIR
 
 ### Requirements for FAIR data
 The widely-accepted paradigm for open science data publication requires the implementation of the [FAIR principles](https://www.go-fair.org/fair-principles/) for research data. This involves the 
+
 * definition of descriptive and standardized **metadata** and application of persistent identifiers to create a transparent and self-descriptive data regime,
 * Interlinking this data to common science platforms and **registries** to increase findability, 
 * possibility to harvest from the data through commonly implemented **interfaces** and
diff --git a/pages/Infrastructure.md b/pages/Infrastructure.md
index 91d503c..e22c659 100644
--- a/pages/Infrastructure.md
+++ b/pages/Infrastructure.md
@@ -6,6 +6,7 @@ Topics:
 Reviewer: Jannik
 status: reviewed
 ---
+# The KM3NeT open science system
 
 ## Platforms for Open Science
 
diff --git a/pages/ScienceTargets.md b/pages/ScienceTargets.md
index 058e74f..87833d1 100644
--- a/pages/ScienceTargets.md
+++ b/pages/ScienceTargets.md
@@ -6,6 +6,8 @@ Reviewer: Tamas
 Comment: Mainly based on LoI and Infradev Grant Agreement
 ---
 
+# Science in KM3NeT
+
 ## Scientific Targets
 
 The KM3NeT neutrino detectors will continuously register neutrinos from the whole sky. The neutrinos of astrophysical interest, i.e. those from extra-terrestrial origin, need to be identified in the background of atmospheric neutrinos, i.e. those created in Earth’s atmosphere by interactions of cosmic-ray particles. Access to cosmic neutrino data is of high importance for a wide astrophysics community to relate cosmic neutrino fluxes to observations by other neutrino observatories or using [other messengers](Multimessengers.md), and to compare them with theoretical predictions. The atmospheric neutrinos carry information on the particle physics processes in which they are created and on the neutrinos themselves. These data are relevant for a wide astroparticle and particle physics community. Finally, KM3NeT will monitor marine parameters, such as bioluminescence, currents, water properties and transient acoustic signals and provides user ports for Earth and Sea sciences.
-- 
GitLab