Banshee Documentation

I’ve been working on Banshee documentation on and off for the last few months (ok, more off than on) but as I get more comfortable writing in Mallard and the recent discussion in getting Banshee on the GNOME release cycle I am motivated to get this to done.

The most important part of writing documentation (or writing in general) is the planning phase. A few of us on the Docs team did a first pass at planning the topics that should be in the user help of Banshee in Google Wave, and I’ve copied that over to the GNOME wiki.

If you use Banshee, please give it a look – are there any topics missing that you think a user would want help with? Writing user help in Mallard gives us the ability to organize topics into groups – for a good example, check out the Empathy help. What’s missing? What would you organize differently?

Do you want to help? Have you written about Banshee features before? Let me know – either add content to the wiki page or post a link as a comment on my blog. If you have written a howto for Banshee, we’d love to include it – the new GNOME help is CC 3.0 licensed, so it’s easy to add from other sources, as long as it’s licensed as CC-SA 3.0. Please don’t feel you have to know how to write documentation or use Mallard – you can create a sub-page on the wiki for the topic and I will be more than happy to help edit it, convert it to Mallard and commit to git. Right now the important thing is to make sure we have the topics right and get some first drafts of the actual help created. I appreciate all help and would rather not do it all myself if at all possible!

There is a Banshee Docs branch on Gitorious – if you do know Mallard and want to help let me know and I’ll get you added to the team. If you don’t know Mallard, let’s start writing some howto’s in the wiki!

comments powered by Disqus