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.

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 section.

Tips, Tricks, Caveats
This section should add more information on top of the basics which were described in the above section.

Pictures
This section should list images off the device, while outside images are 'nice', for tablets they become extremely similar and rather boring. PCB images are far more interesting. Note that if you are not the author of the images, that they are licensed that allows distribution.

Similar devices
This section should list the manufacturers and names of rebadged devices.

Related devices could also be mentioned here.

Categories
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: