Ce manuel est le manuel de référence, ou le manuel pour programmeur, de Hoa. Il explique pas à pas comment fonctionnent les différents paquetages, avec des exemples, des illustrations etc. C'est un guide détaillé pour bien comprendre les outils que l'on manipule. On y trouve également de nombreuses ressources liées aux paquetages.

Ce manuel est écrit pour tous les utilisateurs de Hoa (programmeurs ou non, débutants ou professionnels). Si les explications sont techniques, alors elles seront détaillées au maximum. De nombreux liens devraient également être présents pour combler les lacunes du lecteur, dans le cas où le sujet n'est pas connu dans sa totalité.

Hoa a officiellement démarré le 1 janvier 2007, avec la publication du premier paquetage XML publié sur PHPClasses sous le conseil de Jean Molliné (Cyrano chez PHPFrance). Ce paquetage a été élu second meilleur paquetage de sa catégorie et n'a pas bougé de place depuis. La réaction la plus courante était la facilité d'utilisation, pari gagné.

Je me suis tout d'abord lancé dans Hoa pour apprendre. J'ai toujours aimé apprendre et quoi de mieux qu'un framework pour couvrir différents domaines et les approfondir au maximum ? J'ai donc pris sur mes temps libres pour lire des manuels, des documentations, des spécifications, des normes, des standards etc., et au fil des mois, la liste des paquetages grandissait. Jusqu'au jour où j'ai pris un peu de recul et que je me suis rendu compte que j'avais là un tout petit framework.

Après moult péripéties, un passage de PHP 4 à 5, l'intégration d'un MVC, et toujours plus de documentations au compteur, j'ai pensé qu'il serait intéressant de publier le framework. C'est chose faite le 2 février 2008, soit 1 an, 1 mois et 1 jour plus tard (ce n'est pas un hasard).

Bien sûr il est encore incomplet car en version bêta, mais j'ai appris énormément et apprends toujours autant. Les projets ne sont pas les mêmes tout comme les contraintes, mais ça devient de plus en plus intéressant et ma soif de savoir ne tarie toujours pas.

Histoire à suivre ;-).

Ce manuel décrit le comportement et l'utilisation de tous les paquetages présents dans Hoa. Chaque chapitre correspond donc à un paquetage du framework, chacun étant découpé en sections, qui correspondent au raisonnement effectué.

Donc, contre toutes attentes, le chapitre 1 ne constitue pas le début de lecture du manuel. On trouve un paquetage par chapitre, ces paquetages étant triés par ordre alphabétique. La lecture du manuel se fait donc en fonction du paquetage que l'on souhaite étudier.

Les adresses pour accéder aux différents chapitres se veulent le plus simple possible ; on le remarquera en parcourant le manuel.

Le manuel est en cours d'écriture, il évolue donc constamment. Une nouvelle version est proposée environ tous les mois. Cette partie changera une fois le manuel écrit quasi-totalement.