Pour tout problème contactez-nous par mail : support@froggit.fr | La FAQ :grey_question: | Rejoignez-nous sur le Chat :speech_balloon:

Skip to content
Snippets Groups Projects
Commit a69d5449 authored by Christophe Chaudier's avatar Christophe Chaudier :rocket:
Browse files

Merge branch 'fix-typos' into 'master'

doc: fix typos

See merge request !90
parents 873e9ea2 eee19b9b
No related branches found
No related tags found
1 merge request!90doc: fix typos
Pipeline #9024 passed
......@@ -101,4 +101,4 @@ Portions of this software are licensed as follows:
- The graphic charter (logo, association of colors and fonts) is not under free license and belongs to Oxalis - Lydra.
- All content residing under the "docs/" directory of this repository is licensed under ["Creative Commons: CC BY-SA 4.0 license"](https://creativecommons.org/licenses/by-sa/4.0/).
- Content outside of the above mentioned directories or restrictions above is available under the [MIT license](https://choosealicense.com/licenses/mit/) as defined below.
- Content outside of the above-mentioned directories or restrictions above is available under the [MIT license](https://choosealicense.com/licenses/mit/) as defined below.
......@@ -6,11 +6,11 @@ Les composants sont des extraits de code `.js` ou `.jsx` indépendants et réuti
### Highlight.js
Le composant **Highlight** sert à surligner un élément, en particulier du texte. Il nécéssite les props `color` qui déterminera la couleur du surlignage et `children` qui doit accueillir le texte à surligner.
Le composant **Highlight** sert à surligner un élément, en particulier du texte. Il nécessite les props `color` qui déterminera la couleur du surlignage et `children` qui doit accueillir le texte à surligner.
### TextRight.js
Le composant **TextRight** sert à afficher une image à la gauche de son bloc enfant, avec largeur égale. Il nécéssite les props `img` qui sera l'image à afficher à gauche du bloc enfant et `children` qui sera le bloc enfant d’éléments HTML.
Le composant **TextRight** sert à afficher une image à la gauche de son bloc enfant, avec largeur égale. Il nécessite les props `img` qui sera l'image à afficher à gauche du bloc enfant et `children` qui sera le bloc enfant d’éléments HTML.
### Carousel.js
......@@ -21,7 +21,7 @@ Concernant l'image, il peut s'agir d'un fichier (png, svg, jpeg...) avec le prop
### CarouselLibre.js
Le composant **CarouselLibre** est utilisé sur la page d'accueil pour afficher un carrousel des logiciels libres (FLOSS) utilisés par Froggit, il utilise le composant générique **Carousel**
Le composant **CarouselLibre** est utilisé sur la page d'accueil pour afficher un carrousel des logiciels libres (FLOSS) utilisés par Froggit, il utilise le composant générique **Carousel**.
Afin que les logos de FLOSS unis (par exemple blancs ou noirs) restent bien visibles peu importe le thème, les intégrer en [SVG inline](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/SVG_In_HTML_Introduction) dans le props `svg` et penser à supprimer les valeurs "fill". Cela leur permettra de prendre la couleur du texte selon le thème.
......
......@@ -11,7 +11,7 @@ L'utilisation du Markdown offre un meilleur retour sur investissement car il est
## Créer une page en JavaScript
Pour créer une page en JavaScript, nous allons pouvoir nous appuyer sur de nombreux concepts de programmation introduits par React.js, comme les composants, le JSX (syntaxe utilisé par React) car Docusaurus est basé sur la librairie React.js.
Pour créer une page en JavaScript, nous allons pouvoir nous appuyer sur de nombreux concepts de programmation introduits par React.js, comme les composants, le JSX (syntaxe utilisée par React) car Docusaurus est basé sur la librairie React.js.
Cette section demande des connaissances en JavaScript, et une maîtrise de l'ES6 (voir Pour aller plus loin), une version récente de JavaScript, apportant de nouvelles normes à ce langage, et dont React utilise certains aspects.
......@@ -59,15 +59,15 @@ Nous pouvons désormais nous rendre sur l'URL: http://localhost:3000/new-page-re
Pour de plus amples détails, veuillez consulter la [doc de Docusaurus](https://Docusaurus.io/fr/docs/creating-pages) sur la création de pages.
### Utiliser le TypeScript au lieu de JavaScript?
### Utiliser le TypeScript au lieu de JavaScript ?
Docusaurus permet également de créer des pages TypeScript avec l'extension `.tsx`, en remplacement du JavaScript. Le TypeScript impose un typage fort (le JavaScript étant un langage très peu typé), si une erreur de type apparaît dans le code, TypeScript fera apparaître cette erreur, là où le JavaScript restera permissif.
TypeScript présente des avantages certains en terme de qualité et de sécurité du code, mais il peut être difficile et long à apprendre et à maîtriser sur un framework comme React.
TypeScript présente des avantages certains en termes de qualité et de sécurité du code, mais il peut être difficile et long à apprendre et à maîtriser sur un framework comme React.
Pour installer et configurer TypeScript sur votre projet, consulter la page de [Support TypeScript](https://Docusaurus.io/fr/docs/typescript-support) sur la doc de Docuraurus.
Pour installer et configurer TypeScript sur votre projet, consulter la page de [Support TypeScript](https://Docusaurus.io/fr/docs/typescript-support) sur la doc de Docusaurus.
## Comment créer une page en Markdown?
## Comment créer une page en Markdown ?
Dans le dossier `pages`, nous allons créer un nouveau fichier `/src/pages/new-page-markdown.md` :
......@@ -86,7 +86,7 @@ Comment allez-vous ?
De la même manière, une page sera créée à l'adresse http://localhost:3000/new-page-markdown.
Les pages Markdown sont moins flexibles que les pages React, car elles utilisent toujours la mise en page du thème, mais elles sont bien plus simple et rapide à créer.
Les pages Markdown sont moins flexibles que les pages React, car elles utilisent toujours la mise en page du thème, mais elles sont bien plus simples et rapides à créer.
Voici un [exemple de page Markdown](https://Docusaurus.io/fr/examples/markdownPageExample).
......@@ -97,9 +97,9 @@ Comment ajouter un lien vers une page dans les composants `Navbar` et `Footer`:
Nous allons utiliser le fichier `Docusaurus-config.js`, dans lequel nous pourrons configurer notre `Navbar` et notre `Footer` très facilement.
Nous retrouvons dans ce fichier un objet, nommé `themeConfig` qui permet de définir des valeurs pour la `navbar` et le `footer` au travers d'un tableau d'objets clés / valeurs:
Nous retrouvons dans ce fichier un objet, nommé `themeConfig` qui permet de définir des valeurs pour la `navbar` et le `footer` au travers d'un tableau d'objets clés / valeurs.
Reprenons nos pages précédentes, `new-page-react.js` et `new-page-markdown.js`. Nous pouvons configurer la `navbar` et le `footer` pour créer un lien vers ces pages:
Reprenons nos pages précédentes, `new-page-react.js` et `new-page-markdown.js`. Nous pouvons configurer la `navbar` et le `footer` pour créer un lien vers ces pages :
```themeConfig
......
# Référenciel des liens et ressources pour le projet
# Référentiel des liens et ressources pour le projet
## Un guide pour toi qui code le site
......@@ -7,11 +7,11 @@ Certaines techniques sont utilisées afin de remplacer des éléments, et des pr
**[Docusaurus](https://docusaurus.io/) est la référence de base pour :**
- Utiliser une méthode spécifique pour ajouter/remplacer un éléments.
- Utiliser une méthode spécifique pour ajouter/remplacer un élément.
- Docusaurus dispose d'un large choix d'éléments de création.
- Il est possible d'ajouter des plugins.
_Note: Docusaurus met régulièrement à jour ses versions_
_Note : Docusaurus met régulièrement à jour ses versions_
**[Infima](https://infima.dev/) est la librairie de variables et de composants que Docusaurus utilise**. Cela permet d'ajouter des éléments type bouton, grid, form, puis on leur donne un style au besoin (ça marche comme pour Bootstrap).
......@@ -59,8 +59,8 @@ Cette ressource utilise les couleurs de base d'Infima dans ses cadres et bordure
- [Admonitions](https://docusaurus.io/fr/docs/markdown-features/admonitions)
#### Ajouter des icones avec React
Pour ajouter des icônes, des logo de marques existantes ou encore des pyctogrammes, on utilise la librairie de ressources visuelles dont dispose React.
#### Ajouter des icônes avec React
Pour ajouter des icônes, des logos de marques existantes ou encore des pictogrammes, on utilise la librairie de ressources visuelles dont dispose React.
#### Ressources
- [React Icons](https://react-icons.github.io/react-icons/icons?name=fa)
......
......@@ -8,30 +8,30 @@ Nous allons nous appuyer sur l'utilisation de ces Composants pour créer nos dif
Chaque section de pages va être définie dans un Composant enfant dans le dossier `./src/components/`, puis importée dans un Composant parent dans le dossier `./src/pages/`.
Un composant (_Componant_) contient: des données qui constituent un état (_state_), des comportements et un rendu (l'affichage), ces trois notions vont interagir entre elles.
Un composant (_Component_) contient : des données qui constituent un état (_state_), des comportements et un rendu (l'affichage), ces trois notions vont interagir entre elles.
## Création du composant
Pour l'exemple, nous allons expliquer comment nous avons créer la section chargée d'afficher les fonctionnalités (_Features_) de Froggit.
Pour l'exemple, nous allons expliquer comment nous avons créé la section chargée d'afficher les fonctionnalités (_Features_) de Froggit.
Dans le dossier `src/components/`, nous avons créé un fichier React `HomepageFeatures.js`.
Nous avons choisi de nommer notre fichier `HomepageFeatures`, en [PascalCase](https://techlib.fr/definition/pascalcase.html), car ce composent est destiné à être affiché, dans la `Homepage` (page d'Accueil) et doit afficher les `Features` (fonctionnalités) de Froggit.
Nous avons choisi de nommer notre fichier `HomepageFeatures`, en [PascalCase](https://techlib.fr/definition/pascalcase.html), car ce composant est destiné à être affiché, dans la `Homepage` (page d'Accueil) et doit afficher les `Features` (fonctionnalités) de Froggit.
Ce fichier est composé de 3 parties:
Ce fichier est composé de trois parties :
- une pour gérer les données de notre section ;
- une pour définir les comportements que nous attendons en utilisant différentes fonctions ;
- une pour définir l'affichage. Nous utilisons le JSX pour cette partie, voir l' [introduction au JSX](https://fr.reactjs.org/docs/introducing-jsx.html) sur la doc de React pour des explications sur cette extension syntaxique du JavaScript.
- une pour définir l'affichage. Nous utilisons le JSX pour cette partie, voir l'[introduction au JSX](https://fr.reactjs.org/docs/introducing-jsx.html) sur la doc de React pour des explications sur cette extension syntaxique du JavaScript.
### Les données de notre section
Nous allons créer un tableau d'objets JavaScript pour définir les données à afficher dans notre section. Il y a 3 objets pour chaque élément du tableau :
1. Un titre, de type `chaîne de charactère` (_String_), donc entouré de guillements simples `'` ou doubles `"`).
2. Une description, que nous définissons en tant qu' `Element JSX`. Nous pouvons ainsi lui donner un _template_ de rendu comme valeur, avec les balises HTML de notre choix, juste un paragraphe dans notre cas. Pour cela, nous devons définir sa valeur entre des parenthèses et à l'intérieur d' une balise parent, pouvant être une `div`, ou comme nous utilisons ci-dessous, avec une simple balise vide.
3. Une image, que nous définissons en tant que `Composant React`, afin de simplifier la syntaxe de notre code dans les prochaines étapes notemment pour définir notre affichage. Comme cette image est un composant, nous la nommons `Svg` en PascalCase.
Enfin, nous utilisons ici le format `SVG`, mais nous pouvons utiliser d'autres formats tels que le `PNG`, `GIF` et `JPG`. Mais dans ce cas il faudra installer le plugin officiel de gestion d' [images](https://docusaurus.io/fr/docs/api/plugins/@docusaurus/plugin-ideal-image) pour les formats `PNG` ou `JPG`.
1. Un titre, de type `chaîne de charactère` (_String_), donc entouré de guillemets simples `'` ou doubles `"`).
2. Une description, que nous définissons en tant qu' `Element JSX`. Nous pouvons ainsi lui donner un _template_ de rendu comme valeur, avec les balises HTML de notre choix, juste un paragraphe dans notre cas. Pour cela, nous devons définir sa valeur entre des parenthèses et à l'intérieur d'une balise parent, pouvant être une `div`, ou comme nous utilisons ci-dessous, avec une simple balise vide.
3. Une image, que nous définissons en tant que `Composant React`, afin de simplifier la syntaxe de notre code dans les prochaines étapes notamment pour définir notre affichage. Comme cette image est un composant, nous la nommons `Svg` en PascalCase.
Enfin, nous utilisons ici le format `SVG`, mais nous pouvons utiliser d'autres formats tels que le `PNG`, `GIF` et `JPG`. Mais dans ce cas il faudra installer le plugin officiel de gestion d'[images](https://docusaurus.io/fr/docs/api/plugins/@docusaurus/plugin-ideal-image) pour les formats `PNG` ou `JPG`.
Nous appelons notre tableau `featuresList` car c'est la liste des fonctionnalités.
......@@ -83,16 +83,16 @@ Notre section affichera les 4 éléments, chacune avec un titre, une description
On peut passer des paramètres au composant grâce :
- au propriété de la balise ;
- au texte entre les balises ouvrante et fermantes.
- au texte entre les balises ouvrantes et fermantes.
Pour notre exemple on va créer le compostant `TextRight` avec deux paramètres :
Pour notre exemple, on va créer le compostant `TextRight` avec deux paramètres :
1. une image
2. un bloc de texte
On va utiliser ce composant depuis un fichier MDX.
Le fichier `TextRight.js` se trouve dans le répertoire des composants : `src/components`. Comme on a du CSS exclusif à ce composant on crée un fichier avec la même base de nom :`TextRight.module.css`. Le `.module.css` signifie qu'il apportera des modifications uniquement au fichier `.js` pourtant le même nom, et pas les autres page du site.
Le fichier `TextRight.js` se trouve dans le répertoire des composants : `src/components`. Comme on a du CSS exclusif à ce composant, on crée un fichier avec la même base de nom :`TextRight.module.css`. Le `.module.css` signifie qu'il apportera des modifications uniquement au fichier `.js` pourtant le même nom, et pas les autres pages du site.
#### Le composant
......@@ -120,31 +120,31 @@ export default function TextRight({children, img}) {
D'abord on fait ses imports : React, le module css, et un useBaseUrl.
On utilise `useBaseUrl` pour obtenir l'URL de base du site et pouvoir avoir renvoyer les bonnes URL au HTML sui sera généré. Voir la doc de [Docusaurus](https://docusaurus.io/fr/docs/static-assets#in-jsx).
On utilise `useBaseUrl` pour obtenir l'URL de base du site et pouvoir renvoyer les bonnes URL au HTML qui sera généré. Voir la doc de [Docusaurus](https://docusaurus.io/fr/docs/static-assets#in-jsx).
On exporte la fonction (qui sera importée ensuite dans le fichier mdx). Cette fonction possède deux paramètres :
1. `children`, reprenant les propriétés des "parents" pour les renvoyer en sortie, c'est ce qui se trouve entre les deux balises du composant React.
2. `img` qui contient le chemin relatif de notre image depuis le répertoire` static/` et qui sera passé dans les propriété de la balise ouvrante de notre composant au moment de l'appel.
2. `img` qui contient le chemin relatif de notre image depuis le répertoire` static/` et qui sera passé dans les propriétés de la balise ouvrante de notre composant au moment de l'appel.
La fonction génère du HTML, se qui se trouve dans `return` :
La fonction génère du HTML, ce qui se trouve dans `return` :
- Des "blocks" (`div`) avec des `className` (ou des class en html).
- Pour l'image on utilise le fonction `useBaseUrl` qui renvois l'URL finale de notre `img` (en paramètre).
- Pour notre texte il est contenu dans le paramètre children.
- Pour l'image, on utilise la fonction `useBaseUrl` qui renvois l'URL finale de notre `img` (en paramètre).
- Pour notre texte, il est contenu dans le paramètre children.
Dans le dossier `static/` : mettre l'image en veillant à bien choisir son nom.
#### L'appel du composant
Dans le dossier `src/pages` : on à un fichier [MDX](https://docusaurus.io/fr/docs/markdown-features/react), `communaute.mdx` dans notre exemple.
Dans le dossier `src/pages` : on a un fichier [MDX](https://docusaurus.io/fr/docs/markdown-features/react), `communaute.mdx` dans notre exemple.
Dans notre fichier MDX il faut :
- Importer la fonction `TextRight` depuis le chemin du composant.
- Utiliser le composant avec la nouvelle balise créé `<TextRight>` et `</TextRight>`
Comme par exemple :
Par exemple :
```markdown
import TextRight from '@site/src/components/TextRight';
......@@ -158,11 +158,11 @@ Mon texte
</TextRight>
```
### Attention au multiples CSS
### Attention aux multiples CSS
⚠️ **Remarque: veiller aux erreurs dans les fichiers `custom.css` et `.module.css`.**
⚠️ **Remarque : veiller aux erreurs dans les fichiers `custom.css` et `.module.css`.**
Nous avons constaté que si une classe reçoit des attribues dans le fichier `mon_composant.module.css` et le fichier `custom.css` alors il sera retenu en priorité ce qui se trouve dans le fichier `custom.css` qui est le fichier général de style.
Nous avons constaté que si une classe reçoit des attributs dans le fichier `mon_composant.module.css` et le fichier `custom.css` alors il sera retenu en priorité ce qui se trouve dans le fichier `custom.css` qui est le fichier général de style.
Nous n'avons pas de réponse à la question :
> Est-ce que ce qui se trouve dans le fichier `mon_composant.module.css` s'ajoute à ce qui se trouve dans le fichier `custom.css` ?
......@@ -175,9 +175,9 @@ Nous avons créé une fonction qui renvoie le rendu, grâce à un _template_.
L'utilisation du JSX simplifie cette tâche, nous avons trois parties qui sont les clés issues de notre tableau à afficher.
Tous élément JavaScript doit alors être affiché entre accolade: `{---}` afin d'être correctement interprété.
Tout élément JavaScript doit alors être affiché entre accolade : `{---}` afin d'être correctement interprété.
Notre affichage doit impérativement être entouré de balises parents, telle une `div`.
Notre affichage doit impérativement être entouré de balises parentes, telle une `div`.
Nous passons comme argument les clés de notre tableau (Svg, title, description) à notre fonction
......@@ -269,6 +269,6 @@ Puis nous retrouvons 2 Composants, qui ont été importé depuis le dossier `src
Un Composant peut avoir sa propre feuille de style CSS. Nous donnons le même nom que le fichier de composant au fichier CSS suivi du suffixe `.module.css`.
Un composant peut également utiliser la feuille de style générale `custom.css`. Ce fichier regroupe les attributs de styles standard commun à tous le site.
Un composant peut également utiliser la feuille de style générale `custom.css`. Ce fichier regroupe les attributs de styles standard commun à tout le site.
Chaque feuille de style que l'on souhaite utiliser doit être importé dans le Composant.
......@@ -18,11 +18,11 @@ Pour les couleurs, **Infima** utilise un nuancier sur [Colorbox](https://colorbo
Docusaurus propose une méthode pour personnaliser le thème : c'est le [Swizzling](https://docusaurus.io/fr/docs/swizzling).
On échange un composant de thème généré par Docusaurus, par le notre.
On échange un composant de thème généré par Docusaurus, par le nôtre.
Il en existe deux types :
1. **Éjection** : créer une copie du composant de thème à personnaliser.
2. **Enveloppement** : on améliorer le composant de thème existant.
2. **Enveloppement** : améliorer le composant de thème existant.
### Éjection
......
......@@ -39,7 +39,7 @@ En tant que client de Froggit, vous disposez d’un espace de gestion des client
C'est un sous-groupe du groupe des clients de Froggit. Le nom de ce groupe est l'adresse courriel du client, celui utilisé au moment de la commande, dans lequel tous les caractères spéciaux (`.` et `@`) ont été remplacés par des '_'.
Votre utilisateur GitLab client est ajouté en tant que propriétaire (_owner_) de ce sous-groupe car vous êtes propriétaire de l’abonnement Froggit.
Votre utilisateur GitLab client est ajouté en tant que propriétaire (_owner_) de ce sous-groupe, car vous êtes propriétaire de l’abonnement Froggit.
:::info Exemple
......@@ -52,7 +52,7 @@ C'est un **groupe privé** et seuls les membres de ce groupe peuvent le voir. Vo
:::
:::caution Précision
L'utilisateur [Kermit](https://lab.frogg.it/kermit), notre mascotte administratrice de l'instance est aussi propriétaire (_owner_) de votre **groupe client** car Kermit est le propriétaire du groupe racine `froggit_data`.
L'utilisateur [Kermit](https://lab.frogg.it/kermit), notre mascotte administratrice de l'instance est aussi propriétaire (_owner_) de votre **groupe client**, car Kermit est le propriétaire du groupe racine `froggit_data`.
Il n'est bien sûr pas décompté de votre nombre de sièges.
:::
......@@ -89,7 +89,7 @@ Une couleur indique le remplissage de votre flotte :
- **orange :** entre 81 et 100% ![badge occupation orange](https://img.shields.io/badge/Si%C3%A8ges-81%2F100-orange)
- **rouge :** vous avez dépassé le nombre de sièges de votre abonnement ![badge occupation rouge](https://img.shields.io/badge/Si%C3%A8ges-101%2F100-red)
En cliquant sur ce badge vous vous retrouverez sur votre espace de gestion des sièges de votre **groupe client**.
En cliquant sur ce badge, vous vous retrouverez sur votre espace de gestion des sièges de votre **groupe client**.
:::caution Précision
Votre badge de sièges n'est pas mis à jour instantanément.
......@@ -117,7 +117,7 @@ Le membre va recevoir un courriel l'invitant à créer son compte sur Froggit.
![invite members mail](/img/docs/gestions_des_plans/invite_members_mail.png)
Tant qu'il n’aura pas créé son compte il apparaîtra dans la liste des invitations.
Tant qu'il n’aura pas créé son compte, il apparaîtra dans la liste des invitations.
![invite members pending](/img/docs/gestions_des_plans/invite_members_pending.png)
......@@ -127,7 +127,7 @@ Après avoir créé son compte, l'utilisateur apparaît alors dans la liste des
### Retirer un utilisateur de votre flotte
Pour retirer un membre de votre flotte, il suffit simplement de cliquer sur le bouton `Remove member` à droite de la ligne du membre.
Pour retirer un membre de votre flotte, il suffit de cliquer sur le bouton `Remove member` à droite de la ligne du membre.
![remove members button](/img/docs/gestions_des_plans/remove_members_button.png)
......
......@@ -11,14 +11,14 @@ Tout comme il est possible d'importer un projet depuis GitLab.com ou une autre i
1) Connectez-vous avec votre compte Froggit sur https://lab.frogg.it/groups/new pour créer un nouveau groupe ou un nouveau sous-groupe.
2) Sélectionnez **Import Group**.
![Etapes 1 et 2](/img/docs/migration/step1-2.png)
![Étapes 1 et 2](/img/docs/migration/step1-2.png)
3) Entrez l'URL de l'instance GitLab depuis laquelle vous allez importer vos groupes (cela peut être gitlab.com ou une instance auto-hébergée).
4) Sur l'instance GitLab sur laquelle vous allez importer les groupes : Générez ou copiez un [__personal access token__](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html) avec les __scopes__ `api` et `read_repository`.
5) Copiez le token généré dans le champ associé et sélectionnez **Connect instance**.
![Etapes 3 à 5](/img/docs/migration/step3-5.png)
![Étapes 3 à 5](/img/docs/migration/step3-5.png)
6) Après avoir autorisé l'accès à votre instance GitLab, vous êtes redirigé vers la page d'importation des groupes. Les groupes que vous pourrez importer sont listés.
......@@ -29,5 +29,5 @@ Vous ne pouvez importer que les groupes dont **vous avez le rôle de Owner (prop
:::
7) Par défaut, les espaces de noms (_namespaces_) de groupes proposés correspondent aux noms tels qu'ils existent sur l'instance distante. Cependant, suivant vos permissions, vous pouvez choisir d'éditer les noms des groupes avant leur importation.
![Etapes 6 et 7](/img/docs/migration/step6-7.png)
![Étapes 6 et 7](/img/docs/migration/step6-7.png)
8) À côté des groupes que vous voulez importer, sélectionnez **Import**. L'importation peut prendre un peu de temps et vous en êtes informé en temps réel grâce à la colonne **Status** à côté. Une fois l'importation finie, votre groupe est désormais disponible dans Froggit. Une URL vous est donnée pour accéder au groupe.
......@@ -11,4 +11,4 @@ Mais en attendant, vous pouvez consulter les docs officielles de :
- [GitLab-CI](https://docs.gitlab.com/ee/ci/index.html)
- [GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/index.html)
- [GitLab registre de conteneurs](https://docs.gitlab.com/ee/user/packages/container_registry/index.html)
- [Mattemost](https://docs.mattermost.com/guides/channels.html)
- [Mattermost](https://docs.mattermost.com/guides/channels.html)
......@@ -67,7 +67,7 @@ module.exports = {
href: "https://lydra.fr/category/souverainete-numerique/",
},
{
label: "git kesako ?",
label: "git késako ?",
href: "https://github.com/git-guides/",
},
],
......
......@@ -30,7 +30,7 @@ const FeatureList = [
title: "Les\u00A0Pages\u00A0🔖",
svg: "read-smile.svg",
alt: "Kermit porte des lunettes rondes et lit un livre",
description: "Publier vos sites, blog ou documetation, ou n'importe quel site statique sur nos GitLab pages"
description: "Publier vos sites, blog ou documentation, ou n'importe quel site statique sur nos GitLab pages"
},
{
id: 3,
......
......@@ -17,7 +17,7 @@ Les services sont fournis tels quels et leur utilisation se fait sous votre resp
Vous êtes responsable de la sécurisation de votre compte, dont votre mot de passe ou des autres systèmes de sécurisation ([2FA](https://fr.wikipedia.org/wiki/Double_authentification), [OTP](https://fr.wikipedia.org/wiki/Mot_de_passe_à_usage_unique), etc). Nous ne pourrons être tenus pour responsable de pertes ou dommages liés à une sécurisation trop faible de votre compte.
Nous ne nous engageons pas à un taux précis de disponibilité du service. Cependant nous mettons tout en œuvre, à la mesure de nos moyens, pour que la qualité de service soit la meilleure possible, et remédier aux incidents dans les meilleurs délais. Nous n'endosserons pas la responsabilité des dommages directs ou indirects en cas d'indisponibilité ou d'impossibilité d'accès aux services.
Nous ne sommes pas éditeur des logiciels mis en œuvre, mais hébergeur de ceux-ci. Nous ne serons donc pas tenu pour responsables en cas d'anomalies logicielles (*bugs*), même si cela entraîne la perte ou la corruption de données.
Nous ne sommes pas éditeur des logiciels mis en œuvre, mais hébergeur de ceux-ci. Nous ne serons donc pas tenus pour responsables en cas d'anomalies logicielles (*bugs*), même si cela entraîne la perte ou la corruption de données.
## Législation et propriété intellectuelle
......@@ -25,9 +25,9 @@ Nous sommes uniquement fournisseurs de services et n'exerçons aucun contrôle s
[^LCEN]: conformément à l’[article 6, I, 7 de la Loi n°2004-575](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000042038977) pour la Confiance dans l’Economie Numérique du 21 juin 2004.
L'usage des services doit se faire dans le respect de la loi (française et Européenne) et des réglementations en vigueur ([RGPD](https://www.cnil.fr/fr/reglement-europeen-protection-donnees)). Vous devez aussi respecter la propriété intellectuelle, et nous vous encourageons d'ailleurs à publier sous une Licence Libre[^LicenceLibre].
[^LicenceLibre]: Vous référer à l'[article Wikipedia](https://fr.wikipedia.org/wiki/Licence_libre) pour comprendre ce qu'est une licence libre. Voici quelques exemples : [Creative Commons](https://creativecommons.org), [GPL](http://www.gnu.org/licenses/gpl-3.0.html), [BSD](https://en.wikisource.org/wiki/BSD_License), [Apache](https://www.apache.org/licenses/LICENSE-2.0.html), etc
[^LicenceLibre]: Vous référer à l'[article Wikipédia](https://fr.wikipedia.org/wiki/Licence_libre) pour comprendre ce qu'est une licence libre. Voici quelques exemples : [Creative Commons](https://creativecommons.org), [GPL](http://www.gnu.org/licenses/gpl-3.0.html), [BSD](https://en.wikisource.org/wiki/BSD_License), [Apache](https://www.apache.org/licenses/LICENSE-2.0.html), etc
En cas d'actions non conformes à la loi ou en cas de violation de la propriété intellectuelle, nous déclinons toute responsabilité et nous devons d'agir dans les meilleurs délais suite à tout signalement. Nous pouvons réaliser, potentiellement sans préavis, les actions suivantes selon la gravité, l'urgence et son appréciation propre : gel, clôture ou suppression du ou des comptes, avec notification à minima par courriel.
En cas d'actions non conformes à la loi ou en cas de violation de la propriété intellectuelle, nous déclinons toute responsabilité et nous devons d'agir dans les meilleurs délais suite à tout signalement. Nous pouvons réaliser, potentiellement sans préavis, les actions suivantes selon la gravité, l'urgence et son appréciation propre : gel, clôture ou suppression du ou des comptes, avec notification a minima par courriel.
Pour signaler du contenu abusif ou un compte malveillant, veuillez écrire à l'adresse de signalement indiquée en [page des contacts](/contacts).
......@@ -47,7 +47,7 @@ La rétention de ces données personnelles est réduite au strict nécessaire (l
## Modification des services et des conditions d’utilisation
En cas de modification des Conditions Générales d'Utilisation, vous serez informés à minima par courriel et disposerez d'un droit de rétractation du service en cas de refus des nouvelles conditions. Le refus et la rétractation devront être exprimés par courriel à l'adresse de support (voir [page des contacts](/contacts)).
En cas de modification des Conditions Générales d'Utilisation, vous serez informés a minima par courriel et disposerez d'un droit de rétractation du service en cas de refus des nouvelles conditions. Le refus et la rétractation devront être exprimés par courriel à l'adresse de support (voir [page des contacts](/contacts)).
## Localisation, sécurité et sauvegardes
......
......@@ -10,7 +10,7 @@ keywords: Lydra, SaaS, legal, CGV
[13 août 2021 (Legal version 1.0.0)](https://gitlab.com/lydra/legal/-/releases/1.0.0)
:::
## Préambule : qui sommes nous ?
## Préambule : qui sommes-nous ?
Lydra est une activité collective hébergée par la [SCOP Oxalis SA](https://www.oxalis-scop.fr), 603 Boulevard du Président Wilson 73100 Aix-les-Bains (RCS Chambéry, SIREN 410 829 477, capital de 18500€ au 2 mars 2021).
......@@ -32,13 +32,13 @@ La commande est réalisée sur le site de vente avec paiement ligne immédiat. L
Vous disposez d'un délai de rétractation 30 jours après la date du paiement, sans justification de votre part. La demande de remboursement se fait par courriel à l'adresse de support (voir [page des contacts](/contacts)). Suite à votre rétractation, vous ne disposez plus de votre accès au service, il est donc à votre charge de récupérer l'intégralité de vos données **avant votre rétractation**.
En cas de modification des Conditions Générales de Vente, vous serez informés à minima par courriel et disposerez d'un droit de rétractation du service en cas de refus des nouvelles conditions. Le refus et la rétractation devront être exprimés par courriel à l'adresse de support (voir [page des contacts](/contacts)).
En cas de modification des Conditions Générales de Vente, vous serez informés a minima par courriel et disposerez d'un droit de rétractation du service en cas de refus des nouvelles conditions. Le refus et la rétractation devront être exprimés par courriel à l'adresse de support (voir [page des contacts](/contacts)).
## Article 4 : mise à disposition du service
Nous mettons à votre disposition le service commandé dans les meilleurs délais, dans un délai maximal de 5 jours ouvrés (du lundi au vendredi) sous réserve d'éventuels enregistrements DNS à réaliser par vos soins sur votre nom de domaine.
Les services sont fournis en l'état, et nous ne nous engageons pas à un taux précis de disponibilité. Cependant nous mettons tout en œuvre, dans la mesure de nos moyens, pour que la qualité de service soit la meilleure possible, et remédier aux incidents dans les meilleurs délais.
Les services sont fournis en l'état, et nous ne nous engageons pas à un taux précis de disponibilité. Cependant, nous mettons tout en œuvre, dans la mesure de nos moyens, pour que la qualité de service soit la meilleure possible, et remédier aux incidents dans les meilleurs délais.
Nous n'endosserons pas la responsabilité des dommages directs ou indirects en cas d'indisponibilité ou d'impossibilité d'accès aux services.
......@@ -58,15 +58,15 @@ Malgré tout, [de la documentation](https://support.lydra.eu/help/) est produite
Vous disposez d'un délai de 30 jours pour vous rétracter. Au-delà vous êtes engagé pour la période commandée et ne pouvez exiger le remboursement de votre abonnement, même partiel. Les remboursements sont réalisés dans un délai de 14 jours ouvrés maximum.
En cas de litige, vous êtes tenu d'exprimer votre demande par courriel à l'adresse de support (voir [page des contacts](/contacts) en expliquant votre grief. Si le traitement de votre demande ne vous donne pas satisfaction, vous êtes en droit de demander une médiation dont les modalités seront définies par le tribunal compétent.
En cas de litige, vous êtes tenu d'exprimer votre demande par courriel à l'adresse de support (voir [page des contacts](/contacts) en expliquant votre grief). Si le traitement de votre demande ne vous donne pas satisfaction, vous êtes en droit de demander une médiation dont les modalités seront définies par le tribunal compétent.
## Article 7 : exclusion du service
Vous est libre d'utiliser les services comme bon vous semble, dans le respect des [Conditions Générales d'Utilisation](/CGU), ainsi que de la loi et des réglementations en vigueur (en l'occurrence, la loi française et Européenne, ainsi que [le RGPD](https://www.cnil.fr/fr/reglement-europeen-protection-donnees)).
Vous êtes libre d'utiliser les services comme bon vous semble, dans le respect des [Conditions Générales d'Utilisation](/CGU), ainsi que de la loi et des réglementations en vigueur (en l'occurrence, la loi française et Européenne, ainsi que [le RGPD](https://www.cnil.fr/fr/reglement-europeen-protection-donnees)).
En cas de manquement constaté, nous nous réservons le droit de couper sans préavis vos accès aux services. Nous ne pourrons être tenus pour responsables des actions réalisées par nos clients et agirons dans le respect de la loi.
Dans ce cas, vous en serez informé aussitôt via les outils de communication que vous aurez donné et ne pourrez demander le remboursement de votre abonnement.
Dans ce cas, vous en serez informé aussitôt via les outils de communication que vous aurez donnés et ne pourrez demander le remboursement de votre abonnement.
:::note Sources
[Lydra dépôt git Legal version 1.0.0](https://gitlab.com/lydra/legal/-/blob/1.0.0/CGV.md)
......
......@@ -48,7 +48,7 @@ Le Lab est le cœur de **Froggit** et il sert aussi de base centrale pour l’au
Fournir un outil de collaboration de code sans Intégration Continue n'était pas pensable pour nous.
C'est pour cela que nous avons mis en place une CI avec un serveur et un débordement élastique dans Kubernetes.
Il n’y a **pas de limites** pour le moment chez nous [là ou chez GitLab.com c’est limité à 400 minutes](https://about.gitlab.com/releases/2020/09/01/ci-minutes-update-free-users).
Il n’y a **pas de limites** pour le moment chez nous [là où chez GitLab.com c’est limité à 400 minutes](https://about.gitlab.com/releases/2020/09/01/ci-minutes-update-free-users).
### 💬 Le Chat
......@@ -61,7 +61,7 @@ Pour collaborer les équipes ont besoin de communiquer. Qu'elles soient physique
Vous avez besoin de créer des sites statiques pour vos documentations. C'est pour cela que nous mettons en place les GitLab Pages qui vous permettent d'héberger des sites statiques.
## Où se trouvent les serveurs qui héberge ?
## Où se trouvent les serveurs qui hébergent ?
Toutes nos machines sont **hébergées en France**, chez Scaleway qui a sélectionné **Froggit** dans [son programme Startup](https://www.scaleway.com/fr/programme-startup).
Cela nous permet d’être autonome et de ne pas être soumis au #CloudAct.
......@@ -74,7 +74,7 @@ Nous avons un gros runneur constamment allumé ainsi que des runneurs à débord
## Pouvez-vous garantir que le code reste dans un espace privé à notre société
C’est une instance mutualisée au même titre que https://GitLab.com. C'est le même niveau de sécurité.
Si vous créé un groupe privé pour votre société et que vous y mettez des dépôts privés, seuls les membres de votre groupe verront vos dépôts.
Si vous créez un groupe privé pour votre société et que vous y mettez des dépôts privés, seuls les membres de votre groupe verront vos dépôts.
Il y a une vidéo sur ce sujet sur la chaîne des Compagnons du DevOps.
https://youtu.be/qcHdS7dXwL8
......@@ -83,17 +83,17 @@ Mais à travers nos CGV, CGU et politique de confidentialité, nous nous engageo
Nous avons rédigé ces documents avec des termes compréhensibles, loin du jargon juridique habituel, comme gage de notre transparence.
## Quel espace y a -t-il de disponible pour les artefacts générés ?
On a laisser, pour le moment, la valeur par défaut à 100Mo.
## Quel espace y a-t-il de disponible pour les artefacts générés ?
On a laissé, pour le moment, la valeur par défaut à 100Mo.
Pour le moment on a laissé la valeur par défaut à 100Mo.
Mais on pourra augmenter s’il y a beaucoup de demande clients.
## Avez-vous déjà une idée de la sortie de l'offre stable et des conditions ?
Nous avons prévu la bêta jusqu’à la fin de l’année 2021. Ce qui veut dire que les conditions de l’offre seront communiquées en décembre pour une commercialisation, si tout ce passe bien en janvier 2022.
Nous avons prévu la bêta jusqu’à la fin de l’année 2021. Ce qui veut dire que les conditions de l’offre seront communiquées en décembre pour une commercialisation, si tout se passe bien en janvier 2022.
Pour le moment nous partons sur un abonnement par utilisateur et par mois. Il y aura une offre annuelle avec 2 mois offerts. Nous somme en train d’étudier aussi des offres « pack » avec plusieurs comptes pour les PME.
Pour le moment nous partons sur un abonnement par utilisateur et par mois. Il y aura une offre annuelle avec 2 mois offerts. Nous sommes en train d’étudier aussi des offres « pack » avec plusieurs comptes pour les PME.
Nous aimerions aussi proposer des offres pour les étudiants, les professeurs et les projets en Logiciel Libre.
......@@ -104,7 +104,7 @@ Si vous avez des idées à nous suggérer [vous pouvez remplir notre sondage](ht
Vous ne pourrez pas importer votre instance privée dans **Froggit**.
Il faudra recréer l'arborescence de vos groupes et sous-groupes.
Vous pourrez importer vos projets par URL mais alors seuls le code et les commits seront importés. Tout ce qui touche aux fonctions de base de git en somme.
Vous pourrez importer vos projets par URL, mais alors seuls le code et les commits seront importés. Tout ce qui touche aux fonctions de base de git en somme.
## Quelles sont les mesures de sécurité mises en œuvre de votre côté ?
......@@ -112,7 +112,7 @@ Vous pourrez importer vos projets par URL mais alors seuls le code et les commit
Les ports sont filtrés au niveau du réseau du fournisseur cloud et entre les serveurs.
Le code source de l'infra est développé avec Ansible et Terraform et nous permet de remonter les environnements facilement en cas de problème.
Nous avons 3 environnements : staging, préprod et production.
Nous appliquons les mises à jours des services tous les mois avec une version de retard pour éviter d’essuyer les premiers bugs.
Nous appliquons les mises à jour des services tous les mois avec une version de retard pour éviter d’essuyer les premiers bugs.
Les données des serveurs sont sur des pools LVM avec des disques attachés de type *BlockStorage*. C'est répliqué 3 fois chez Scaleway, autant dire qu’on ne risque pas une corruption de donnée de si tôt.
......@@ -122,9 +122,9 @@ Les sauvegardes sont faites toutes les nuits :
Les snapshots des BlockStorage sont à l'étude pendant la bêta.
En fonctions des retours des bêta testeurs nous améliorerons tous ça bien sûr.
En fonctions des retours des bêta testeurs, nous améliorerons tous ça bien sûr.
Quand nous commercialiserons le service nous ferons une vidéo pour présenter nos choix techniques et pourquoi nous les avons faits.
Quand nous commercialiserons le service, nous ferons une vidéo pour présenter nos choix techniques et pourquoi nous les avons faits.
## Chacun de vos clients aura donc son instance privée (privatisée) de GitLab et Mattermost, et peut-être même des managers de packages Composer, npm, etc. ?
......@@ -143,7 +143,7 @@ Mais aussi un enjeu écologique, en mutualisant une instance nous espérons prop
## Aura-t-on notre propre domaine personnalisé ?
Ce n’est pour le moment pas possible.
Il faudra attendre que nous commercialisation l’offre privée *on-premise*.
Il faudra attendre que nous commercialisons l’offre privée *on-premise*.
Vous pouvez nous contactez si vous êtes pressé : support@froggit.fr
Nous étudierons votre besoin et verrons si nous pourrons y répondre.
......
......@@ -11,7 +11,7 @@ keywords: Lydra, SaaS, legal
Lydra est une activité hébergée par Oxalis SCOP SA.
SOCIETE COOPERATIVE ET PARTICIPATIVE EN SOCIETE ANONYME – SCOP-SA
SCOP créée en 1997, SCOP SA dépuis 2007
SCOP créée en 1997, SCOP SA depuis 2007
Capital social de 18500€ au 2 mars 2021
Société inscrite au Registre du Commerce et des Sociétés de Chambéry sous le n° SIREN 410 829 477
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment