Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
Notes for readers and Guidelines for authors
View unanswered posts
View posts from last 24 hours

 
Reply to topic    Gentoo Forums Forum Index Documentation, Tips & Tricks
View previous topic :: View next topic  
Author Message
Nitro
Bodhisattva
Bodhisattva


Joined: 08 Apr 2002
Posts: 661
Location: San Francisco

PostPosted: Mon Apr 15, 2002 11:47 pm    Post subject: Notes for readers and Guidelines for authors Reply with quote

Notes for readers and Guidelines for authors

Sections
  1. Note to readers
  2. Note to authors
  3. Howto submit your document

1. Note to readers

Readers are not allowed to post in the documentation forum. If you have a question or problem, post it in another forum and reference the document by including a URL along with you question. This should keep this forum to pure reference and keep discussions elsewhere.

The Doucmentation forum is not meant to be a replacement for documentation included at www.gentoo.org. Instead, it is meant to be a centralized location for supplementary documentation and/or documentation to get tested before becoming official and published at Gentoo.org.

If you notice a bug or inconsistency, you are encouraged to notify the author of the document.

2. Note to authors

In an effort to keep all documents represented in a single uniform format I have setup several guidelines:
  1. Put all code and commands in code tags. Example:
    Code:
    emerge -u world --pretend

  2. Put all lists in the list tags. Lists can be bulleted, numbered, or alphabetized; follow the previous link to learn more. Example:
    • /dev/hda
    • /dev/hdb

  3. Use the same title on the top of the page as the message subject, and make the font bold and set the font size to large/18. For more information about formatting fonts go here
  4. Have your document layed out in an organized manor.
  5. Make sure your method works, and be prepared to help those who may have problems using it.
It wouldn't hurt for you to look at all the functions of BBCode, which are written here.

3. Howto submit your document
  1. Make sure you understand all the guidelines mentioned in section two.
  2. Post your document.

_________________
- Kyle Manna

Please, please SEARCH before posting.

There are three kinds of people in the world: those who can count, and those who can't.
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Documentation, Tips & Tricks All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum