Accès direct au contenu Accès direct à la navigation

Soucieux de "bien faire", nous laissons évoluer notre façon de travailler au fil des avancées de notre monde et de ses connaissances. Vous trouverez ici certains points clés ...

  • Le fichier "gitignore"

    23 novembre 2014 , par Les Ateliers  | [en]

    Ce document décrit et commente le contenu du fichier .gitignore que nous utilisons par défaut dans nos paquets.
    Pour plus d’information sur le fichier .gitignore, voyez le site (en anglais).
    Résumé
    Vous trouverez ci-dessous le contenu de notre fichier .gitignore par défaut, que nous utilisons dans chacun de nos paquets. Un fichier d’exemple est inclus dans notre dépôt de référence à l’adresse commons/gitignore.txt.
    # OS & software files .DS_Store .AppleDouble .LSOverride .Spotlight-V100 (...)

  • Chemins d’installation d’un script sous les systèmes UNIX

    23 novembre 2014 , par Les Ateliers  | [en]

    Ce document décrit comment et où installer des commandes "tiers" sous les systèmes UNIX. Par "tiers" nous entendons "non-distribuées nativement" ou "développées par un type dans son garage" ; les procédures et chemins utilisés ici ne concernent PAS les commands internes du système et ne sont PAS officiels. Il s’agit simplement d’une revue générale des usages communs.
    Par utilisateur, pour tous les utilisateurs ou global
    Lorsqu’on utilise un système UNIX, nous devons garder à l’esprit les différents (...)

  • Règles de codage et de nommage

    26 septembre 2014 , par Les Ateliers  | [en]

    Ce document développe les règles de codage, de rangement et de nommage de nos paquets.
    Standards de programmation & règles de nommage
    Afin de construire un code maintenable et comprehensible, nous essayons de suivre les règles standrads en usage :
    les standards de code PEAR
    les standards du PHP Framework Interoperability Group.
    Sachant cela, les classes de nos paquets sont nommées et organisées selon une architecture facilitant l’utilisation de la classe standard SplClassLoader, si (...)

  • Règles de déploiement

    26 septembre 2014 , par Les Ateliers  | [en]

    Ce document développe nos méthodes de déploiement de paquets, un nouveau tag de version et, plus généralement, comment gérer un paquet GIT en évitant les erreurs communes.
    Toutes les procédures décrites ici sont automatisées dans notre outil Dev Tools.
    Nettoyer un dépôt
    La première chose à faire avant de commiter ou de créer un nouveau tag de version est de s’assurer que tous les fichiers à commiter ou qui seront ajoutés au tag sont souhaités et présentent des droits UNIX corrects.
    Pour nettoyer les (...)

  • Règles des "Changelog"

    26 septembre 2014 , par Les Ateliers  | [en]

    Ce document développe les règes que nous suivons aux Ateliers pour rédiger les fichiers "Changelog" (liste des évolutions) et nos messages de commit.
    Un script shell est proposé avec les outils de Console de notre dépôt de référence.
    Messages de commit
    Nos messages de commit DOIVENT être rédigés en anglais et suivre la construction suivante :
    A short title for the commit changes (less than 80 characters)
    And, after a blank line, the full description of the changes, that can be ...
    ... on (...)