Wiki can take images. In fact, we have one in Beginners Guide. Also, Wikipedia has tons of images.
There’re many advantages of wiki over Google docs:
- The usage of screen real estate. Wiki does a much better job than the narrow viewing area forced by Google or Github or other modern solutions. IMHO, wiki reads much better – in fact, that was the main reason I chose wiki over other solutions.
- Wiki Templates: Docs do go out of shape or are incomplete, or need further improvement, etc. Wiki has a range of templates that can be easily added to reflect those things. Having this in the face of both users and editors helps keep things up to date.
- Wiki notes, tips, warning etc.: Sort of like helpers to templates, they’re a great way to indicate something important and grab the attention of the user.
- Universal edits: Anyone can update the wiki, and it’s designed to be editable by everyone. You can see a list of changes and can approve or deny those. Having wiki enables our users to modify the documentation to fix errors or clarify sentences.
- Section editing: Wiki has this amazing feature by which you can modify only a certain section. From afar, this seems like a small optimization, but as your documentation starts to grow, it becomes a very handy tool allowing you to focus on just one thing and improve it.
- View mode and edit mode: Again helps a lot with being comfortable with the documentation. When reading, you can be sure that no extra keystroke will cause the document to change accidentally. It’s a simple and very useful feature (also Vim operates this way).
Overall, I think Wiki is designed around documentation. Some of the best documentations have been built on Wikis:
OTOH, Google Docs is built as a replacement for Microsoft Word – which is exactly what it does best. I haven’t had a great experience with building world-class documentation with Google Docs.
I’d advise spending some time with the Wiki formatting. It’s very similar to markdown, so you’ll get used to it really fast. The other advantage that Google Docs provides is WYSIWYG editor. I’ve played with that for wiki, but those tend to slow you down instead of speed you up. A simple text editor can do a much better job helping you put your thoughts down – I used Vim to write all of the Wiki documentation.