examples-fr

From Microformats Wiki
Jump to navigation Jump to search

Bonne Pratiques pour les Pages d'Exemples

Les pages Exemples sont la première étape du processus d'exploration qui doit précéder la proposition d'un nouveau microformat. Les explorations sont listées sur la Main Page-fr. Vous pouvez utiliser le gabarit exemple pour vous aider à créer votre propre page.

But des Pages Exemple

(adapté du processus)

Documenter le comportement humain actuel sur le web. Souvenez-vous, nous sommes en train de daller le chemin de vaches- avant de faire ça, vous devez trouver les chemins des vaches. Votre documentation devrait être une collection de sites dans le vrai monde et des pages qui publient les types de données que vous souhaitez structurer avec un microformat. A partir de ces pages et ces sites, vous devriez extraire les exemples de syntaxe et schémas tacites dedans, et fournir une analyse.

Comportement Actuel Humain sur le Web

Spécifiquement :

Actuellement

  • Ce n'est pas ce que les gens font maintenant sur le Web.
  • Ce n'est pas :
    • ce que les gens ont fait il y a 50 ans
    • ce que vous vous attendez à ce que les gens fassent dans le futur


Humain

Une information utilisateur explicite saisie et publiée. Alors que l'information publiée automatiquement comme les logs d'un thermomètre éléctronique peut être intéressante, elle n'est pas produite par un humain (à moins que le thermomètre ne soit coincé dans un humain, et ce n'est seulement indirect/implicite/non contrôlé) et par conséquent ne reflète pas ce que font explicitement les humains.

Comportement

  • Ce que les gens font véritablement. Penser à l'évidence empirique, tout comme de la même manière la méthode scientifique exige de rassembler des données empiriques.
  • pas :
    • ce qu'ils pourraient faire
    • ce qu'ils devaient avoir faits
    • ce qu'ils feraient
    • Intention/Désire/Volonté. Une erreur courante produite par les types cherchant sur les formats est de *demander* explicitement aux gens ce qu'ils *veulent* ou *préfèrent*, à l'opposé *d'étudier* ce qu'ils *font*. C'est bien connu parmi les chercheurs/études de marché dans les comportements que *demander* aux personnes ce qu'elles *veulent* ou même *demander* aux personnes ce qu'elles *font* vous donnera des réponses très différente (ou pire / moins pertinentes) que le fait *d'étudier* véritablement ce qu'ils *font* dans le vrai monde.
    • Formats. les formats sont des prescriptions pour le comportement, pas le comportement lui-même. Pour documenter les formats, créer une *-formats page.

Web

  • Les exemples DOIVENT se concentrer sur des exemples véritablement publiés sur le Web, à une URL publiquement disponibles, qui devrait être documenté avec l'exemple lui-même sur la page wiki.
  • Les exemples Non-web ne sont seulement bien *seulement* pour des considérations secondaires/tertiaires, et en aucun cas (peu importe leurs quantités) être plus importants que les exemples Web.
    • fichiers privés
    • articles
    • etc.

Sections Recommandées

Niveau le plus haut (=) :

  • Phrase d'introduction

Deuxième niveau (==) :

  • Le Problème
    • Quel est le but de cette exploration ?
  • Participants
    • Liste à puces de qui est actif (ou s'en soucie)
  • Exemples Vrai Monde
    • Liens vers des pages web publiques, soit populaires ou perspicaces
  • Pratiques Existantes
    • Résumé des modèles communs découverts
    • Autres essais pour résoudre le Problème
  • Voir aussi / Prochaines Etapes
    • Liens vers des pages apparentées dès qu'elles seront disponibles
      • *-formats
      • *-brainstorming

section Exemples du Vrai Monde

  • Liste à plat au minimum. La section exemple du vrai monde devrait au minimum contenir une liste à plat d'exemples. Voir plus bas pour voir ce qu'a un bon exemple
  • Grouper dans des catégories peut aider. Une liste plate géante d'exemples peut parfois être difficile à naviguer et analyser en tant qu'ensemble. Considérez de grouper les exemples apparentés à l'intérieur d'une liste plate de catégories. Si vous n'êtes pas certain de savoir comment catégoriser les exemples, ou s'il il y a plusieurs axes dans ce que pourriez catégoriser comme exemples, demandez sur la liste de discussion et/ou dans le canal irc

Bons Exemples d'Exemples

Les pages suivantes sont parmi les meilleurs exemples pour représenter ce modèle de desing :

Un Bon Exemple a

Un bon exemple a plusieurs choses :

  • URL vers le véritable exemple sur le Web
  • Un lien texte de cet hyperlien devrait ressembler à une citation de cet exemple là, par exemple, qui, quel site
  • Peut-être une illustration de fragment d'extrait de code (syntaxe) tirée de l'exemple
  • Analyse du schéma sous-entendue représenté par cette illustration, avec au minimum une liste à plat des "champs" présents dans le fragment exemple.

Quand Ajouter des Exemples

Au moment d'ajouter des exemples sur une page existante d'*-examples, essayez svp d'ajouter les exemples à l'intérieur de la structure existante organisationnelle de la page. Par exemple, si les exemples sont groupés ou catégorisés d'une certaine façon, essayez d'ajouer des nouveaux exemples dans ces catégories existantes, au lieu d'ajouter une nouvelle section.

Si vous devez ajouter une nouvelle catégorie ou une nouvelle sous-section, faites le, mais essayez de le faire en harmonie avec les catégories existantes. Si ce n'est pas évident pour vous de faire ainsi, ou si les catégories ne font pas de sens, alors ce pourrait être le bon moment pour poser une question sur la liste de discussion ou le canal irc.