]> git.donarmstrong.com Git - qmk_firmware.git/blob - docs/documentation_templates.md
Keyboard: Update KEYMAP to LAYOUT for ckeys obelus (#3495)
[qmk_firmware.git] / docs / documentation_templates.md
1 # Documentation Templates
2
3 This page documents the templates you should use when submitting new Keymaps and Keyboards to QMK.
4
5 ## Keymap `readme.md` Template
6
7 Most keymaps have an image depicting the layout. You can use [Keyboard Layout Editor](http://keyboard-layout-editor.com) to create an image. Upload it to [Imgur](http://imgur.com) or another hosting service, please do not include images in your Pull Request.
8
9 Below the image you should write a short description to help people understand your keymap.
10
11 ```
12 ![Clueboard Layout Image](http://i.imgur.com/7Capi8W.png)
13
14 # Default Clueboard Layout
15
16 This is the default layout that comes flashed on every Clueboard. For the most
17 part it's a straightforward and easy to follow layout. The only unusual key is
18 the key in the upper left, which sends Escape normally, but Grave when any of
19 the Ctrl, Alt, or GUI modifiers are held down.
20 ```
21
22 ## Keyboard `readme.md` Template
23
24 ```
25 # Planck
26
27 ![Planck](http://i.imgur.com/q2M3uEU.jpg)
28
29 A compact 40% (12x4) ortholinear keyboard kit made and sold by OLKB and Massdrop. [More info on qmk.fm](http://qmk.fm/planck/)
30
31 Keyboard Maintainer: [Jack Humbert](https://github.com/jackhumbert)  
32 Hardware Supported: Planck PCB rev1, rev2, rev3, rev4, Teensy 2.0  
33 Hardware Availability: [OLKB.com](https://olkb.com), [Massdrop](https://www.massdrop.com/buy/planck-mechanical-keyboard?mode=guest_open)
34
35 Make example for this keyboard (after setting up your build environment):
36
37     make planck/rev4:default
38
39 See [build environment setup](https://docs.qmk.fm/build_environment_setup.html) then the [make instructions](https://docs.qmk.fm/make_instructions.html) for more information.
40 ```
41
42 There needs to be two spaces at the end of the `Keyboard Maintainer` and `Hardware Supported` lines for it to render correctly with Markdown.