1
0
mirror of https://gitlab.com/free_zed/free_zed.gitlab.io.git synced 2024-06-09 11:52:31 +00:00
free_zed.gitlab.io/content/gitlab-team-organisation-code-reuse-documentation-and-collaboraton.md

59 lines
3.0 KiB
Markdown
Raw Permalink Normal View History

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
2021-04-22 23:03:43 +00:00
Tags: forga, 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/).