Documentation : point au 5 juin

ineation's picture

Quelques statistiques d'activité sur le wiki :
* 3 contributeurs sur les 7 derniers jours : Arnaud, Webastien et un anonyme
* La page index complètement spammée...
* En tout près de 3000 mots pour le manuel des débutants
* Seul le chapitre 1 "Avant de Commencer" a été bien avancé

Bref ya encore beaucoup de travail :
* Gros travail de relecture, correction, homogénéisation du chapitre 1
* Et surtout il faut s'atteler aux chapitres suivants

Voilà, je vous laisse j'y retourne...

Groupes:
Login to post comments

J'ai rédigé une

Haza's picture
Haza - Jeu, 2008-06-05 12:31

J'ai rédigé une proposition pour la partie "Guide du développeur". (inspiré, je ne le cache pas, du livre "Learning Drupal 6 Module Development ")

Il y a un côté "approche par l'exemple" qui personnellement me plait bien. Est-ce que ce début de table des matière vous parait cohérent ou non ?


Attention au plagiat...

Damien Tournoud's picture
Damien Tournoud - Jeu, 2008-06-05 12:56

Attention au risque de plagiat durant cette phase de rédaction. Je préfère que l'on s'inspire largement du Drupal Handbook (publié sous licence Creative Commons), plutôt que de trop regarder du côté des différents livres qui traitent du sujet.

Damien Tournoud
http://drupalfr.org


Oui, évidement. C'est aussi

Haza's picture
Haza - Jeu, 2008-06-05 13:45

Oui, évidement. C'est aussi pour cela que je ne suis pas aller plus loin pour le moment.

Et bien evidement, cela ne servirait que pour avoir une idée de "plan" pour cette partie. (ce plan étant rendu publique sur le site de l'éditeur).

Pas question d'aller s'inspirer du contenu même de cet ouvrage.

Néanmoins, si cela dérange, sentez-vous libre de tout supprimer ;)


public != libre

dcaillibaud - Jeu, 2008-06-05 14:11

cela ne servirait que pour avoir une idée de "plan" pour cette partie. (ce plan étant rendu publique sur le site de l'éditeur).

Attention, info publique ne veut pas dire copyleft !

(mais bon, reprendre des idées générales d'organisation de contenu ne devrait pas passer pour du plagiat).


Attention, info publique ne

Haza's picture
Haza - Jeu, 2008-06-05 14:40

Attention, info publique ne veut pas dire copyleft !

Très juste (j'aurais pu preciser ce n'était pas ma pensée)

Et nous en sommes toujours au stade d'élaboration, je pense que tout cela sera completé par bien d'autre éléments

(documentation de l'api form, schemas, et bien d'autres...)


Merci Haza pour tes contrib...

ineation's picture
ineation - Sam, 2008-06-07 16:03

Section "Première installation"

webastien's picture
webastien - Dim, 2008-06-08 01:47

Je viens de rédiger la section "Première installation" dans le wiki "Le manuel du débutant". Je pense avoir été assez didactique, mais si des points ne sont pas assez clair n'hésitez pas à compléter / modifier.
Par contre (je l'ai d'ailleurs indiqué dans le wiki), est-il utile d'indiquer au débutant comment créer une base de données ? N'est-ce pas le rôle du manuel de l'administrateur ?

De plus, tout le monde n'utilise pas le même client BDD et ce n'est pas lié directement à Drupal. Peut-être qu'il serait plus simple de mettre des liens vers des tutoriaux présents sur d'autres sites pour de telles questions. Dans le cas d'un utilisateur novice, si son hébergeur lui propose une base de données, il a généralement accès à un guide spécifique à celle-ci.

Le paramétrage serveur (pour les urls simplifiées et la configuration du site sur le serveur) est également souvent inutile pour le débutant : Soit il utilise un hébergeur mutualisé dont le ftp pointe au bon endroit (et avec une seule base de données), soit il est en local avec un EasyPhp ou Wamp qui fonctionnent par défaut sans paramétrages spécifiques.

Au sujet de la relecture et de la correction... si d'autres personnes s'y attellent, ça aiderait car il est dur d'avoir un esprit critique sur ce que l'on écrit. Pour l'homogénisation, il faut peut-être attendre que le manuel soit un peu plus étoffé pour réorganiser les sections entre elles : ce sera alors surtout du couper/coller.

Ce qui serait pas mal, serait que des débutants justement donnent leurs avis, quitte à mettre des notes dans le wiki ("point pas très clair, à développer") car des points qui nous paraissent évidents maintenant qu'on commence à maitriser l'outil sont peut-être incompréhensible pour eux. Personnellement, je pense que j'aurai plus à dire sur le guide du développeur mais ce n'est pas la priorité (cf dernière réunion mensuelle).

Bref, s'il y a des novices qui passent dans le coin, allez jeter un oeil sur le manuel en cours et donnez votre avis... c'est pour vous qu'il est fait après tout :)

A bientôt.