aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorAdam Janovsky2022-04-26 11:41:58 +0200
committerAdam Janovsky2022-04-26 11:41:58 +0200
commit8e7a3d8a172f62e13833f4d033b52e0cd38d66f6 (patch)
tree6979f32ef8e05dd51ace4913111603cd45f8ebb2
parentac4dc0e7b5fa977103e63f955a92c99010e2a8b5 (diff)
downloadsec-certs-8e7a3d8a172f62e13833f4d033b52e0cd38d66f6.tar.gz
sec-certs-8e7a3d8a172f62e13833f4d033b52e0cd38d66f6.tar.zst
sec-certs-8e7a3d8a172f62e13833f4d033b52e0cd38d66f6.zip
populate docs structure
-rw-r--r--docs/index.md14
-rw-r--r--docs/installation.md3
-rw-r--r--docs/quickstart.md3
-rw-r--r--docs/tutorial.md3
-rw-r--r--docs/web_dashboard.md3
5 files changed, 22 insertions, 4 deletions
diff --git a/docs/index.md b/docs/index.md
index b88dd91c..8c43766c 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,16 +1,22 @@
# Sec-certs documentation
-The documentation currently does not have all modules documented with `autodoc`. Most of the API showcases are documented in the *notebooks* examples below. If you want, you can run the notebooks. They are stored in the [project repository](https://github.com/crocs-muni/sec-certs/tree/main/notebooks).
+![](_static/logo.svg)
-## Notebooks
+There are three main parts of this documentation. *User's guide* describes high-level use of our tool. Driven by this knowledge, you can progress to *Notebook examples* that showcase most of the API that we use in the form of Jupyter notebooks. The documentation currently does not have all modules documented with `autodoc`, so for the API reference, you must directly inspect the [sec_certs](https://github.com/crocs-muni/sec-certs/tree/main/sec_certs) module. If you want, you can run the notebooks as they are stored in the [project repository](https://github.com/crocs-muni/sec-certs/tree/main/notebooks). If you are interested in contributing to our project or in other aspects of our development, you can consult the relevant *GitHub artifacts*
+
+```{toctree}
+:caption: User's guide
+installation.md
+quickstart.md
+tutorial.md
+web_dashboard.md
+```
```{toctree}
:caption: Notebook examples
notebooks/dataset.ipynb
```
-## GitHub artifacts
-
```{toctree}
:maxdepth: 2
:caption: GitHub artifacts
diff --git a/docs/installation.md b/docs/installation.md
new file mode 100644
index 00000000..0e6c025a
--- /dev/null
+++ b/docs/installation.md
@@ -0,0 +1,3 @@
+# Installation
+
+TBA \ No newline at end of file
diff --git a/docs/quickstart.md b/docs/quickstart.md
new file mode 100644
index 00000000..b40bab01
--- /dev/null
+++ b/docs/quickstart.md
@@ -0,0 +1,3 @@
+# Quickstart
+
+TBA \ No newline at end of file
diff --git a/docs/tutorial.md b/docs/tutorial.md
new file mode 100644
index 00000000..47e78870
--- /dev/null
+++ b/docs/tutorial.md
@@ -0,0 +1,3 @@
+# Tutorial
+
+TBA \ No newline at end of file
diff --git a/docs/web_dashboard.md b/docs/web_dashboard.md
new file mode 100644
index 00000000..a5909db3
--- /dev/null
+++ b/docs/web_dashboard.md
@@ -0,0 +1,3 @@
+# Web dashboard
+
+TBA \ No newline at end of file