800ec55dfc
* redo make args to use colons, better folder structuring system [skip ci] * don't put spaces after statements - hard lessons in makefile development * fix-up some other rules.mk * give travis a chance * reset KEYMAPS variable * start converting keyboards to new system * try making all with travis * redo make args to use colons, better folder structuring system [skip ci] * don't put spaces after statements - hard lessons in makefile development * fix-up some other rules.mk * give travis a chance * reset KEYMAPS variable * start converting keyboards to new system * try making all with travis * start to update readmes and keyboards * look in keyboard directories for board.mk * update visualizer rules * fix up some other keyboards/keymaps * fix arm board ld includes * fix board rules * fix up remaining keyboards * reset layout variable * reset keyboard_layouts * fix remainging keymaps/boards * update readmes, docs * add note to makefile error * update readmes * remove planck keymap warnings * update references and docs * test out tarvis build stages * don't use stages for now * don't use stages for now
42 lines
1.8 KiB
Markdown
42 lines
1.8 KiB
Markdown
# Documentation Templates
|
|
|
|
This page documents the templates you should use when submitting new Keymaps and Keyboards to QMK.
|
|
|
|
## Keymap `readme.md` Template
|
|
|
|
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.
|
|
|
|
Below the image you should write a short description to help people understand your keymap.
|
|
|
|
```
|
|
|
|
|
|
# Default Clueboard Layout
|
|
|
|
This is the default layout that comes flashed on every Clueboard. For the most
|
|
part it's a straightforward and easy to follow layout. The only unusual key is
|
|
the key in the upper left, which sends Escape normally, but Grave when any of
|
|
the Ctrl, Alt, or GUI modifiers are held down.
|
|
```
|
|
|
|
## Keyboard `readme.md` Template
|
|
|
|
```
|
|
# Planck
|
|
|
|
|
|
|
|
A compact 40% (12x4) ortholinear keyboard kit made and sold by OLKB and Massdrop. [More info on qmk.fm](http://qmk.fm/planck/)
|
|
|
|
Keyboard Maintainer: [Jack Humbert](https://github.com/jackhumbert)
|
|
Hardware Supported: Planck PCB rev1, rev2, rev3, rev4, Teensy 2.0
|
|
Hardware Availability: [OLKB.com](https://olkb.com), [Massdrop](https://www.massdrop.com/buy/planck-mechanical-keyboard?mode=guest_open)
|
|
|
|
Make example for this keyboard (after setting up your build environment):
|
|
|
|
make planck/rev4:default
|
|
|
|
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.
|
|
```
|
|
|
|
There needs to be two spaces at the end of the `Keyboard Maintainer` and `Hardware Supported` lines for it to render correctly with Markdown.
|