✨ Add realisation: Get organized with GitLab

content/gitlab-team-organisation-code-reuse-documentation-and-collaboraton-en.md

@@ -0,0 +1,58 @@
+Title: Get organized with GitLab
+Date: 2020-09-15 01:10
+Summary: The goal of this group is to provide an organization that facilitates code reuse, documentation and collaboration
+Category: Réalisations
+Tags: django, python, packaging, pip, ci, cd, git, dry, gitlab, agile, méthode, collectif, dev, devops, statique, gitlab-pages, web, mkdocs
+Status: Published
+Lang: en
+Slug: gitlab-team-organisation-code-reuse-documentation-and-collaboraton
+
+
+💡 What's the idea ?
+==================
+
+The [`forga`](https://gitlab.com/forga/) group ([`https://gitlab.com/forga/`](https://gitlab.com/forga/)) aims to provide an organization that facilitates :
+
+- ♻️ the reuse of code;
+- 📝 documentation (of code or anything else);
+- 🤝 collaboration;
+
+[![Tree view for `forga` group]({static}/img/forga-tree-s.jpg)](https://gitlab.com/forga/)
+
+It uses the [groups](https://docs.gitlab.com/ce/user/group/)/[subgroups](https://docs.gitlab.com/ce/user/group/subgroups/), [pages](https://about.gitlab.com/stages-devops-lifecycle/pages/), and other _GitLab_ features to enable organization :
+
+- of `git` repositories grouped by usage (in a tree structure);
+- batch user access management;
+- semantic URLs for static documentation web pages;
+
+The content deals with development in a Python & Django context, but any kind of language/_framework_ will find its place there.
+
+
+⚠️ Warning
+----------
+
+It is an experimental project under development.
+
+Some aspects have been set up in a professional context, others are personal experiments.
+
+
+📦 What's in it ?
+=================
+
+1. an [mentorship tool](https://gitlab.com/forga/process/fr/embarquement/) for new users (French version for Python/Django/UML);
+1. a [single source of documentation](https://forga.gitlab.io/process/fr/manuel/)· _le Manuel_ (French version);
+1. some [Django](https://www.djangoproject.com/) packages:
+    - a [bootstrap project](https://gitlab.com/forga/tool/django/core/);
+    - an [application directly installable with `pip`](https://gitlab.com/forga/tool/django/one_to_one/);
+1. a [customer project](https://gitlab.com/forga/customer/acme/) reusing the Django packages above;
+1. [third-party projects](https://gitlab.com/forga/devel/third-party/) used internally;
+
+And if not, you can always [visit the group URL](https://gitlab.com/forga/) and scroll down the contents of the subgroups to get an idea.
+
+
+🤝 Want to contribute ?
+======================
+
+With pleasure!
+
+There are some conventions ([git](https://forga.gitlab.io/process/fr/manuel/convention/git/) & [python](https://forga.gitlab.io/process/fr/manuel/convention/python/)) presented in [the manual](https://forga.gitlab.io/process/fr/manuel/) and a [code of conduct](https://forga.gitlab.io/process/fr/manuel/human/code-of-conduct/).

content/gitlab-team-organisation-code-reuse-documentation-and-collaboraton.md

@@ -0,0 +1,58 @@
+Title: S'organiser avec GitLab
+Date: 2020-09-15 01:10
+Summary: Ce groupe a pour objectif de proposer une organisation facilitant la réutilisation de code, la documentation et la collaboration
+Category: Réalisations
+Tags: django, python, packaging, pip, ci, cd, git, dry, gitlab, agile, méthode, collectif, dev, devops, statique, gitlab-pages, web, mkdocs
+Status: Published
+Lang: fr
+Slug: gitlab-team-organisation-code-reuse-documentation-and-collaboraton
+
+
+💡 C'est quoi l'idée ?
+=====================
+
+Le groupe [`forga`](https://gitlab.com/forga/) ([`https://gitlab.com/forga/`](https://gitlab.com/forga/)) a pour objectif de proposer une organisation facilitant :
+
+- ♻️ la réutilisation de code;
+- 📝 la documentation (de code ou d'autre chose);
+- 🤝 la collaboration;
+
+[![Vue arborescente du groupe `forga`]({static}/img/forga-tree-s.jpg)](https://gitlab.com/forga/)
+
+Il utilise les [groupes](https://docs.gitlab.com/ce/user/group/)/[sous-groupes](https://docs.gitlab.com/ce/user/group/subgroups/) , les [`pages`](https://about.gitlab.com/stages-devops-lifecycle/pages/), et d'autres fonctionnalités de _GitLab_ pour permettre l'organisation :
+
+- de dépôts `git` rassemblé par usages (dans une arborescence);
+- de la gestion des accès utilisateurs en lot;
+- d'URLs sémantiques pour les pages web statiques de documentation;
+
+Le contenu traite du développement dans un contexte Python & Django, mais tout type de language/_framework_ y trouvera sa place.
+
+
+⚠️ Avertissement
+-----------------
+
+C'est un projet expérimental en cours de développement.
+
+Certains aspects ont été mis en place dans un contexte professionnel, d'autres sont des expérimentations personnelles.
+
+
+📦 Qu'est ce qu'il y a dedans ?
+===============================
+
+1. un [outil de mentorat](https://gitlab.com/forga/process/fr/embarquement/) des nouveaux utilisateur·ice·s (orienté Python/Django/UML);
+1. une [source de documentation unique](https://forga.gitlab.io/process/fr/manuel/) : _le manuel_;
+1. des paquets [Django](https://www.djangoproject.com/) :
+    - un [démarrage rapide](https://gitlab.com/forga/tool/django/core/);
+    - une [application installables directement avec `pip`](https://gitlab.com/forga/tool/django/one_to_one/);
+1. un [projet client](https://gitlab.com/forga/customer/acme/) réutilisant les paquets Django mentionnés ci-dessus;
+1. des [projets tiers](https://gitlab.com/forga/devel/third-party/) utilisé en interne;
+
+Et sinon vous pouvez toujours [visiter l'URL du groupe](https://gitlab.com/forga/) et dérouler le contenus des sous-groupes pour vous faire une idée.
+
+
+🤝 Envie de contribuer ?
+=======================
+
+Avec plaisir !
+
+Il y a quelques conventions ([git](https://forga.gitlab.io/process/fr/manuel/convention/git/) & [python](https://forga.gitlab.io/process/fr/manuel/convention/python/)) présentées dans [le manuel](https://forga.gitlab.io/process/fr/manuel/) ainsi qu'un [code de conduite](https://forga.gitlab.io/process/fr/manuel/human/code-of-conduct/).