Wikify

De Mi caja de notas

Révision datée du 28 mars 2018 à 13:21 par Xtof (discussion | contributions) (→‎indieweb)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)

Cet article est une ébauche. Vous pouvez aider le wiki IndieWebCamp à l'améliorer et le compléter.

Cette page a démarré sur wikifying

wikifier désigne la pratique de poser des trucs sur le wiki, ou quelque chose de particulier sur le wiki. Par exemple, nous avons besoin de wikifier ces (FAQ|concept|jargon|etherpad).

Pourquoi

Wikifier en général, et notamment des sujets, des notes ou des documents, aide à développer les communs interrogeables et découvrables de la communauté IndieWebCamp.

Est-ce lié à l'IndieWeb ? Super, ajoute-le au wiki. Pas sûr ? Regarde des exemples de ce qu'il faut (ou ne pas) ajouter :

Comment faire

Se wikifier soi-même

Comme beaucoup de choses dans l'IndieWebCamp, commencez par éditer votre votre page, dans ce cas, votre propre page "User:".

Votre page "User:" est liée en haut et à droite avec le nom de votre domaine que vous avez utilisé pour vous connecté sur le wiki (juste avant "My talk" - ou "Page de discussion" si vous avez réglé vos préférences en français).

Cliquez dessus et éditer votre page User:.

Si vous n'êtes pas sûr quoi poser sur votre page User:, commencez simple. Nom, URL, h-card, par ex.

<span class="h-card">[http://mondomaine.exemple.com/ Votre Nom]</span>

Puis, ajoutez une section "démangeaisons" ou "itches" où vous saisirez ce que vous voulez travailler sur votre propre site, une présence personnelle numérique en ligne, un usage numérique d'un terminal personnel (par ex. même quand vous n'êtes pas connecté). Par ex. :

== Ce qui me démange ==
* Ajouter une [[h-card-fr|hcard]] complète sur mon site
* Imaginer un [[URL design-fr|design URL]] pour mes posts
* Commencer à poster manuellement des [[notes-fr|notes]] avec des  [[permalinks-fr|permaliens]]
* Vérifier mon site avec indiewebify.me
* Mesurer mon [[IndieMark-fr|IndieMark]] pour quelques idées supplémentaires à ajouter sur mon site

Quand vous commencez à assembler beaucoup de démangeaisons, vous pourriez souhaiter démarrer des priorités, tout spécialement en renseignant ce sur quoi vous travaillez en ce moment. Démarrez par une section "Je bosse sur" pour ça :

== En train de travailler ==
* la prochaine chose que je compte travailler sur mon site
* la prochaine prochaine chose que je travaillerai ....
* ... etc.


Pour finir, regardez les pages d'autres utilisateurs, tout spécialement les personnes qui ont fait ça depuis un moment, afin de voir ce que vous pourriez ajouter à votre page et travailler.

Focus

Parce que c'est IndieWebCamp, et que ceci traite de votre page utilisateur IndieWebCamp, cela devrait revenir continuellement à vous poser la question :

  • Quelle est la prochaine chose que vous voulez travailler sur votre site personnel ?

Ce qui veut dire par exemple que les éléments suivants seront mieux à laisser de côté ou à poursuivre ailleurs - comme sur votre propre site !

  • Une todo liste personnelle (d'autres choses sur des sites non personnels) - votre page utilisateur IndieWebCamp est de travailler sur votre site personnel.
  • Demander aux autres de faire le travail pour vous. Note : les demandes d'aide pour les démangeaisons/projets spécifiques IndieWeb sont ok, mais adressez-les à tout le monde, pas seulement à des individus. Ceci concerne tout ce que vous voulez travailler - nous pas la délégation à d'autres du travail à réaliser.
  • Essayer de faire que les silos fassent des choses, en général ou avec des comptes spécifiques - au lieu de cela, documentez les problèmes de silos individuels sur les pages spécifiques des silos sur le wiki, et suivez-là. Vos démangeaisons devraient concerner votre site personnel, pas les silos.

Wikification Incrémentale

Article principal : expand a page-fr

Il y a beaucoup de wikification incrémentale à produire.

  • corriger les erreurs de typo
  • Ajouter des exemples IndieWeb - si vous trouvez une page pour une technologie que vous soutenez sur votre site, ou un projet que vous utilisez sur votre site, ajoutez-le vous-même à la section «Exemples IndieWeb" pour cette page
  • Ajoutez des problèmes et des questions (pour les FAQ)
  • Recueillez des questions/réponses de IRC et ajoutez-les à la page wiki appropriée
  • Organisez le contenu d'une page qui grandit en la découpant en sections agrandir une page


Nouvelles pages

Article principal : start a page-fr

Il y a beaucoup de création de nouvelles pages, que vous pouvez aider. Créer de nouvelles pages wiki pour :

  • de nouveaux concepts ou termes discutés, par exemple dans IRC
    • commencer par {{stub-fr}} et une courte définition !
    • surtout si elles sont en rapport avec indieweb d'une certaine façon
  • les etherpads des notes de sessions IndieWebCamp une fois terminées, pour archiver les notes de session dans un endroit plus trouvable/pointable.
  • les nouveaux projets que vous commencez à utiliser sur votre site personnel ; assurez-vous d'ajouter votre site dans la section Exemples IndieWeb sur la page.

Si quelque chose n'est pas lié à indieweb, par exemple ça n'a pas été soulevé dans la discussion comme des choses en rapport avec indieweb, envisagez peut-être de documenter sur Wikipedia à la place (et/ou en utilisant Wikipedia comme une référence/citation).

Documentez vos décisions

Once you've documented yourself on your User page, and started incrementally documenting your "Itches" and "Working On", as you get work done and deploy to your personal site, document your "major decisions", on your user page or perhaps in a "Implementation Design" section on your project page.

Une fois que vous avez vous-même documenté votre page d'utilisateur, et avez commencé à documenter de manière incrémentale vos "Démangeaisons" et "Le travail en cours", au fur et à mesure que vous effectuez le travail et le déploiement sur votre site personnel, documentez vos "grandes décisions" sur votre page d'utilisateur ou peut-être dans une section "Mise en œuvre de la conception" de votre page de projet.

Exemples :

Documenter vos grandes décisions de conception et de mise en œuvre vous aidera à mieux considérer quand les revoir, et quand travailler sur de nouvelles fonctionnalités et caractéristiques.

Définir le jargon

Chaque fois que quelqu'un utilise un terme de jargon sur IRC, ou d'autres canaux de communication indieweb, allez-y et demandez dans le canal :

  • What is terme jargon

Ceci alertera Loqi qui répondra soit avec la définition du wiki, ou vous alertera pour définir le terme avec un lien pour créer la page sur le wiki.

Vous pourrez ensuite définir le terme jargon en cliquant sur ce lien, ou répondre à la question :

  • Un terme jargon est un concept peu évident, ou une ré-utilisation d'un mot pour signifier quelque chose d'autre que son sens commun.

Essayez d'être spécifique et avec du sens dans les définitions, et ajoutez pourquoi c'est pertinent pour l'indieweb (si ce n'est pas évident à partir de la description).

Éviter de répéter les mots du terme, évitez les définitions abstraites génériques, et minimisez l'utilisation de termes du jargon dans une définition (utilisez-les si nécessaire, puis reliez/définissez les aussi).

définitions tweetables

Consultez les définitions sur les pages wiki, et modifiez-les pour qu'elles soient tweetables, car il est démontré que les gens tweeteront les bonnes définitions qui seront d'une longueur tweetable (en y ajoutant un lien à la suite de la page) - ce qui veut dire 116 caractères (espace + 23 caractères pour le lien raccourci tco).

Site deaths are when sites go offline, taking content and permalinks with them, and breaking the web accordingly. http://indiewebcamp.com/site-deaths

    • Notez qu'il a édité le dfn de site-deaths (à cette heure) et éliminé "their" afin de l'adapter à Twitter.

Divulgation progressive du contenu

Une définition tweetable (ou minimale) sans jargon simple est une première étape importante dans la fourniture d'un contenu qui soit compréhensible par un public plus large, tout en documentant toutes les recherches et les détails importants qui sont découverts ou inventés par la communauté.

Presque chaque page sur le wiki peut être améliorée à cet égard, afin de fournir une divulgation progressive du contenu pertinent..

Autrement dit, les pages wiki devraient commencer par offrir aux débutants des informations définitives et rapides.

Et ensuite documenter de manière incrémentale les détails si nécessaires pour le vrai monde et les cas d'utilisation qui fournissent des avantages aux lecteurs.

Par exemple Commencer peut (encore) être à cet égard continuellement améliorée. Comme on pourrait le faire avec l'hébergement web.


Articles en Rapport

Ce qui précède est très spécifique à ce qui est une bonne wikification pour IndieWebCamp, en particulier.

Voici les articles liés sur la bonne écriture, la structure et la wikification en général :

FAQ

Est-ce que cela devrait aller sur le wiki

Q : Avons-nous vraiment besoin de ça sur le wiki ?


R : Cela dépend ! En bref, tout ce qui concerne l'indieweb vaut la peine d'être posé sur le wiki, et bien sûr c'est à quelqu'un de prendre soin de le faire !

Voici quelques bons exemples de choses à mettre sur le wiki :

  • Tout sujet directement lié à l'IndieWeb, en particulier directement lié aux personnes dans la communauté avec leurs propres sites :
    • Technologies (par exemple Apache) les gens l'utilisent pour installer/construire/faire tourner/maintenir/surveiller leur site indieweb
    • Les services (par ex. l'hébergement web) que les gens utilisent pour leur site indieweb
    • Les événements ou podcasts qui discutent du web indépendant ou de l'IndieWeb en particulier, y compris les événements avec une seule conversation connexe (assurez-vous d'inscrire le discours spécifique)
    • Le Jargon représentant une technologie utilisée dans le cadre d'un site IndieWeb
    • Les silos qui ont l'art et l'antécédent (UX, design, formats, protocoles) pour les choses que nous voulons reconstruire indépendamment.

Qu'est ce qui ne devrait pas aller sur le wiki

Q: Si tout cela a du sens sur le wiki, qu'est-ce qui n'a pas de sens sur le wiki ?

R : Il y a tellement de choses qui ne nécessitent pas d'être sur le wiki qu'il est difficile de les énumérer toutes. De toute évidence, en dehors des choses comme les violations du code-de-conduite, voici quelques-unes que nous avons vu être ajoutées et décidé que ce serait mieux de les enlever. Ces choses semblent tomber dans le modèle-type de quand quelqu'un est passionné par quelque chose qui n'est pas lié à l'indieweb, et veut l'ajouter au wiki.

  • Les choses aléatoires. En général, les choses aléatoires qui ne disposent pas d'une connexion IndieWeb évidente sont mieux à déposer sur Wikipedia, et en utilisant les liens de Wikipedia plutôt que de créer des pages d'ébauches moins utiles sur le wiki IndieWeb. Par exemple.
    • Les termes techniques. Si un terme technique n'a pas de lien évident direct avec IndieWeb, pas besoin de le documenter ici.
    • Les organisations. Si une organisation n'a aucun rapport avec quoi que ce soit d'indépendant, elle peut probablement être laissée de côté.
      • Exception : Comme indiqué ci-dessus sous les silos, nous documentons tout/tous les sites/services que tout le monde a utilisé dans la communauté (ou même si des amis l'ont utilisé) qui ont annoncé ou sont menacés de fermeture, ou s'il a en particulier une UX qui vaut d'être capturée à des fins de recherche pour designer nos propres fonctionnalités indieweb.
    • événements. Si un événement n'a rien à voir avec l'indieweb, il n'a pas besoin d'être inscrit sur la page événements.


Discussion IRC en rapport :

Voir aussi