De Freenet Doc.

Sommaire 1 Objectifs 2 Organisation 3 Structure 3.1 Fonctions 3.2 Logiciels 4 Choix de présentation

Objectifs

Cette page n'a pas vraiment d'objectifs : il s'agit d'un sommaire contenant des liens vers les différentes pages expliquant l'utilisation de Freenet. Je m'en sers pour définir la structure de cette partie, tous vos commentaires sont les bienvenus.

Ces articles doivent se concentrer sur la manière de faire une chose. Pas les explications sur qu'est cette chose. Par exemple, l'article sur les Freesites doit se contenter d'expliquer comment utiliser fProxy pour en consulter un (ce qui sera vite fait). L'explication de ce qu'est un Freesite se trouvera dans un autre chapitre. Pourquoi pas une page spécifique, appelée Freesite ? Nous pourrions changer le mot Freesite en lien partout dans le texte et les gens y auraient accès dès qu'ils se poseraient la question (c'est valable pour les autres mots/concepts)... Il serait possible de regrouper tous ces liens/pages dans une nouvelle partie intitulée Glossaire. Elle contiendrait la définition de tous les mots spécifiques à Freenet.

Organisation

Chaque fonction d'un logiciel est détaillée dans une page qui lui est propre. Exemple :

• Discuter avec Frost
• Insérer un fichier avec Frost
• Discuter avec Thaw
• Insérer un fichier avec Thaw
• ...

L'idée, c'est que chaque article ne doit expliquer qu'une seule chose. Ainsi, son objectif est simple et clair et on ne se lance pas dans une grande dissertation.

Une fois ces pages créées, on peut organiser les liens en un tout cohérent :

Regroupées par fonctions :

• Discussion
  • Discuter avec Frost
  • Discuter avec Thaw
  • ...
• Echange de fichiers
  • Insérer un fichier avec Frost
  • Insérer un fichier avec Thaw
  • ...

Regroupées par logiciels :

• Frost
  • Discuter avec Frost
  • Insérer un fichier avec Frost
  • ...
• Thaw
  • Discuter avec Thaw
  • Insérer un fichier avec Thaw
  • ...

Ce n'est qu'un exemple mais l'idée, c'est de ne faire le travail qu'une seule fois et de pouvoir le présenter de la façon qui intéresse le visiteur. Veut-il savoir comment on peut discuter avec des gens ? Ou bien veut-il tout savoir sur Frost ? Avec cette présentation, il peut obtenir exactement ce qu'il veut.

Structure

Je commence donc à rédiger la structure, n'hésiter pas à corriger/ajouter si j'oublie des trucs.

Fonctions

• Les freesites
  • Trouver un Freesite
    • Les Index
    • XMLLibrarian
    • Frost (la board sites)
  • Consulter un Freesite avec fProxy
  • Créer un Freesite
    • Créer un Freesite avec Echo (je sais qu'il ne marche pas encore mais ça ne devrait plus tarder maintenant)
    • Créer un Freesite avec un éditeur html ou un IDE
  • Insérer un Freesite
    • Insérer un Freesite avec Echo
    • Insérer un Freesite avec jSite
    • Insérer un Freesite avec FCP (intéressant pour ceux qui veulent automatiser l'insertion d'un site)
• Discussion
  • Discuter avec Thaw
  • Discuter avec Frost
  • Discuter avec Freemail
• Echange de fichiers
  • Trouver des fichiers
    • Trouver des fichiers avec Thaw (les indexes)
    • Trouver des fichiers avec dans les freesites (listes de clés)
    • Demander dans Frost/Thaw (discuter)
    • Trouver des fichiers avec Frost
    • Trouver des fichiers avec Freemule
  • Télécharger des fichiers
    • Télécharger avec Thaw
    • Télécharger avec Frost
    • Télécharger avec Freemule
    • Télécharger avec fProxy
  • Insérer des fichiers
    • Insérer avec Thaw (et comment créer un index et le publier)
    • Insérer avec Frost
    • Insérer avec Freemule
    • Insérer avec fProxy

Logiciels

• Fproxy
  • Consulter un Freesite avec fProxy
  • Télécharger avec fProxy
  • Insérer avec fProxy
• Thaw
  • Discuter avec Thaw
  • Trouver des fichiers avec Thaw (les indexes)
  • Télécharger avec Thaw
  • Insérer avec Thaw
• Frost
  • Discuter avec Frost
  • Trouver des fichiers avec Frost
  • Télécharger avec Frost
  • Insérer avec Frost
• Echo
  • Créer un Freesite avec Echo
  • Insérer un Freesite avec Echo
• jSite
  • Insérer un Freesite avec jSite
• Freemail
  • Discuter avec Freemail

Une fois que j'ai écrit tout ça, je me rends compte qu'il manque une chose : la configuration et l'installation de ces logiciels. Je pense que ça devrait se trouver dans un autre chapitre. Peut-être juste après celui sur l'installation de Freenet...

Choix de présentation

La manière dont nous allons présenter les différents logiciels est importante. Il y a de bonnes chances pour que le visiteur prennent le premier que nous présentons pour une fonction donnée. Cela nous donne du pouvoir et la responsabilité qui va avec.

Je pense que nous devons mettre en avant les logiciels maintenus par le projet qui évolueront avec lui (Thaw et Echo) :

• Thaw en priorité par rapport à Frost. Je discute pas mal avec bback et jFlesch (les auteurs des deux logiciels) et il m'apparaît clair que Frost est une usine à gaz que son auteur a du mal à maintenir. Il y a peu de chances que Frost évolue beaucoup et il faut reconnaître qu'il est extrêmement lourd. A l'opposé, Thaw n'est pas parfait, il lui manque encore des fonctions mais il évolue vite, il est léger, beaucoup plus facile à prendre en main, plus joli et son développeur fait partie de l'équipe du projet. Je pense que nous devons pousser les gens dans cette direction.
• Freemule en retrait. Freemule est bien pratique mais nous savons qu'il ne fonctionne bien que s'il y a peu d'utilisateurs. Or le but de ce site est de faire en sorte que le réseau grandisse. De plus, les fichiers insérés par Freemule ne sont récupérables que par lui (les autres sont tous compatibles entre eux), il est très lourd également et son auteur ne fait pas partie de l'équipe. Le seul avantage de Freemule, c'est l'insertion à la demande. Dès que cette fonction sera implémentée dans Thaw, Freemule perdra tout intérêt et ses fichiers disparaîtront avec lui.

Votre avis ?

Batosai 15 novembre 2007 à 16:30 (CET)

Peut-etre que chaque chapitre consacré à une utilisation (Discussion/Echange de fichier/...) pourrait aiguiller l'utilisateur vers la solution technique (le logiciel) le plus adapté à son utilisation.

Sinon en voyant cette page assez importante et en voyant tout le "vocabulaire" je pense que ça pourrait être pratique pour le débutant de ne pas avoir tous ces termes propres a FreeNet mais plutot des termes génériques (client P2P ou je ne sais quoi) et de n'avoir les termes spécifiques le plus tard possible. Bon apres je sais pas si c'est realiste mais c'est juste qu'en regardant comme cela la page vite fait ça fait "initié", comme si on te mettait sous le nez un pavé d'un domaine que tu ne maitrisais pas (genre peinture pour un juriste).

Utopiah 15 novembre 2007 à 17:38 (CET)

Je crois que l'explicitation de ces termes "techniques" - spécifiques à Freenet - doit être faite dès le deuxième chapitre (Description technique de Freenet). Si nous masquons ces mots dans nos articles, les gens y seront de toute façon confrontés lors de leur utilisation des logiciels et cela risque de créer de la confusion. Ca ne sert à rien de leur parler de "partage" quand tous les logiciels parlent d'"insertion". Autant leur donner dès le départ le vocabulaire dont ils auront besoin par la suite.

Par contre, nous devons faire gros un effort pour que la définition de ces termes soit accessible le plus simplement possible. La première étape, c'est que chaque apparition de ces mots soit un lien vers la page contenant sa définition dans le chapitre 2.

Batosai 17 novembre 2007 à 14:23 (CET)

Ca me paraît pas mal comme organisation, c'est clair et le lecteur peut trouver facilement ce qu'il cherche.

Pour les termes techniques, on pourrait peut-être rajouter juste avant le sommaire un message prévenant les gens qu'il serait préférable qu'ils aient d'abord pris connaissance de la définition de ces termes avec un lien vers le chapitre 2. De toute façon, c'est clair qu'il faut au moins mettre un lien vers la définition pour chaque terme technique employé.

Bref, je vais déjà mettre à jour le sommaire, ça mange pas de pain.

Dieppe 19 novembre 2007 à 14:36 (CET)

Oui c'est une bonne idée. On peut mettre au début de chaque page un truc du genre "Notions à connaître pour comprendre cette page" avec des liens vers les pages du chapitre 2.

Batosai 19 novembre 2007 à 21:32 (CET)

Sinon, je viens de voir un petit howto sur l'échange de ref sécurisé sur frost, ça pourrait être pas mal de le mettre dans la doc. Question : on le mettrait où? Ici ou dans l'explication sur l'échange de ref dans le chapitre installation. Ou alors on le met ici et on met un lien en remarque dans la partie dédiée dans l'installation. Enfin bref, déjà, on en parle ou pas?

Edit : il faudrait peut-être faire une partie sur les plugins aussi non ? Pour les curieux qui se demandent à quoi ça sert. (on parle d'écho et de XMLLibrarian, mais bon, les gens qui viennent spécifiquement pour en apprendre plus sur les plugins ne vont pas forcément le voir, noyé dans la masse). Après je ne sais pas si ça a clairement sa place ici, ou plutôt dans la partie description.

Dieppe 20 novembre 2007 à 12:55 (CET)

Je ne crois pas que ce soit une bonne idée. L'échange de ref avec des inconnusva disparaître d'ici la fin de l'année avec la mise en place des seednodes. Et l'échange de refs darknet ne devrait pas se faire sur frost mais avec des gens qu'on connait vraiment.

Batosai 20 novembre 2007 à 16:28 (CET)

Je me suis permis de rajouter la petite notice sur Thaw/Frost puisqu'on en avait déjà discuté et qu'on avait dit qu'il valait mieux mettre en avant Thaw. Mais je n'impose rien hein, donc si vous n'êtes pas d'accord, supprimer le et lancez le débat ;)

Dieppe 25 décembre 2007 à 20:15 (CET)

J'ai utilisé pour montrer quel article était à privilégier pour une fonction donnée. Qu'en pensez vous ?

Dieppe 29 décembre 2007 à 18:05 (CET)

J'ai enlevé l'entrée correspondant à Echo pour la création de Freesite, Thingamablog étant préféré pour l'instant puisqu'Echo tarde à sortir en version utilisable (s'il sort).

Dieppe 13 janvier 2008 à 03:53 (CET)

Bonne idée le petit coeur. J'aurais juste tendance à l'afficher un peu plus petit pour qu'il ne modifie pas la mise en page. Sinon, je suis d'accord pour Echo. Mieux vaut le laisser de côté pour l'instant et privilégier Thingamablog/jSite. Si quelqu'un a le courage de transposer l'article que j'ai mis sur mon flog, ce serait tant mieux car je suis en déplacement toute la semaine et je ne pourrai pas m'en occuper.

Désolé si je suis assez peu actif en ce moment, la vie réelle me prend pas mal de temps ;) Félicitations à Dieppe pour tous les articles sur l'Utilisation, je les lirai tous à tête reposée le week-end prochain.

Batosai 13 janvier 2008 à 20:56 (CET)

J'ai modifié la structure du sommaire et de cette page dans un but de simplification. Il était assez peu lisible avant.

Batosai 13 janvier 2008 à 21:43 (CET)