I freaking hate wikis.
Note that I’m not talking about things like Wikipedia or Bulbapedia (my two favorite wikis). Those are maintained by fanatics and are generally up to date. As long as you’re not on a controversial article, you’re probably safe to show it to someone to prove that they’re wrong about something.
But wikis need fanatics. They need people that will get het up over proper format for an article, or point out where you need a citation. They need people who are passionate about a certain topic who will haunt their pages and immediately check any change.
You know where we have wikis without fanatics? Our workplaces.
These commons are tragic
I’ve yet to hear of a tech company that operates without some sort of wiki. Maybe they’ve called it something fancier, like an enterprise dynamic document management system, but it’s still a wiki. Everyone can run around editing stuff. It doesn’t matter if you wanted to call it something more business-like. At the end of the day, you have yourself a wiki.
But corporate wikis are like the company fridge. Eventually, they get nasty. You get to the point where you know when someone opened the fridge, because you can smell it down the hall. There are terse emails and passive-aggressive notes, but none of that cleans the fridge. Why?
Because it is everyone’s responsibility, and therefore no one’s responsibility.
And that’s one of the features of wikis that drive me insane. Everyone can edit and maintain pages, so therefore, no one does. The health of the wiki is rent asunder because everyone assumes someone else will take care of the accumulating garbage.
What does a healthy wiki look like?
There are those that insist that wikis will always be a dump, as if this were a feature of wikis themselves. That’s not true. Wikis with fanatics tend to be fairly healthy. They’re more like a fridge with a few suspicious delivery boxes than a full-on disaster area.
So, what are the features of a healthy wiki?
- Search isn’t broken. I should be able to find what I’m searching for with relative ease. I should be able to do this using just a few search terms, and not by breaking out advanced search. Advanced search is a sign things are going wrong.
- The contents are accurate. I shouldn’t have to email someone to find out if a page I found is still accurate. No, a warning that the page is deprecated is not helpful.
- The contents are relevant. Every page should be immediately relevant to at least one user of the company. And not in a ‘gosh, remember when we had that crazy dev set-up’ kind of way. That person should need the information on that page to do their job today.
So how do we get into this mess where our wikis are completely useless? Well, we have some bad habits.
You don’t need to keep everything forever.
You really, really don’t. I swear. No one will care, two years from now, how we had search set up on those test environments that we ended up taking down and never using again.
I know that one of the features of wikis is keeping tons of information in one place, but you know what another feature of wikis is? Page history. If someone really needs to know about that (and you’re following better practices), they can find it.
No one makes sure that what’s there is actually accurate.
I’ve run into this so many times. I find the instructions on how to do something on the wiki. I try them out. They don’t work. I have never had instructions on a corporate wiki work the first time. I usually have to grab someone to figure out what in our crazy set-up is breaking. That’s when I find out that the instructions would never have worked. They either skipped steps, made assumptions, or were completely out of date.
Why was it out of date? Who knows! People either had their own instructions for setting up this feature, had gotten used to the missing steps, or had figured out how to do their job without it. No one passing by ever fixed the instructions, probably because we were so relieved just to have the feature working finally.
You put everything in the wiki. EVERYTHING.
Nothing drives me more mad than looking for the documentation on how Widget X works, only to find nothing but meeting notes about Widget X. Maybe, if I’m lucky, I find the actual documentation about Widget X on the third page of results.
There are so many things that do not belong on the wiki. They clutter search results. They make sections difficult to navigate. They give you more crap to maintain. Your wiki is a dump because you treat it like one!
You let too many people into the wiki.
Many companies have only one wiki. So useful! Everyone can search everyone else’s stuff and find answers across divisions! Oh, and we only have to buy one copy / keep one installation updated.
But this leads to organizational issues. One group may use the wiki as a dumping ground for meeting notes. Another may use it to document how their system works. Yet another might use it to discuss what they might want to include in their architecture. And then there’s that one group that puts cookie recipies up.
Also, the more people you have, the more diffuse the blame. If there are five wiki users (and no fanatics), there’s not that much blame to go around. Everyone has to pitch in. If there’s a hundred? No one is at fault because everyone is microscopically at fault!
You only have one wiki
People. You’ll buy everyone at your company MacBook Pros and Cinema Display monitors, and you won’t stand up one more wiki? Really?
There are free ones and they can be run off a thumb drive. I’m sure you can find the money and hardware somewhere.
So what are the good habits of wiki maintenance? Sure, it would be nice to get some fanatics in here to take care of this for us, but let’s be real. It’s a corporate wiki. We’re going to care more about who’s turn it is to bring in donuts, and what they’re stocking in the soda machine.
Break off into groups
The most effective wiki set-up I ever was immersed in was one where we broke off into groups. Design had their group. The Python people had theirs. Java had their own as well.
We could all check out each others wikis, but for the most part, we worked in our own. This kept the numbers down on each wiki. I believe each one had fewer than a dozen people who were active participants. The one I worked on daily had five people. This meant that there was tons of blame to go around if things went wrong, so we tended to hold our edits to a higher standard.
Decide what goes into the wiki
Maybe a group really does need to keep track of meeting notes forever. That’s fine! That’s a use case for that group, and they can feel free to put those notes in their wiki. Maybe they even have a wiki just for meeting notes.
My group tended to want things such as install instructions and notes on our architecture. We had notes about dealing with production issues, and important contact information. We kept our discussions to our mailing list, our meeting notes on a shared drive, and used our wiki as a snapshot of how stuff works today.
The front page is important
On most wikis, the front page is the most neglected page. Before my old group buckled down, we had:
- Projects that had been canned over a year ago
- Emails for people that had left two years ago
- Mailing lists that had been moved to another service, with a different subscribe email address
- Phone numbers to phones that had been given to other people, sometimes on different contracts.
- For some reason, a previous version of the page, saved beneath the current version of the page, like a dying man clinging to a raft.
My first act in the great razing was to remove all of that and post something more sensible. We had links to important pages within the wiki, but very little information on the page itself that would change. Why would we post that in multiple places and invite entropy in?
Decide on a structure
Structure is highly important. New pages should be made with caution, because every page you create makes the wiki slightly harder to maintain.
If it’s a technical wiki (and not a CYA wiki, which is what I call meeting note wikis), you probably want to have one page for getting your development environment up and running. That page should forever be the go-to for figuring out how to get everything working on your local. Another page might be dedicated to troubleshooting search (note, not SOLR. Search. You may change what you use for search one day).
Basically, the idea is to have every page be the one place to update information about a certain topic. I should be able to bookmark that page and go back to it, and get the most recent information about that topic. That’s how wikis work. How would you feel if you bookmarked the page on, say, Voyager, only to discover that someone had made a page called ‘Voyager - New page’ and started putting updates only on that. There would be a Wikipedia revolt.
History is your friend
You know how we’re just updating that one page with relevant information? That means we have to remove the information that’s no longer relevant. But fear not, wiki citizen. That information is not gone. It’s merely resting in the page history.
Should anyone care how we were doing things a year ago, they can look it up. If they want to see who decided to move remote the database setup from the install instructions, you can check that out. It’s like having the world’s most boring time machine.
No one is fixing that page when they have a deadline
Remember that no one is ever going to stop in the middle of a crisis and start fixing the install instructions. There are fires to be put out, deadlines to meet, and metrics to massage.
So, accept that this is a part of human nature and find a way to work around it. One way you might do this is dedicate time to cleaning out the wiki. Just like you probably ended up assigning someone to clean out the fridge, you’ll probably need someone to run through the wiki to make sure it’s up to snuff. They should verify:
- Any instructions work
- Groups and SME lists don’t reference people who have left
- Phone numbers and emails are accurate
- Working groups are accurate
- The architecture actually reflects what you’re using
You probably want to have this duty rolled around various groups. I strongly recommend a bounty so that it doesn’t get a vague nod before it’s passed on. My office has the ability to pipe in sound. I may ask that our bounty be the ability to pipe in one song of our choice at lunch time.
Note that I’m a remote employee. This makes the option that much more fun, though.
Rune Factory 4: *What* romance options?
I have been mainlining Rune Factory 4 so hard, I've had to take pain meds for my shoulders and hands. Even though I only played through the first ten minutes or so of RF2, I have found myself completely drawn in by a story that largely features the best way to grow turnips, all while saving the world.
That said… content developers? We have to talk about the romance options you gave me.
My warrior woman
I bonded fiercely to my character. You're given the option of man or woman, so I picked the woman, Frey. Solidarity, after all. Also, woman characters get cuter outfits.
Now, at this point in the game, my character is bad ass. She got knocked out of a ship, lost her memory, landed on a dragon, proceeded to sass it, and got herself appointed princess. This is in the first ten minutes.
Several seasons later, she's saved the world, won the love of the townspeople, and amassed a fortune. While solving everyone else's issues, she runs her own farm, makes her own armor, continues to sass at a dragon, and tames massive creatures to do manual labor for her.
Less than a year, this woman has done all this, and shows no sign of stopping? I want to be Frey when I grow up.
A major feature of these games is the idea that you will marry a local and maybe pop out a kid or two. Now, the dialogue in this game is actually quite good, so this was something I was looking forward to. It doesn't hurt that you can date several characters at once with no problem, so it's easy to test the waters without committing. You only have to lock it down when it comes to a ring.
One problem: I don't want any of them.
They're not badly written (they're great!). But when I think of Frey going out with any of these dudes, much less pledging her troth, I feel bad for my badass woman.
Let's go over our options.
This probably would have been the guy that I would have been bending myself backwards to please, fifteen years ago. He's so dark! So moody! But OMG his thought bubbles let me know that he actually secretly likes me! I will give him ALL the carrots!
Now? I have no time for that moody bullshit. He is an outright jerk to you for the first, oh, thirty or so interactions. Frey wrote him off at about interaction ten. At this point, she's just being polite because he's friends or something with the dopey dragon.
Another asshole! Because girls like their dates to warm them up by insulting them!
This one isn't even moody. He's just a jerk. He's arrogant, tossing out barbs even though you saved the god-damn world and pulled him out of oblivion. And worse than that? He assumes you like him! Several times, he tries to railroad you into saying you think his pecs are all that or that you really dig his pantaloons, just so he can tell you that he doesn't think much of you at all.
I seriously contemplated running around with him in the woods, just to watch him die, over and over and over.
Vishnal is a butler in training, and has decided to train on you. He's sweet. He's dedicated. He's a fast learner. He's very obviously into you. He's the kind that would probably do anything to make Frey smile.
That power dynamic, though… It just creeps me out. I'm a world saving princess. He's a fan boy. I just can't see me and Vish one day being on a level playing field. He's more the kind of guy I'd keep on the side so he can clean my feet with his tongue.
I'm just not opening a banking account with him.
Doug was looking at least a little good, until he went off and considered killing my best friend.
Maybe at 20, I would have looked past that. He was just being passionate! He really thought that the dragon had done something bad! I mean, okay, he didn't do any actual research, but Doug's not that kind of guy! He's all heart! You don't know him like I do!
At 33? Nuh-uh. Go dip your stick elsewhere. I'll be hanging with my girl, the dragon, and some people that actually check shit out now and then.
I think Kiel is twelve.
And that leaves us with…
Now, Arthur isn't a bad dude. He's super dedicated to being a prince. He's slow to excite. He uses his resources wisely. He even bows out of being the local hot-shit royalty when he sees that you do it so much better. He accepts gifts with grace, and thankfully, the stuff he likes is super cheap.
Good thing that his gifts are cheap, because it takes forever to get him to look your way. Every other dude, even the guys that were jerks, are way more into Frey than he is, and that was just with me saying 'hey' to them every day. It took a mountain of pickles and eyeglasses (don't ask) to get this guy to even think about moving my name to his little black book.
And once I was there? Good luck actually getting a date with him. Damn workaholics.
Why bother? Because, at the end of the day, he's the one guy who is actually a peer to Frey, he's never been an ass to her, and hell, if I'm going to rule this world, he makes a logical choice. Might as well marry into power, rather than take it by force. We'll leave that for the next empire over.
But GAWD, I just know their sex life is going to involve spreadsheets.
If the bachelorettes were an option…
Life would be so much better. I'd happily tie myself to nearly all of them. There's a kick-ass knight, a talented musician, a butler who doesn't spend all her time fawning over you, and a woman who can talk to ghosts. Such good options! The only faults of the remaining two are the pesky age issue, which I just cannot deal with.
For a while, I thought that they were allowing same-sex relationships, because the women keep flirting with you. But no, alas. My little town is not so forward thinking. Maybe after I bring the bloody revolution, we can get that put right.
Maybe this is part of gaming as a woman who's 30+. I'd really love it if content devs would take a look at the options I get and think "What would someone who is over the emo BS or cutesy shit want?"