Unverified Commit 38bc52fa authored by Antoine Eiche's avatar Antoine Eiche
Browse files

documentation: various improvments

parent 023da947
......@@ -13,8 +13,7 @@ Markas <https://documentation.markas.fr/utiliser.html>`_.
Rendez-vous sur `<https://cloud.markas.fr>`_ pour la création d'un compte!
L'infrastructure markas.fr est actuellement en version beta. Nous
n'assurons actuellement **aucune sauvegarde**. À tout moment, une
panne matérielle du serveur pourrait corrompre vos données.
devons encore définir les CGU, et migrer vers un serveur plus adapté.
Contribuer
......
.account p a {
color: white;
font-size: large;
}
.account p {
padding: 10px;
}
.account {
text-align: center;
background-color: rgb(106, 176, 222);
}
......@@ -60,6 +60,11 @@ html_theme = 'sphinx_rtd_theme'
source_suffix = ['.rst', '.md']
html_static_path = ['_static']
html_css_files = [
'css/custom.css',
]
html_context = {
'source_url_prefix': "https://framagit.org/markas/infrastructure/-/blob/master/docs/",
}
......
......@@ -36,6 +36,8 @@ in pkgs.stdenv.mkDerivation {
buildPhase = ''
cp ${infra} infra.json
cp ${sources} sources.json
mkdir -p _static/css/
cp ${./_static/css/custom.css} _static/css/custom.css
# Workaround for https://github.com/sphinx-doc/sphinx/issues/3451
export SOURCE_DATE_EPOCH=$(${pkgs.coreutils}/bin/date +%s)
SPHINXOPTS=-W make html
......
......@@ -26,7 +26,7 @@ Système d'exploitation
~~~~~~~~~~~~~~~~~~~~~~
Nous utilisons la distribution NixOS en version |nixpkgs-branch|. La révision
NixOS actuellement déployé est |nixpkgs-url|_. Nous configurons ensuite cette
NixOS actuellement déployée est |nixpkgs-url|_. Nous configurons ensuite cette
distribution pour l'adapter à nos besoins. La révision de la configuration
Markas actuellement déployée est |repository-revision|_.
......@@ -47,7 +47,7 @@ Politique de sécurité
~~~~~~~~~~~~~~~~~~~~~
TODO: expliquer que l'on fait des mises à jour régulièrement, qu'on
limite les accès admin, que l'on ne fait pas de backup...
limite les accès admin...
Contributeurs
~~~~~~~~~~~~~
......@@ -67,6 +67,13 @@ Les services d'infrastructures
Afin d'assurer le bon fonctionnement des services utilisateurs, des
services d'infrastructures sont nécessaires.
Sauvegarde
~~~~~~~~~~
Une sauvegarde chiffrée est envoyée tous les jours à 4h du matin sur
le serveur `kordia.abesis.fr`. Ces sauvegardes sont réalisées par le
logiciel `Borg <https://borgbackup.readthedocs.io/en/stable/>`_.
Monitoring et alerting
~~~~~~~~~~~~~~~~~~~~~~
......
......@@ -6,13 +6,15 @@ nos libertés, nos données personnelles et notre vie privée. Les
services proposés sont détaillés dans le :ref:`guide d'utilisation
<utiliser>` de Markas.
Rendez-vous sur `<https://cloud.markas.fr>`_ pour la création d'un compte!
.. warning::
L'infrastructure markas.fr est actuellement en version beta. Nous
n'assurons actuellement **aucune sauvegarde**. À tout moment, une panne
matérielle du serveur pourrait corrompre vos données.
devons encore définir les CGU, et migrer vers un serveur plus
adapté.
.. container:: account
:ref:`Créer un compte utilisateur <compte>`
Nos motivations: pourquoi Markas?
......
......@@ -3,23 +3,29 @@
Guide d'utilisation
-------------------
Les services numériques de Markas
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. _compte:
Création d'un compte utilisateur
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Nous fournissons des services permettant de partager des fichiers et
gérer des agendas en ligne. Ces services sont basés sur le logiciel
libre `Nextcloud <https://nextcloud.com/>`_.
Création d'un compte utilisateur
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. warning::
L'infrastructure markas.fr est actuellement en version beta. Nous
n'assurons actuellement **aucune sauvegarde**. À tout moment, une panne
matérielle du serveur pourrait corrompre vos données.
devons encore définir les CGU et migrer vers un serveur plus
adapté.
Les CGU n'était pour l'instant pas définies, les administrateurs
peuvent actuellement arbitrairement décider
- d'accepter ou non une demande de création d'un nouveau compte
- de supprimer un compte existant
Pour créer un compte:
Pour se créer un compte:
1. Rendez-vous https://cloud.markas.fr
2. Cliquer sur `S'enregistrer`
......@@ -29,7 +35,7 @@ Pour créer un compte:
6. Votre compte doit désormais être activé par un administrateur qui
confirmera la création de votre compte
Une fois votre compte activé, vous pourrez vous authentifier
Une fois votre compte activé, vous pourrez vous authentifier sur
https://cloud.markas.fr.
Services disponibles
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment