Gentoo Wiki:Article Blueprints/Hardware/Devices

The following is a semi-structured, rough device article blueprint users can copy and paste to create new device articles. In general, it follows the Wiki guidelines (review if necessary). Be aware some information provided in the blueprint may not be needed; wiki contributors know it is easier to delete unneeded content than to type out new content. These sections are typically identified with "Optional section" in the sections leading sentence.


 * Before copying it is possible to demo the Device article blueprint by going here.

Suggestion for the article's Summary field:

(Introductory paragraph goes here. Describe the device. It is okay to mention the device's friendliness to open source drivers. Optionally, it is nice provide a nice summary of why or why not a user would want to buy this device for use with Linux.)

Installation
(Write the necessary steps to get this device running in Gentoo. Try to document any special step that each user will need to reproduce on their system. Includes getting special drivers or firmware from a manufacturer's website, etc. )

Firmware
(Optional section.)

Kernel
(Show what options are necessary in the kernel in order to get all device components functional for this hardware platform.)

Emerge
(Optional section. If the platform requires any user space packages or kernel patches, mention them here).

Configuration
(Explain any additional configuration or special customization for this device. Could be anything from BIOS settings to setting up a service.)

Example 1
(Example: When using Pulse Audio, be sure to select this microphone an as audio source.)

Troubleshooting
(Optional section.)

(Troubleshoot issues in this section. Separate issues by best describing the error with a new section name. Remove this section and subsections if no issues are known.)

Issue 1
(Describe the problem, then describe the solution/workaround to the problem.)

When X happens, Y is how you fix it.

External resources
(Optional section.)


 * (Link to external resources (outside the Wiki) using bullet points in this section. It is common for the information in this section to full sentences that are links.)