Guide to writing guides
That's right. It's a guide for writing guides, in the hopes that you'll write a guide that's better than this guide at the competition.
Format shamelessly stolen from Densetsu and his nicely formatted and well written Japanese guide
Before writing a guide, you must consider what you want to write it on! Consider these points as you ogle over my genius idea for writing a guide.
When writing your guide, there's a few things to remember...
What seems to be the big issue here is the presentation of guides. They often seem sloppy, rushed, and have the quality of an average forum post, not something that a guide should have.
Honestly, everything you need for a well formatted guide can be found when making your post. Use the toolbar up top for your basic text and content management (such as bullet points, hyperlinking, etc). Here's some stuff not covered by the toolbar though.
And please, don't abuse smileys. Adding an overabundance of smileys just makes your guide look amateur and annoying. It's like handing in a college essay with a bunch of stickers on it. It looks unprofessional and is really annoying.
Just links to all the respective guide areas so you can post yours.
Now that your guide is complete, you can post it and thank me for making this guide 'cause I'm awesome.
Format shamelessly stolen from Densetsu and his nicely formatted and well written Japanese guide
Choosing a Subject
Before writing a guide, you must consider what you want to write it on! Consider these points as you ogle over my genius idea for writing a guide.
- Is it an issue that matters?: There's no point writing a guide on something that isn't consistently a problem. For example, I chose to write this guide because of all the poor formatting I've been seeing in guides lately. It was a pressing issue. Choose something that you find is not well covered and important on the forum.
- Is there enough to write it on?: Guides are mostly just looking beefy. If you have a guide with all of five lines, it'll look like a poor subject. Even if you just add a bunch of fluff to it, it's the content that counts! It's better to go too much into a subject than too little!
- Can it be well explained?: There's some things that just are just hard to explain. Maybe it's a subject that's expansive and matters, but if people won't have an idea in the world what you're talking about, it'll be completely useless.
- IF THERE IS A GUIDE FOR IT, IT DOESN'T MEAN IT'S OFF LIMITS!: There's plenty of guides around here, new and old. A lot of guides can be considered outdated or their holders are inactive. Don't be afraid to tackle a guide that's already been done. Thanks to Rydian for this useful tip in another thread.
Writing Your Guide
When writing your guide, there's a few things to remember...
- Your demographic: For GBAtemp, assume that we're all on the level of third graders. I'm not saying that we are (well, some of us are), but you want to make a guide as easy to understand as possible.
- Remember your terminology!: For most any subject, there's terminology that's really only used inside that subject, and can be confusing to anyone outside of it. Trust me, I've entered a few threads around the internet about some subjects that are completely Greek to me. Try to avoid using terminology, and if you need to, explain what it is thoroughly.
- Write concisely!: No one wants to read a lengthy wall of text. Make your steps short and sweet.
- Stay largely unbiased: While you have a right to an opinion, it's better to keep it out (for the most part) in guides. You can definitely say what method you personally prefer or what not, but don't bring trashing and fanboyism into it.
Formatting Your Guide
What seems to be the big issue here is the presentation of guides. They often seem sloppy, rushed, and have the quality of an average forum post, not something that a guide should have.
- USE PROPER GRAMMAR!: One of my biggest peeves on the internet is grammar. I'll forgive it if I'm still able to decipher it, but for something that's supposed to be professional and concise, poor grammar and editing is NOT acceptable. Uppercase when needed, use periods and proper punctuation, spell things right, and don't use abbreviations unless it's needed in the subject at hand (like no one wants to spell out Random Access Memory for RAM).
- Break down the info!: As I said before, walls of text are boring. People will often look for a different guide or abandon the subject completely if the guide is just a big eyesore. Break down the info with bullet points, sections, and spoilers. This will also allow people to easily jump to whatever stage they need to see for the subject at hand.
- Use visual aids!: Some people say a picture is worth a thousand words. So if your subject permits, you may as well save yourself from writing a thousand words and readers from reading a thousand words and use some pictures! There's plenty of times that just showing a picture of something is far easier than explaining it. With almost everyone having a camera somewhere (whether it's an actual camera, a cellphone, your DSi/3DS, whatever), it's inexcusable. Plus you have a forum full of friendly faces who I'm sure will be able to use their ultra pro photography skills to get you some good pictures. Well, ask some people before you make your guide, of course.
- Make it look good!: On top of having an organized guide, you should add some visual flash to it. Make things stand out, make it flow and colorful. Whatever you need to make it look like more than just a bunch of words.
Tools
Honestly, everything you need for a well formatted guide can be found when making your post. Use the toolbar up top for your basic text and content management (such as bullet points, hyperlinking, etc). Here's some stuff not covered by the toolbar though.
Code:
- [P]Insert text here[/P]: It's what you find most User Submitted News posts use for their body text. It looks better than quote tags or code boxes.
- [h]Insert header here[/h]: Adds the nice header you see above.
- [spoiler][title:Insert title here]Insert text here[/spoiler]: Spoilers are nice for making long sections just short. It allows people to open and close that section of text at will. If you don't want a title, then you can omit it.
- [code]Insert code here[/ code] (take away the space): It's a place for code, obviously. It negates normal coding.
And please, don't abuse smileys. Adding an overabundance of smileys just makes your guide look amateur and annoying. It's like handing in a college essay with a bunch of stickers on it. It looks unprofessional and is really annoying.
Guide Sections
Just links to all the respective guide areas so you can post yours.
Now that your guide is complete, you can post it and thank me for making this guide 'cause I'm awesome.