Lab pratique
lab-outils
Lancement de votre parcours de développeur
Ce laboratoire vous plonge dans l’univers du développement en vous familiarisant avec les outils essentiels. Vous allez installer votre environnement de travail, configurer votre ordinateur et découvrir des extensions utiles pour Visual Studio Code.
A la fin de ce parcours, vous aurez créé un site web simple pour suivre l’avancement de votre projet de fin de formation.
1. Préparez votre ordinateur
- Windows 10 ou plus récent: Assurez-vous d’avoir une version récente de Windows installée.
- Configuration développeur: Optimisez Windows pour le développement en installant les mises à jour et en activant les fonctionnalités nécessaires.
- Visual Studio Code: Installez cet éditeur de code open source très populaire parmi les développeurs.
2. Enrichissez votre environnement de développement
- Correcteur d’orthographe: Installez l’extension “Code Spell Checker” pour vérifier l’orthographe et la grammaire de votre code.
- Gestionnaire de tâches: Installez l’extension “Todo Tree” pour organiser vos tâches et listes de choses à faire.
- Edition d’images: Installez une extension comme ImageMagick ou GIMP pour manipuler des images dans votre code.
3. Mini-projet: Site web de suivi de projet
Objectif: Développez un site web simple pour suivre l’avancement de votre projet de fin de formation.
Étape 1: Définir votre projet
- Choisissez un sujet: Sélectionnez un projet qui vous motive et correspond à vos objectifs d’apprentissage.
- Découpage en étapes: Divisez votre projet en étapes gérables, chacune avec des objectifs et des livrables clairs.
Étape 2: Création du site web
- Fichiers HTML: Créez un fichier HTML minimaliste pour chaque étape, listant les tâches à accomplir. Omettez le CSS pour l’instant.
- Fichier CSS: Créez un fichier CSS pour styliser l’apparence de vos pages HTML.
- Tâches Todo: Ajoutez des instructions Todo dans chaque fichier HTML pour chaque tâche, en utilisant des commentaires ou des extensions dédiées.
- Organisation des fichiers: Rassemblez vos fichiers dans un dossier nommé “docs”.
Étape 3: Déploiement et partage
- Dépôt GitHub: Créez un référentiel GitHub et déposez-y l’ensemble de vos fichiers.
- GitHub Pages: Configurez GitHub Pages pour déployer vos pages HTML et les rendre accessibles en ligne.
- Partagez votre site web: Présentez le lien de votre site web à d’autres personnes pour leur montrer votre progression.
Félicitations !
Vous avez franchi vos premiers pas dans le monde du développement ! Ce site web vous servira de base pour suivre l’avancement de votre projet de fin de formation. N’hésitez pas à l’enrichir et à le personnaliser au fil de votre progression.
Lab - Rédiger une documentation technique claire et efficace avec le code
Importance de la documentation
Les atouts du code pour sa rédaction
Le code : un outil puissant pour documenter les applications
De nombreux développeurs privilégient le code aux interfaces graphiques (IG) pour documenter les applications logicielles. Ce choix s’explique par plusieurs avantages considérables :
- Facilité de modification : Les fichiers texte offrent une flexibilité et une précision accrues lors de la modification du contenu.
- Gestion aisée des versions : Les systèmes de contrôle de version facilitent le suivi des modifications et la restauration de versions antérieures.
- Automatisation des tâches : Le code peut être automatisé pour rationaliser les tâches répétitives.
- Documentation claire et concise : Markdown et PlantUML permettent de créer une documentation claire et informative à l’aide de fichiers texte simples.
- Portabilité : Le code est indépendant de la plateforme et peut être exécuté sur différents systèmes.
Une documentation complète : un atout majeur pour les applications logicielles
Au-delà des avantages du code, une documentation complète procure de nombreux bénéfices :
- Communication claire et fluide : Elle facilite la communication entre les utilisateurs, les développeurs et les parties prenantes.
- Maintenance aisée et évolutivité : Elle permet une maintenance simplifiée et une évolution future de l’application.
- Réduction des coûts : Elle réduit les coûts et les délais liés au débogage et à l’ajout de fonctionnalités.
- Apprentissage et formation simplifiés : Elle facilite l’apprentissage et la formation des nouveaux utilisateurs et développeurs.
- Préservation des connaissances : Elle préserve les connaissances acquises et assure la continuité du savoir-faire.
La documentation : un élément crucial pour la réussite d’une application
La documentation d’une application informatique est essentielle pour sa réussite. En utilisant le code et des outils adaptés, les développeurs peuvent créer une documentation claire, efficace et maintenable, garantissant ainsi la longévité et la valeur de l’application.
Objectif: Réaliser une documentation claire et professionnelle pour votre projet de fin de formation en utilisant GitHub Pages et Jekyll, avec des diagrammes PlantUML et Mermaid.
Compétences:
- Maîtrise du projet et des technologies employées
- Git
- Markdown, PlantUML et Mermaid
- Jekyll et GitHub Pages
Déroulement:
- Analyse du projet: Identifiez les fonctionnalités, utilisateurs et objectifs.
- Définition du périmètre: Déterminez les éléments à documenter.
- Rédaction:
- Structurez la documentation de manière claire et logique.
- Rédigez des instructions détaillées et précises pour chaque fonctionnalité.
- Intégrez des captures d’écran, diagrammes et exemples de code.
- Utilisez Markdown et PlantUML pour créer une documentation visuelle.
- Réalisez des diagrammes explicites avec PlantUML et Mermaid.
- Mise en ligne:
- Créez un référentiel GitHub pour le projet et configurez-le pour héberger la documentation.
- Installez Jekyll et configurez-le pour générer la documentation à partir des fichiers Markdown.
- Test et validation: Testez la documentation sur différents navigateurs et appareils.
- Amélioration et finalisation: Révisez la documentation en tenant compte des commentaires et apportez les modifications nécessaires.