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
2021-12-01 23:23:47 +01:00

59 lines
3.0 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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: 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/).