En première lecture ça me paraît très bien… mais je ne suis pas dev :-P Le 18 août 2013 21:17, Nicolas <nikrou77(a)gmail.com&gt; a écrit : > Bonjour, > > pour que la première image de dotclear sur Bitbucket soit la bonne, nous > allons mettre à jour le fichier README. > > On peut y mettre pleins de choses, mais ce seront principalement des > développeurs qui verront ce fichier, donc il faut leur donner les infos que > l'on suppose qu'ils veulent y voir. Et oui c'est la partie pas facile de > l'exercice. > > Je mets l'ébauche en français mais évidemment tout cela sera en grand > breton. > Je verrais bien un plan comme ça : (sans les numéros mais les numéros sont > là pour faciliter vos commentaires et l'ajout de contenu) > > 1) Présentation de dotclear > Une présentation claire, courte et accrocheuse de dotclear. > > 2) Installation > - installation automatique avec le lien. Préciser que c'est la plus facile. > - installation manuelle. Téléchargement.... > > Lien vers la doc wiki > http://dotclear.org/documentation/2.0/admin/install?s[]=installation > > 3) Documentation > préciser qu'il y a une super doc, à jour, tout ça. > ajouter que tout un chacun peut l'enrichir > Lien vers wiki > > 4) Contribuer > De quelle manière contirbuer (PR,...) et sur quoi : code, doc, tests,... > Lien vers fichier CONTRIBUTING (à remplir de manière précise sur la manière > de faire une PR) > > 5) Tests (pas encore) > dotclear est testé en long, en large et en travers en utilisant X, Y et > aussi Z > > Votre avis. > > Nicolas > -- > Dev mailing list - Dev(a)list.dotclear.org - http://ml.dotclear.org/listinfo/dev -- Anne / Kozlika -- Dev mailing list - Dev(a)list.dotclear.org - http://ml.dotclear.org/listinfo/dev

ça me parait bien. Le lien CONTRIBUTING file <https://bitbucket.org/nikrou/**CONTRIBUTING.md<https://bitbucket.org/n... pointe sur rien ... mais peut être est ce normal ? Bernard Le 23/08/2013 15:47, Nicolas a écrit : Bon finalement j'ai mis à jour un fichier README et un fichier > CONTRIBUTING > sur bitbucket dans un dépôt de test pour ne pas polluer par 36000 commits > le dépôt principal > J'ai renommé le fichier README en README.md pour bénéficier de la syntaxte > markdown. > > Voilà si certains veulent bien aller y jeter un oeil pour corriger et > améliorer: > https://bitbucket.org/nikrou/**test <https://bitbucket.org/nikrou/test> > > Merci d'avance > Nicolas > > > Le 18 août 2013 21:54, Kozlika <kozlika(a)gmail.com&gt; a écrit : > > En première lecture ça me paraît très bien… mais je ne suis pas dev :-P >> >> >> Le 18 août 2013 21:17, Nicolas <nikrou77(a)gmail.com&gt; a écrit : >> >>> Bonjour, >>> >>> pour que la première image de dotclear sur Bitbucket soit la bonne, nous >>> allons mettre à jour le fichier README. >>> >>> On peut y mettre pleins de choses, mais ce seront principalement des >>> développeurs qui verront ce fichier, donc il faut leur donner les infos >>> >> que >> >>> l'on suppose qu'ils veulent y voir. Et oui c'est la partie pas facile de >>> l'exercice. >>> >>> Je mets l'ébauche en français mais évidemment tout cela sera en grand >>> breton. >>> Je verrais bien un plan comme ça : (sans les numéros mais les numéros >>> >> sont >> >>> là pour faciliter vos commentaires et l'ajout de contenu) >>> >>> 1) Présentation de dotclear >>> Une présentation claire, courte et accrocheuse de dotclear. >>> >>> 2) Installation >>> - installation automatique avec le lien. Préciser que c'est la plus >>> >> facile. >> >>> - installation manuelle. Téléchargement.... >>> >>> Lien vers la doc wiki >>> http://dotclear.org/**documentation/2.0/admin/** >>> install?s[]=installation<http://dotclear.org/documentation/2.0/admin/i... >>> >>> 3) Documentation >>> préciser qu'il y a une super doc, à jour, tout ça. >>> ajouter que tout un chacun peut l'enrichir >>> Lien vers wiki >>> >>> 4) Contribuer >>> De quelle manière contirbuer (PR,...) et sur quoi : code, doc, tests,... >>> Lien vers fichier CONTRIBUTING (à remplir de manière précise sur la >>> >> manière >> >>> de faire une PR) >>> >>> 5) Tests (pas encore) >>> dotclear est testé en long, en large et en travers en utilisant X, Y et >>> aussi Z >>> >>> Votre avis. >>> >>> Nicolas >>> -- >>> Dev mailing list - Dev(a)list.dotclear.org - >>> >> http://ml.dotclear.org/**listinfo/dev<http://ml.dotclear.org/listinfo/... >> >> >> >> -- >> Anne / Kozlika >> -- >> Dev mailing list - Dev(a)list.dotclear.org - >> http://ml.dotclear.org/**listinfo/dev<http://ml.dotclear.org/listinfo/... >> >> -- Dev mailing list - Dev(a)list.dotclear.org - http://ml.dotclear.org/** listinfo/dev <http://ml.dotclear.org/listinfo/dev>

Pour pinailler, 2 petites choses : 1. "Choose your input method" est la seule feature à utiliser cette forme commençant pas un verbe, je trouve ça bizarre (et en plus je suis pas sûr de à quoi ça correspond, c'est le choix de format wiki/xhtml ?)

2. Extensible n'est-il pas redondant avec Themes & plugins, ou je dis une connerie ?

Le 23 août 2013 20:00, Nicolas <nikrou77(a)gmail.com&gt; a écrit : > Et si j'avoutais wiki/xhtml cela clarifierait les choses, non ? Ou Markdown ou Textile (les plugins existent) du coup il faudrait une phrase plus générique du genre "choose editing syntax from several systems such as wiki, xhtml, textile, etc"...

Euh... je ne sais plus faire de PR, parce que je n'ai pas eu le temps récemment de m'adapter aux derniers changements de mode de travail sur le dépôt (SVN > hg.dotclear > bitbucket) :P Je me demande si cette excuse est valable ! :-)

Du coup je suggèrerais "Choose from several editing syntaxes such as Dotclear wiki, Markdown or Textile, or write directly in XHTML" ... et te laisse corriger tout seul

Le 24/08/2013 14:15, philippe(a)dissitou.org a écrit : > Le 24 août 2013 10:02, Nicolas <nikrou77(a)gmail.com&gt; a écrit : > >> Tu me fais une PR ou je corrige tout seul comme un grand ? >> Merci en tout cas pour la remarque. > Euh... je ne sais plus faire de PR, parce que je n'ai pas eu le temps > récemment de m'adapter aux derniers changements de mode de travail sur > le dépôt (SVN > hg.dotclear > bitbucket) :P > > Du coup je suggèrerais "Choose from several editing syntaxes such as > Dotclear wiki, Markdown or Textile, or write directly in XHTML" > > ... et te laisse corriger tout seul > > Merci :) > Y'a un super tuto pour les débutants comme toi :D

Le 24 août 2013 17:09, Lepeltier kévin <kevin(a)lepeltier.info&gt; a écrit : >> http://forum.dotclear.org/**viewtopic.php?id=47326<http://forum.dotcle... Tu te sens de le traduire et le mettre sur le wiki ? Je vais modifier le fichier contributing et je ferai référence à cette page. Cela peut servir.

Bon finalement j'ai mis à jour un fichier README et un fichier CONTRIBUTING sur bitbucket dans un dépôt de test pour ne pas polluer par 36000 commits le dépôt principal J'ai renommé le fichier README en README.md pour bénéficier de la syntaxte markdown. Voilà si certains veulent bien aller y jeter un oeil pour corriger et améliorer: https://bitbucket.org/nikrou/test Merci d'avance Nicolas

Le 24 août 2013 19:35, Bernard Le Roux <lr.b21560(a)gmail.com&gt; a écrit : > Je me permets d'attirer votre attention sur un paragraphe de la > documentation qui me semble ne pas être à jour par rapport au README : > http://fr.dotclear.org/**documentation/2.0/resources/** > coding-standards#code-php<http://fr.dotclear.org/documentation/2.0/res... > Oui c'est intéressant aussi. Mais je ne pense pas que cela ait sa place dans le README. On peut à la rigueur faire un lien depuis CONTRIBUTING

Le 24 août 2013 20:14, Bernard Le Roux <lr.b21560(a)gmail.com&gt; a écrit : > Je ne proposais pas de mettre le contenu dans la README mais seulement > attirer l'attention que le contenu du README et le contenu de cette page ne > sont plus en phase. > La version php minimum par exemple ? Ok mais le reste on s'en moque dans le README

Maintenant c'est à jour ! Le 24 août 2013 20:18, Bernard Le Roux <lr.b21560(a)gmail.com&gt; a écrit : > Le 24/08/2013 20:17, Nicolas a écrit : > > Le 24 août 2013 20:14, Bernard Le Roux <lr.b21560(a)gmail.com&gt; a écrit : >> Je ne proposais pas de mettre le contenu dans la README mais seulement >>> attirer l'attention que le contenu du README et le contenu de cette page >>> ne >>> sont plus en phase. >>> >>> La version php minimum par exemple ? Ok mais le reste on s'en moque >> dans le >> README >> > oui tout à fait > > > -- > Dev mailing list - Dev(a)list.dotclear.org - http://ml.dotclear.org/** > listinfo/dev <http://ml.dotclear.org/listinfo/dev> >

Le 26 août 2013 20:42, Bernard Le Roux <lr.b21560(a)gmail.com&gt; a écrit : > Bonjour, > > Je viens de voir aussi sur la page http://fr.dotclear.org/about#**features<http://fr.dotclear.org/about#f... numéro de version du PHP n'est plus correct. > Celle-ci je ne sais pas où on l'a modifie, je n'ai pas les clefs !

Je regarderai, je crois que c'est une page statique du blog.