Laptop_Wiki_Style_Guide

Style Guide

First read the gentoo Manual of Style. This page has information specific to the Laptops section.

• Think before you write. If it seems like you are going into too much detail about a certain operation, search the wiki for a similar description. If needed, clean up that description, and link to it in your article.
• The pages in this section are organized by level. Generic information about laptops goes in the pages under the Laptops section. Make (manufacturer) specific info should go on it's own page, and model specific info in the model specific page. Try and break up the information and put it in the right place as much as possible. See the IBM/Lenovo Section for good examples of the above.
• Do not include any non-standard configuration (For example: do not mention you use the laptop's brightness controls to control volume).
• Do not include entire output of lspci (or similar commands). Usually this is only a lot of unneeded information. include only sections if they are required for the documentation.
• If you need to include config files, please include only the difference between the default and the one you have (use diff command, man diff for help).

Model Specific Templates

These are template suggestions for model specific wiki page. Currently there is no one formal template. The following are the current suggestions. If you have another one, please add it, or Improve the current templates. At some point there will be a poll on the forum.

• Laptop Guide Template

• Laptop Guide Template II