How to add a new device to the wiki

Requirements for adding a device

The ConquerOS wiki provides instructions based on the assumption that your device has got its device tree/kernel under the ConquerOS Official Devices GitHub organization. If your device meets both those requirements, follow the instructions below to get your device set up.

Setting up the wiki locally

See contributing using repo for detailed instructions on setting up the wiki locally.

Adding your device

Prepare the required files

There are a few files which need to be there to have a device on the wiki. In order to get them, navigate to $CONQUER_SRC/conquer/wiki/ and run:

./scripts/ your_device

Obviously replace your_device with the codename of your device

Populating the YAML

The sample template has been copied to $CONQUER_SRC/conquer/wiki/_data/devices/your_device.yml. Update the values to match your device. An explanation of some of the options is below:

Additionally there are some optional properties which you might not need, but in case you do, they are documented below:

Adding the device’s image

Find a reasonably high-quality image of your device, and add it to images/devices/<image>.png. The filename must match the entry in your YAML file. Also make sure the background of the image is transparent.

Testing it works

Start the wiki on your local Jekyll server, and navigate to the devices list. Your device should be there. Click on it, and check that the info/install/build pages all seem correct.

Now run the validation:

bundle install
ruby ./test/validate.rb

If the script doesn’t give you an output, all the validated fields have a proper format. Otherwise, read the messages carefully to see which fields have to be corrected.

Submitting your device

After verifying the device-specific pages, commit and upload your changes to Gerrit, and add the “Wiki Editors” group as reviewers.