Home

Bienvenue sur le Wiki de Libertempo

Les utilisateurs peuvent accéder au téléchargement et à la documentation de la version stable sur libertempo.tuxfamily.org.

Contribuer

Toutes les contributions sont acceptées et même encouragées. Vous pouvez corriger des traductions, rapporter un bug, proposer une amélioration ou simplement en parler autour de vous.

Bugs

Tout rapport de bug doit être le plus précis possible, il est donc primordial de nous fournir, au minimum :

• système et version,
• version de php,
• version d'apache,
• version de mysql,

plus tout ce que vous jugerez nécessaire pour nous aider à cerner à quoi ressemble votre architecture.

En plus de cela, vous devez nous donner les étapes pour reproduire le bug, précisant bien l'événement produit et l'événement attendu. La raison est très simple, un bug qui n'est pas reproductible ne sera jamais corrigé, car il ne peut pas être corrigé. Donc nous aider à patcher le plus vite possible, c'est vous aider.

Note : le gherkin est un puissant outil pour la rédaction et la compréhension. En tout cas, vous aurez ma gratitude éternelle si vous l'utilisez :-).

Convention de développement

Le projet suit peu ou prou toutes les pratiques de développement actuelles. Chaque contribution doit faire l'objet d'une PR détaillant l'objet des changements apportés, associée autant que possible à un ticket. Toutes les Pull Request doivent viser à être mergée dans develop. Les PR seront mergées aussitôt qu'elles satisfont les tests, revues et que tous les bugs remontés ont été corrigés. Il est interdit de faire une PR sur master qui est et doit rester la branche la plus stable.

Convention de codage

Bien qu'il y ai du code historique, nous cherchons autant que possible à suivre la PSR-2. En quelques mots et pour vous éviter de manger la totalité du guide, il s'agit d'avoir :

• 4 espaces pour les indentations, pas de tabs
• l'accolade { sur la même ligne pour les structures de contrôle (for, while, if, etc.)
• l'accolade sur la ligne suivante pour les méthodes / fonctions / closures
• pas de ?> en fin de fichier
• les attributs, variables, méthodes et fonctions sont en camelCase
• les classes et de fichiers sont en StudlyCaps

Roadmap

Vous trouverez un ticket en guise de roadmap ici. Il a pour but de centraliser tous les projets à long terme de libertempo. Si vous souhaitez vous informer du futur de libertempo ou aider mais ne savez pas par où commencer, ce ticket est fait pour vous.