Docs reorganise

README.md

@@ -87,15 +87,23 @@ Usage: virtualship init [OPTIONS] PATH
 
   Initialize a directory for a new expedition, with an expedition.yaml file.
 
-  If --mfp-file is provided, it will generate the expedition.yaml from the MPF
-  file instead.
+  If --mfp-file is provided (and --start-date is also provided), it will
+  generate the expedition.yaml from the MPF file instead.
 
 Options:
-  --from-mfp TEXT  Partially initialise a project from an exported xlsx or csv
-                   file from NIOZ' Marine Facilities Planning tool
-                   (specifically the "Export Coordinates > DD" option). User
-                   edits are required after initialisation.
-  --help           Show this message and exit.
+  --from-mfp TEXT                 Initialise a project from an exported xlsx
+                                  file from NIOZ' Marine Facilities Planning
+                                  tool (specifically the "Export Cruise Data"
+                                  option). User edits may be required after
+                                  initialisation.
+  --start-date [%Y-%m-%d %H:%M:%S|%Y-%m-%d]
+                                  The departure/start date of the expedition
+                                  (required when using --from-mfp). Expected
+                                  format: 'YYYY-MM-DD HH:MM:SS' (with quotes,
+                                  e.g., '2023-10-20 01:00:00'). If only the
+                                  date is provided, the time will default to
+                                  00:00:00.
+  --help                          Show this message and exit.
 ```
 
 ```console

docs/conf.py

@@ -15,6 +15,7 @@
     "sphinx.ext.napoleon",
     # "sphinx_autodoc_typehints",# https://github.com/Parcels-code/virtualship/pull/125#issuecomment-2668766302
     "sphinx_copybutton",
+    "sphinx_design",
 ]
 
 source_suffix = [".rst", ".md"]
@@ -44,6 +45,7 @@
             "type": "fontawesome",
         }
     ],
+    "announcement": "<strong>Warning</strong>: this is a pre-release version of the VirtualShip documentation (V1 to be released in September/October 2026). The contents are subject to change and may not be complete.",
 }
 html_context = {
     "github_user": "Parcels-code",
@@ -70,20 +72,23 @@
 always_document_param_types = True
 
 nbsphinx_thumbnails = {
+    "user-guide/quickstart": "user-guide/_images/AnnaWeber.jpeg",
+    "user-guide/tutorials/index": "user-guide/_images/AnnaWeber.jpeg",
     "user-guide/assignments/Research_proposal_intro": "user-guide/_images/MFPtimeline.jpg",
     "user-guide/assignments/Research_Proposal_only": "user-guide/_images/MFP.jpg",
     "user-guide/assignments/Virtualship_research_proposal": "user-guide/_images/AnnaWeber.jpeg",
     "user-guide/assignments/sciencecommunication_assignment": "user-guide/_images/marine_ss.jpg",
-    "user-guide/assignments/Sail_the_ship": "user-guide/_images/freepik_research_vessel.jpg",
+    "user-guide/assignments/sail_the_ship": "user-guide/_images/freepik_research_vessel.jpg",
     "user-guide/assignments/Code_of_conduct": "user-guide/_images/freepik_code_of_conduct.jpg",
     "user-guide/teacher-content/ILOs": "user-guide/_images/ILOs.jpg",
     "user-guide/teacher-content/UU-ocean-of-future/Tutorial1": "user-guide/_images/freepik_assignment.png",
     "user-guide/teacher-content/UU-ocean-of-future/Tutorial2": "user-guide/_images/freepik_assignment.png",
     "user-guide/tutorials/surf_collaborative_setup": "user-guide/_images/freepik_research_vessel.jpg",
     "user-guide/tutorials/surf_research_cloud_setup": "user-guide/_images/freepik_research_vessel.jpg",
     "user-guide/tutorials/working_with_expedition_yaml": "user-guide/_images/AnnaWeber.jpeg",
-    "user-guide/teacher-content/UU-dyoc/example_expedition": "user-guide/_images/AnnaWeber.jpeg",
-    "user-guide/teacher-content/UU-dyoc/file_permissions": "user-guide/_images/AnnaWeber.jpeg",
+    "user-guide/tutorials/codespaces_guide": "user-guide/_images/AnnaWeber.jpeg",
+    "user-guide/tutorials/binder_guide": "user-guide/_images/AnnaWeber.jpeg",
+    "user-guide/user-profiles/educators/letter": "user-guide/_images/freepik_research_vessel.jpg",
 }
 
 sphinx_gallery_conf = {"default_thumb_file": "_static/virtual_ship_logo.png"}