New Device page

This page contains a guide for creating a new device page, or for improving existing pages.

=Goals=

The goal of a device page is not only to gather information about a device, but to clearly present the necessary information to the user. A page filled with marketing mumble, even when there is some valuable information in there, is just as useful as no page at all.

So please, try to keep structure and presentation tight, and provide the relevant information in the relevant sections. Further down, an example page, which can simply be copied, is provided, which should help you create a useful device page.

=Legal=

All contributions to linux-sunxi.org are considered to be released under the Creative Commons Attribution (see sunxi:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here. You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

Under no circumstances should you include pictures or documents that were not created by yourself. Either you get the express permission of the owner of the material, or you should use a link.

Similarly, unless you get express permission to reproduce certain information verbatim, you should not copy external information or howtos. If you do, either get permission from the original author, or make sure that it is a complete rewrite/rephrasing of the original document.

=Featured Community or Open Source hardware=

The sunxi project rewards those companies that are actively working with the sunxi community, not only by providing guidance and software development, but also by clearly showing what hardware is either Open Source, or hardware that was created in close cooperation with the sunxi community.

If you are a device manufacturer, then simply adding your board to our wiki does not mean that it is community hardware. Similarly, plainly adding an OSHW logo to your silkscreen does not make your hardware open source.

=Page naming=

Before you do anything else, try to determine whether your device is also available under other names (as described in our New Device Howto.

If the original manufacturer and device name can be retrieved (which only rarely is possible for cheap chinese devices), then that should be used. Failing that, try to name the page according to either the most popular name, or the name under which it was first marketed.

If your device is a plain rebadge job, then just add the name of your device to the "Similar Devices" section of an already existing page. If your device shares the motherboard, but has different hardware included, then create a new page, but frequently mention and crosslink to the existing device page.

As for page naming, put the manufacturer name at the front, followed by the device name. Use underscores instead of spaces.

=Starting point=

A good starting point for a device page is the Device Page Example. This contains a clear and useful structure, and gives the device pages a clear and uniform look.

Open the Device Page Example, and copy the contents of the Edit field to your newly created device page. Then flesh out the different parts.

=Guidelines for different fields=

Infobox
All possible fields, and some examples of content, are included in the Device Page Example. Fields that do not apply for your device can be removed, and will subsequently not turn up in your infobox.

Identification
Because many tablets are hard to identify going from the outside alone, this section should list how to identify a given device from within Android. This usually means going to Settings and under About tablet" you will find 'Model Number and Build number.

These values are set by software, so it is possible that physically completely equal devices have different values in these sections. It is fine to list multiple entries in this section.

If you are running Cyanogenmod, then your settings will not be useful. So please only provide the values for the stock image, or do not provide values at all.

Sunxi support
This is perhaps the most important section of any device page. Here the reader should be informed about the status of support of the device, and given concise information on how to set-up things on their device.

Try to refer to existing guides, and point out the device specific differences in your device page.

Please limit the explanations here to only the bare minimum. Add changes or suggestions, which are nice to have, but not absolutely necessary to the Tips, Tricks, Caveats section.

Tips, Tricks, Caveats
This section should add more information on top of the basics which were described in the above section. It should be a grab bag of many things that are device specific but which might interest others, be it hardware or software.

Adding a serial port
Here you should always provide a picture of the serial port pins or pads, and you should always reference our UART howto.

Pictures
This section should provide all the pictures anyone could need for successful identification of the device. For tablets, make sure that you also have the back and the buttons/connectors, as all tablets pretty much look the same from the front. It also really pays to open up the device and provide interior and PCB pictures.

Note that if you are not the author of the pictures, that they are licensed that allows distribution. So do not pluck pictures of the interweb, take them yourself.

Also known as
This section should list the manufacturers and names of rebadged devices. Spend a bit of time on google for this.

Categories
You need to always keep the Devices category.

Main categories make sure that the device is properly listed on the front page. Possible options for main categories are:

These categories add further information, which currently seems unused:

The NDH_TODO category should be kept until the page is fully filled and all patches have been committed. This allows for easier tracking of which devices/pages need help still.