Gentoo Wiki:Article blueprints/Hardware/Laptops

From Gentoo Wiki
Jump to:navigation Jump to:search

The following is a semi-structured, rough laptop blueprint users can copy and paste to create new articles for getting Gentoo working on a specific laptop. In general, it follows the Wiki guidelines (review if necessary). Be sure to substitute the information in the article accordingly, as there can be vast differences between architectures and hardware sets for each laptop. 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 leading sentence.

  • Before copying it is possible to demo the Laptop article blueprint by going here.
Important
Not every laptop article will fit into the outline of this blueprint; it is simply a rough framework to assist in article creation. Modify as needed!

Substitute <Laptop_MAKE_MODEL_NAME> in the text below with the correct make and model of the laptop being covered.

Suggestion for the article's Summary field: Initial creation of the <Laptop_Make_Model_title> article. Show it some love by improving it!

{{ProductPage|Brand (e.g. HP)|laptops|Computer architecture (e.g. AMD64)}}
{{InfoBox stack
|{{InfoBox homepage|https://url/to/hardware/manufacturer's/product/homepage|text=Product Information|header=true}}
|{{InfoBox odoc|https://url/to/hardware/specifications|text=Specifications}}
|{{InfoBox wikipedia|HardwareArticleOnWikipedia|text=Article Title}}
}}

(Introductory paragraph goes here. Describe the hardware. It is okay to mention the hardware platforms 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 hardware for use with Linux.)

== Hardware ==

=== Standard ===

{| class="table table-condensed table-striped" style="width: auto;"
! scope="col" width="20%" | Device
! scope="col" width="20%" | Make/model
! scope="col" width="10%" | Status
! scope="col" width="10%" | Vendor ID / Product ID
! scope="col" width="10%" | Kernel driver(s)
! scope="col" width="10%" | Kernel version
! scope="col" width="20%" | Notes

|- id="cpu"
| CPU
| AMD Phenom(tm) II X4 955
| {{Yes|Works}}
| N/A
| N/A
| 3.18.9
| This CPU rocks!

|- id="front side bus"
| Front side bus
| RD790 Host Bridge
| {{Partial|Not tested}}
| 1002:5956
| pcieport
| 3.18.9
| 

|- id="video card"
| Video card
| NVIDIA Corporation NV18 [GeForce4 MX 4000]
| {{No|Borked}}
| 10de:0185
| nouveau
| 3.18.9
| Note example.
|}

=== Accessories ===

(Optional section. Describe any accessories that may be possible in this section. Anything from external plug-and-play LCD screens to computer docks.)

{| class="table table-condensed table-striped" style="width: auto;"
! scope="col" width="20%" | Device
! scope="col" width="20%" | Make/model
! scope="col" width="10%" | Status
! scope="col" width="10%" | Vendor ID / Product ID
! scope="col" width="10%" | Kernel driver(s)
! scope="col" width="10%" | Kernel version
! scope="col" width="20%" | Notes

|-
| Dock
| ThinkPad Pro Dock
| {{Partial|Not tested}}
| N/A
| N/A
| 3.18.9
| Note example.
|}

=== Detailed information ===

{{RootCmd|collapse-output=true|uname -r|output=<pre>
The command output goes here.
</pre>}}

{{RootCmd|collapse-output=true|lscpu|output=<pre>
The command output goes here.
</pre>}}

{{RootCmd|collapse-output=true|lspci -nnk|output=<pre>
The command output goes here.
</pre>}}

{{RootCmd|collapse-output=true|lsusb|output=<pre>
The command output goes here.
</pre>}}

{{RootCmd|collapse-output=true|lsusb -vt|output=<pre>
The command output goes here.
</pre>}}

== Installation ==

(Write the necessary steps to get Gentoo onto this system. 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 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.)

{{KernelBox|title=Enable support for these hardware drivers|1=

Write menuconfig instructions here.

}}

=== Emerge ===

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

{{Emerge|category/package}}

== Configuration ==

(Explain any additional configuration or special customization for this hardware platform. Could be anything from BIOS settings to assigning proper media key functionality.)

=== Example 1 ===

(Example: Do this in order to get these keys working.)

== 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 ===

When X happens, Y is how you fix it.

== See also ==

<!-- Optional section. Uncomment and point to other articles if used.

* {{See also|Article_name}}
-->

== 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.)

== References ==

(Optional section. Remove this section if references are not used. This section is used to cite factual information. This information is found outside the Gentoo Wiki and used to back up truth claims. The actual references themselves still be littered throughout the main article.)

{{reflist}}