GeezerVisonThe World Wide Web, restored to 800 pixels of glory. | ||||||||||||
| Home|About|Gaming cabinet|Archives|How it works|Starter sites | ||||||||||||
GeezerVison is showing indieweb.org — wikifying wikifying is the practice of capturing information and ideas on the IndieWeb wiki, starting with your own User: page. E.g.: We need to wikify that FAQ, concept, jargon, or etherpad. Follow the step by step directions on this page to:
Then begin to contribute to the wiki. Why Join the IndieWeb WikiAs a community, we eschew email in lieu of real-time chat and documentation of the important points on the wiki to make it easier to search and build information and documentation over time. When you join the wiki you help our community grow and also provide documentation of your journey. This helps the next person who, like you, wants to control their data in the place that they own. Each person who joins the wiki has a user page they maintain and build over time. You can shape your page to tell your story. As you get started please consider these examples as you look for ideas. IndieWeb Examples
How to Join the IndieWeb WikiUnlike other sites where you choose a username and password, you only need your domain name to log in to this wiki. It uses indielogin.com to authenticate you. If you have not done so already, set up web sign-in on your domain so you can be authenticated and log in. In addition to being able to log into the wiki, this web sign-in should also allow you to log into and RSVP to events as well as to use many other IndieWeb building blocks like publishing apps and social readers. Step One: Create your user pageAfter logging in, visit your user page. Then click Create. You can choose two templates to add a profile to your page. If you want to edit your page at a later date go to your own user page (or click your domain name at the top right). From there, click Edit. Minimum ProfileThe IndieWeb community uses h-cards to identify people online. This is like a business card for your website. The smallest h-card includes your name and a link to your website. <span class="h-card">[https://example.com/ Your Name]</span> Infobox ProfileIf you would like to include a profile box like Go to Infobox person and copy the blank template. Then return to your wiki user page and select Avoid creating separate User pagesYour domain is your login when you sign in to the wiki, so your wiki "User:" page will also be your domain. This provides a profile page for your login and your wiki contributions are linked to it. Please do not create separate "User:" pages that are your name, nickname, etc. When you (or anyone else) visit(s) your "User:" page, you will see a link in the sidebar (left or right depending on theme) to "User contributions", which you (or anyone) can click to see your recent contributions to the wiki. Any separate "User:" pages are "fake" and don't have any login information associated with them so they lack such a "User contribution" link for you or anyone to check your contributions to the wiki. If you do (whether accidentally or with good intentions) create a separate "User:" page, you can either delete it or redirect it to your actual "User:" page with your login domain. If you mistakenly redirect your actual "User:" page to a separate "User:" page, you may need to "Move" any contents from your separate "User:" page to your actual "User:" page, overwriting that redirect. If someone makes one of the above mistakes, please reach out to them on chat and alert them, linking them to this section to advise them on why and how to repair their "User:" page setup. If they are not on chat, or don’t respond, it’s ok to make such repairs accordingly, and please leave a kind comment in any edit summaries, that link back to this section explaining why, and encourage joining chat for any follow-up questions. Step Two: Edit Your Wiki pageYou can shape your wiki page any way you like. There are some common elements many community members include: Write down your itchesMain article: itches
Next, add an itches section where you capture what you want to work on for your own site, personal online digital presence, and personal digital device usage (e.g. even when offline) in general. E.g. == Itches == * Add a more extensive [[h-card]] on my site * Figure out a [[URL design]] for my posts * Start posting [[notes]] manually at [[permalinks]] * Try checking my site in indiewebify.me * Check out [[IndieMark]] for additional ideas of things to add to my site When you start collecting lots of itches, you may want to start prioritizing them, especially by what you're currently working on. Start a "Working on" section for that: == Working On == * the next thing I'm working on for my site * the next next thing I'm working on getting working on my site * ... etc.
FocusAs this is the IndieWeb, and this is about your IndieWeb user page, it should be about answering this question, continuously:
This means for example that the following are better left out and pursued elsewhere - like on your own site!
Additional TemplatesThese pre-defined wiki templates that can be added to a user page:
Step Three: Add a chat nameOptionally add yourself to chat-names. This will show your photo by your name in the chat logs and link your name to your website. It will also allow our friendly chat bot Loqi to answer "who is [username]" with information from your wiki user page. To add a chat name visit chat-names and use the provided template. Step Four: Add a sparklineThe IndieWeb wiki allows sparklines, a small avatar that contains your photo and your name linked to your user page. This means people can add a text snippet like
Why Contribute to the IndieWeb WikiWikifying both in general, and particular subjects, notes, or documents, helps grow the searchable & discoverable commons of the IndieWeb community. Is it IndieWeb related or specific to the Indieweb? Great, add it to the wiki. How to Contribute to the IndieWeb WikiFinding pages that need improvementIf you're looking for a way to help improve the wiki, consider looking for old pages and help clean them up and improve them! The sections below describe ways you can improve pages, such as fixing typos, ensuring pages have some sort of IndieWeb relevance, adding citations, or even deleting a page. Here are some ideas for how to find pages that are likely to need improvement.
Incremental WikifyingMain article: expand a page
There's lots of incremental wikifying to help with.
See:
In general, small incremental edits help with understandable diffs or differences that make wiki page updates easier for the community to review and help with corrections when necessary. Focus on adding, and prioritize indieweb relevant content, especially IndieWeb community content, over random links and such of unknown provenance on the broader web. Add CitationsWhenever you see Loqi (or anyone frankly) share or post a link in chat to something relevant to the indieweb, please help out by adding those as citations/examples to the wiki, and especially if they're photos, add them to event page(s). Format citationsHere's how to "text format" citations to add them, from a minimum, to incrementally doing more work (or improving existing citations!)
Optionally:
YYYY-MM-DD [link article-name] <blockquote>key relevant sentence(s)!</blockquote> These are all super-easy (nearly completely) plain-text ways of just pasting/typing the information into the wiki. (Nearly) No code or markup to learn or figure out or debug. Don't worry about not being perfect, others can help with tweaking fixing things. Keeping wiki pages mostly plain-text-like makes them easier for others to edit and improve as well! The important thing is to just take the step of adding the information. If you like or are familiar MediaWiki templates, you can also use: Where to add a citationIf you don't know where in a page to put a citation, add it to the See Also section at the end.
wikipagename << YYYY-MM-DD [link article-name] etc. If the citation is criticism, add/move it to the Criticism section of the article. These are all incremental steps. None are required. All are something you can help with. Every incremental step you can help with above helps the wiki. Even just one incremental improvement is helpful! New pagesMain article: start a page
Please read relevant to the IndieWeb wiki before creating new pages. Create new wiki pages for:
If something is not particularly indieweb-related, e.g. it didn't come up in the discussion of things that are indieweb-related, perhaps consider documenting it on Wikipedia instead (and/or using Wikipedia as a reference/citation). New pages that don’t immediately define their IndieWeb relevance may be deleted. Multiword Page NamesWhen naming of multiword wiki pages, use multiple words with spaces, or dashes for multi-word terms., rather than WikiCase or camelCase. Definitions include IndieWeb relevanceMain article: definition#Definitions_include_IndieWeb_relevance
Definitions should include why something is specifically relevant to the IndieWeb. E.g. the jargon example above could be improved with IndieWeb relevance like:
Please also avoid jargonitions, they’re much more harmful in practice than snarkinitions in terms of approachability. We’re ok with not necessarily attracting (or even perhaps detracting?) the Hackernews crowd, much more than scaring away non-developers. Humor at the expense of technology is much more acceptable than making people feel unwelcome with inaccessible text. Document your decisionsOnce 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. Examples:
Documenting your major design and implementation decisions will help you better consider when to revisit them, and when to work on new personal site features and functionality instead. Define jargonAny time someone uses a jargon term in chat, or other indieweb related communications, go ahead and ask in the channel:
This will prompt Loqi to either answer with the definition with the wiki, or to prompt you to define it with a link to create the page on the wiki. You can then define it by clicking on that link, or answer answer the what is question:
See definition for more details on writing good definitions. Tweetable definitionsMain article: definition#Tweetable_definitions
Check the definitions on wiki pages, and edit them so they are tweetable, as there is evidence that people will tweet good definitions that are of tweetable length (including a subsequent link to the page) - that's 257 characters (space + 23 characters for the tco'd link). Progressive disclosure of contentAll pages should start with being the best source for basic knowledge on their subject. Starting with a simple jargon-free Tweetable definition that is understandable by a broader audience, progressively document all the important research and details that are discovered or invented by the community about the subject. And then incrementally document details only as needed for real world reasons / use-cases that provide benefits to those reading. Nearly every page on the wiki can be improved in this regard, to provide progressive disclosure of relevant content. E.g. getting started can (still) be continuously improved in this regard. As can web hosting. Replacing RedirectsWhen editing a redirect (a page which is nothing more than a Common Page StructureMost pages on the wiki have evolved to have a fairly common page structure, starting with a simple definition, and then adding additional sections such as:
For more details on these and more, see: Special Case PagesIn addition to the common structure across many pages, there are also several clusters or instances of special case pages. Standards PagesThe wiki has pages for standards / specifications that were developed on the indieweb wiki, and have started or been formalized at W3C, and thus their pages (and subpages) here have evolved in support of those specifications. While these are rapidly evolving, take a look at: There are also pages that are about the indieweb usage of standards developed elsewhere or in active collaboration across communities, e.g. the pages for various microformats. Though these are generally structured in the common structure noted above, they may as a set have special patterns worth noting: (stub) - help expand this section with documentation of patterns across this type of special page. Historical PagesSome pages help document history, e.g.: (stub) - help expand this section with documentation of patterns across this type of special page. Cross-Generation PagesAs certain IndieWeb building-blocks become more widespread, folks from later generations could benefit from re-organized content. In some cases, it may be beneficial to break out "introductory" content (including high-level explanations, examples with screenshots, tools and services, ...) from "developer" content (such as protocol diagrams, code snippets, brainstorming, ...) For example:
(stub) - help expand this section with documentation of patterns across this type of special page. Fix old wiki linksBefore 2016, this wiki was at indiewebcamp.com, so there are some old links on wiki pages that can be updated. Use this link search to find those pages. Old chat log links are in the format If you update any Example:
General SuggestionsGeneral suggestions for editing the wiki and adding prose. In addition to incremental edits, consider the following:
Related Wikifying ArticlesThe above is very much specific to what is good wikifying for IndieWeb in particular. Here are related articles on good writing, structure, and wikifying in general: What not to contribute to the IndieWeb wikiThe list of things that have been added to the wiki or practices that are not particularly useful or appropriate for the IndieWeb wiki has grown enough for their own section. Start by reading relevant to the IndieWeb wiki. Do not copy from WikipediaPlease do not copy text from Wikipedia, or even just restate the same thing as Wikipedia. Instead, link to the Wikipedia page, perhaps from the See Also section. Do not copy from LLM generated textPlease do not use tools like ChatGPT to write text for the IndieWeb wiki, or otherwise copy text generated by a large language model (LLM). Exception: if there is a good reason to do so (e.g. documenting a problem), you may quote (e.g. using What not to add to See Also sectionsPlease do not add links to See Also sections of articles that are not directly IndieWeb related or from IndieWeb (personal) sites, or at least some sort of reasonably well established news source or topic-specific blog with original content, not summaries of content from other sites (link to original sources instead). Especially don't add links to sites/blogs that such summaries surrounded by ads. Such additions will likely be summarily reverted. What not to add to headingsAvoid hyperlinks in headingsDo not put hyperlinks directly into (sub)headings, put them into the contents of that (sub)heading's section instead. Why: linked headings by convention are typically linked to themselves as a shortcut for accessing a fragment permalink to that section, so when they link elsewhere (especially to another site) it’s a confusing user experience. Avoid punctuation in headingsAvoid putting punctuation in headings, because they create ugly fragments for linking. Instead remove such punctuation such as dashes, commas, or question marks (e.g. in FAQ subheadings), when putting something in a heading, and then put the longer version of such text including punctuation in the content immediately following the heading FAQShould this be on the wikiMain article: relevant to the IndieWeb wiki
Do I have to use the wiki and MediaWiki syntaxIf you want to add content directly to the wiki, then how to edit this wiki is a basic guide. While it's nice to put content into the wiki using standard markup for it, we realize not everyone is a wiki fan, knows how to do it, or even may have the time to learn to do it. (Documenting what you've done is both important and work enough.)
Related chats:
Where should I add something to the wikiWhen you see an IndieWeb related article, post, concept, and want to add it to the wiki, it may not be obvious where to add it, even just as a "See Also". Here are some tips for where to add something:
BrainstormingIdeas for additions to this page. redirects to Wikipedia
Thoughts?
See Also
Retrieved from "https://indieweb.org/wiki/index.php?title=wikifying&oldid=114484" | ||||||||||||
| You are visitor 01402503 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. | ||||||||||||