New documentation structure

docs/contents/workers/ci/index.md → docs/contents/implem/test/ci.md

@@ -3,9 +3,6 @@
 This page describes how continuous integration (CI) is used in workers created
 using the `base-worker` template.
 
-For more information on creating workers, see
-[Setting up a worker](../create.md).
-
 ## Default template
 
 When creating a worker with our official template, a `.gitlab-ci.yml` file has
@@ -45,8 +42,7 @@ project and validate various rules:
 - Check your YAML files are well formatted
 - Fix some common spelling errors
 
-You can set up pre-commit to run locally too; see
-[Activating the pre-commit hook](../create.md#activating-the-pre-commit-hook).
+You can set up pre-commit to run locally too; see Activating the pre-commit hook.
 
 ## Testing
 
@@ -59,10 +55,6 @@ allowing you to check the validity of your code before merging it.
 Unit tests allow you to prevent regressions in your code when making changes,
 and find bugs before they make their way into production.
 
-<!-- TODO:
-For more information, see [Writing unit tests for your worker](../tests).
--->
-
 ## Building
 
 When the `test` & `lint` jobs run successfully, the `docker` job runs. It will

docs/contents/implem/test/index.md

+# Tests
+
+!!! warning
+
+    This section is under construction.

docs/contents/implem/test/unit.md

+# Unit tests
+
+!!! warning
+
+    This section is under construction.

docs/contents/workers/create.md → docs/contents/init/create.md

@@ -96,8 +96,7 @@ template and making it available on a GitLab instance.
 
 For a worker to be accessible from an Arkindex instance, it needs to be sent
 to a repository on a GitLab project. A GitLab project will also allow you to
-manage different versions of a worker and run
-[automated checks](ci/index.md) on your code.
+manage different versions of a worker and run [automated checks](../implem/test/ci.md) on your code.
 
 #### To create a GitLab project
 
@@ -211,7 +210,7 @@ This section assumes you have Maintainer or Owner access to the GitLab project.
 
 4. Open your GitLab project in a browser.
 
-5. Click on the blue icon indicating that [CI](ci/index.md)
+5. Click on the blue icon indicating that [CI](../implem/test/ci.md)
    is running on your repository, and wait for it to turn green to confirm
    everything worked.
 

docs/contents/init/index.md

+# Initialize your worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/workers/template-structure.md → docs/contents/init/template-structure.md

@@ -7,7 +7,7 @@ package, a Docker build, with the best development practices:
 `.arkindex.yml`
 : YAML configuration file that allows Arkindex to understand what it should do
   with this repository.
-  To learn more about this file, see [YAML configuration](yaml.md).
+  To learn more about this file, see [YAML configuration](../implem/configure/yaml.md).
 
 `.cookiecutter.yaml`
 : YAML file that stores the options you defined when creating a new worker.
@@ -28,7 +28,7 @@ package, a Docker build, with the best development practices:
 `.gitlab-ci.yml`
 : Configures the GitLab CI jobs and pipelines.
   To learn more about the configuration we provide, see
-  [GitLab Continuous Integration for workers](ci/index.md).
+  [GitLab Continuous Integration for workers](../implem/test/ci.md).
 
 `.isort.cfg`
 : Configures the automatic Python import sorting rules.
@@ -50,7 +50,7 @@ package, a Docker build, with the best development practices:
 : Configures the worker's Python package.
 
 `ci/build.sh`
-: Script that gets run by [CI](ci/index.md) pipelines
+: Script that gets run by [CI](../implem/test/ci.md) pipelines
   to build the Docker image.
 
 `tests/test_worker.py`

docs/contents/pick/base.md

+# Base Worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/pick/dataset.md

+# Dataset worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/pick/element.md

+# Element worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/pick/index.md

+# Pick your worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/secrets/index.md

-# Secrets
-
-Secrets are text payloads shared securely between the Arkindex instance and any worker. It is generally used to store sensitive values that may give Arkindex users access to any resources that should be private, for example because they cost money or are proprietary.
-
-For more information about secrets, please visit [the Arkindex documentation](https://doc.arkindex.org/secrets/).

docs/contents/ship/arkindex.md

+# Arkindex execution
+
+!!! warning
+
+    This section is under construction.

docs/contents/ship/index.md

+# Ship your worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/workers/publication.md → docs/contents/ship/publication.md

@@ -2,7 +2,7 @@
 
 ## Publication process
 
-While workers may be [run locally](./run-local.md), they are usually written to launch on an Arkindex instance. A worker version on Arkindex is basically a configuration and a URL towards a Docker image, used at runtime during processes. The worker [template](./template-structure.md) includes an automatic publication process towards any Arkindex instance.
+While workers may be [run locally](../implem/run/local.md), they are usually written to launch on an Arkindex instance. A worker version on Arkindex is basically a configuration and a URL towards a Docker image, used at runtime during processes. The worker [template](../init/template-structure.md) includes an automatic publication process towards any Arkindex instance.
 
 ## How it works
 

docs/contents/tutorials/arkindex_model.md

+# Arkindex model version
+
+!!! warning
+
+    This section is under construction.

docs/contents/tutorials/artifacts.md

+# Use artifacts
+
+!!! warning
+
+    This section is under construction.

docs/contents/tutorials/base.md

+# Base worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/tutorials/dataset.md

+# Dataset worker
+
+!!! warning
+
+    This section is under construction.

docs/contents/tutorials/elements.md

+# Element worker
+
+!!! warning
+
+    This section is under construction.