aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-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