Blog Post

Howto post a howto

Yes, this is a howto on how you should post your Ubuntu related howto. We can all agree howtos are great, however posting them to a blog that not everyone may read, or at least they may not read it today or this year. That is why the great people within the Ubuntu Documentation Project suggest that you should post it to the Community Documentation Wiki. In order to do so, you must first create an account on Launchpad. Once you have created your account, you are ready to begin editing the wiki pages as well as creating new wiki pages. And just in case you aren’t sure about editing a wiki page, you can always send your text that you would like added to ubuntu-doc (AT) lists.ubuntu.com.

Now time for some howto howto 🙂

Planning

  • Make sure your howto isn’t already on the wiki. If it is, think about how you may better what is already there by clarifying and cleaning up the processes
  • Plan on who you are writing this content for: Beginner, Intermediate, or Advanced
  • Plan on your content
  • Plan on your content layout

Writing

  • Write your content in English first if at all possible. If not possible, see about getting it translated to English first.
  • Make sure you content is understandable, prior to posting, test your howto by following the exact steps you have created. Have others help test it if needed.
  • Add a section at the bottom for feedback, or start a thread in the Ubuntu Forums and link to it for feedback. Remember, what may work for you may not work for others.

Editing and Creating Wiki Pages

  • First thing to do is consider a name for your howto using CamelCase or a Wiki name.
  • Do not use Howto in the title
  • Once you have the name, type it as http://help.ubuntu.com/community/YourHowtoName
  • Use wiki formatting and try to follow and utilize the Wiki Guide at all times
  • If you need help with editing wiki pages, refer to the Help Contents Wiki Page

If you have any questions or comments about editing the wiki pages, please do not hesitate to contact the Ubuntu Documentation Project by the email provided above. Also for good measure, it might be a good idea to subscribe to the Documentation mailing list. You can also catch most of us on IRC in #ubuntu-doc on the Freenode server (chat.freenode.net).

And finally, once you have it posted, feel free to blog about your new creation and link to it here so everyone may enjoy it that is reading today. Thank you for your cooperation and we look forward to the many great howtos you all have brewing inside of you.

Until next time…

This entry was posted in Development and tagged , , . Bookmark the permalink. Post a comment or leave a trackback: Trackback URL.
  • Subscribe to nixternal.com

     Subscribe in a reader

    Or, subscribe via email:
    Enter your email address:

  • Archives


semidetached
semidetached
semidetached
semidetached
%d bloggers like this: