Rivendell Wiki:Community Portal
From Rivendell Wiki
The community portal will serve two purposes: to provide a place for large-scale metaconversation about how the site ought to work and be run, and to provide a place for the dissemination of some philosophy about how best to work with the tools and limitations of the wiki site management style.
For now, at least, please treat the suggestions on this page as operational policy, just so we've got one. I'm certainly open to discussion about any aspect thereof, on the talk page.
- Baylink sez: Clearly, I'm not the managing editor of this wiki, as I was on the site where I originally wrote this. But until I get it molded a bit better for here, don't let the phrasing faze you. :-)
Contents |
How To
To make the results of the work we put into this site useful, and to make it easily manageable, some groundrules and suggestions are probably useful.
Sign Up
Everyone who contributes to the site must create an account, and remember to log in to it everytime they do something.
Set Up a User Page
After you've set up an account, go to your user page, and put something in there, so that readers can get a sense of who you are as it relates to this technical domain. This might be as simple as a link to, or copy of, your current CV, or a publication biography, or you can take whatever approach to it you like, as long as it's clear to readers from the material what weight they can reasonably assign to your contributions.
Writing for a Wiki
There's a nice tutorial about how to write for Mediawikiae over at Wikipedia:Tutorial, and a markup syntax guide at Wikipedia:How_to_edit_a_page. Here's the short list of hints:
- Please do *not* use CamelCase linkage when creating new pages; MediaWiki prefers [[free links]], and for several good reasons.
- They look better
- They index better with search engines
- ...
- Favor section headers over bullets, except in tables
- Stack links on a line in tables of contents
- Use --~~~~ to sign comments on talk pages and the like
- Don't put a section header at the top of the page; the material that precedes the first one is the page lede and precedes the table of contents; all pages should have one
- As you're writing, keep your eyes open for words and phrases that should link to their own page for subtopics, or glossary definitions; put the links in even if you don't plan to fill the new pages in (immediately or otherwise).
- Check back here frequently for new hints, as I watch new wiki users make old mistakes. :-)
Oh, and try to remember the old Fidonet rule:
- Be ye not overly annoying, nor too easily annoyed.
Or, in Wikipedia parlance: Assume good faith.
And, finally, if you're feeling helpful and bored, check out Special:Wantedpages to see if there's a topic you can fill in. This is an automagically generated list of links people have left in their contributions which point to pages which don't exist yet. Think of it as the "requests" list, and free free to include such requests in your own material.
If you want to practice, use the Sandbox.
Adding a New Page
Just make a link for it from the main page, with whatever name you like (short names, between 3 and 6 words, are best, except for definition pages, which are usually for 1 to 3 word phrases), and then click through that link.
If you're not sure where to put it in the topic index, put it in "New Material" at the bottom, and someone will come along and move it shortly.
Use the Summary Comments
One of the major strengths of the wiki engine, aside from the easy markup and editing management, is the CVS-like revision tracking system which is built in to the software. The most important part of that is the revision summary comment field below the text edit window.
Please try to put a comment in that, equivalent to what you'd tell CVS when working on code, every time you write or edit a page. It's important. Really. :-)
Talk Pages
Each subject page has a companion Talk page, reachable by the 'Discussion' link at (usually) the top of the page. If you want to hold a meta-discussion about the contents or format of a page, that's the place to go.
User Talk Pages
Each user has a talk page, as well, and they'll be notified when next they log in if you leave a note there for them. This isn't the best format for long, structured discussions, but it's useful for an occasional comment.
Information Taxonomy
If you have a piece to write: write it. Be Bold! If you're not sure where it belongs in the topic tree, don't worry about it, just give it a good 3 to 6 word title and put it under As Yet Unclassified; we'll try to put it in an appropriate place.
Viewpoint
Wikipedia has a policy called NPOV, or Neutral Point Of View to which they encourage writers to adhere. While that might not be the best approach to take on a documentation wiki, it's probably a good place to start. Still, it might be useful, on pages where policy and approach are discussed to separate your approach from that of other posters.
My two initial approaches to this are the commenting protocol started by billn on my other wiki: indent and tag your comments with your user name.
- Baylink says: like this.
And secondly, use level 2 or 3 headers to separate sections which take different approaches to a given topic or subtopic (but keep them all on the same page), and tag them
- Approach: Internetcasting with Rivendell
or
- Case Study: Live to air at WKRP
or whatever. This way, people with differing ideas can make those ideas known without too much conflict (if we're lucky).
Watch Your Topics
And the site in general, come to that. Keep an eye on Special:Recentchanges, and note that that page can be taken as an RSS or Atom feed as well; check the bottom of the right sidebar.
Collected References
And, finally, if you can remember, try to add links to external sites you reference also to the Collected References page.
What Not To
Initally, at least, my goal for this site is to assemble as much raw information as possible, without too much concern as to how it fits into a table of contents. The taxonomy of a wiki site is very malleable, so not as much attention need be paid to how information is laid out when it's created... with one exception: if you're going to go into detail on a subtopic, wiki-link the word or phrase, and put that detail on it's own page. That way, other writers can leverage that writing as glossary-background in their own pages as well.
In fact, if you chose your page name well, they don't even have to look; the information will simply be In The Right Place.
- Baylink says: if you do put in things which are clearly opinion, set them off like this, so it's obvious 'who sez'.
The other thing I'd like everyone who contributes not to do is get upset if I refactor the material you contribute, -- mostly this will be breaking information out onto a subpage, or changing around the master index.
I don't claim to be a wiki or information-architecture expert, but I do have 6-8 months experience watching other people do it, and since I can't run radio stations, I have to do something. :-)
If I change something, and it bothers you, let me know.
What's Next
Original writing is wonderful. Contributions of already-written original material are fine as long as a) you wrote them, and b) you don't object to their being distributed under the wiki's license, the choice of which is still in flux. I'm leaning to dual licensure under the GPL and the CC-WIKI license, and discussion should go here.
Where do we go... from here
Keep the vandals out, or under control ....[1]
