mirror of
https://github.com/qmk/qmk_firmware.git
synced 2024-11-22 03:19:24 +00:00
Merge remote-tracking branch 'origin/master' into develop
This commit is contained in:
commit
5f8aaf236f
2
.github/ISSUE_TEMPLATE/config.yml
vendored
2
.github/ISSUE_TEMPLATE/config.yml
vendored
@ -1,7 +1,7 @@
|
|||||||
blank_issues_enabled: false
|
blank_issues_enabled: false
|
||||||
contact_links:
|
contact_links:
|
||||||
- name: QMK Discord
|
- name: QMK Discord
|
||||||
url: https://discord.gg/Uq7gcHh
|
url: https://discord.gg/qmk
|
||||||
about: Ask questions, discuss issues and features. Chill.
|
about: Ask questions, discuss issues and features. Chill.
|
||||||
- name: OLKB Subreddit
|
- name: OLKB Subreddit
|
||||||
url: https://www.reddit.com/r/olkb
|
url: https://www.reddit.com/r/olkb
|
||||||
|
@ -31,4 +31,4 @@ Commenting on your pull request and being responsive to questions, comments, and
|
|||||||
|
|
||||||
### Ask for Help
|
### Ask for Help
|
||||||
|
|
||||||
Having your submission flagged may have caught you off guard. If you find yourself intimidated or overwhelmed, let us know. Comment on your pull request, or [reach out to the QMK team on Discord](https://discord.gg/Uq7gcHh).
|
Having your submission flagged may have caught you off guard. If you find yourself intimidated or overwhelmed, let us know. Comment on your pull request, or [reach out to the QMK team on Discord](https://discord.gg/qmk).
|
||||||
|
@ -11,7 +11,7 @@ Third-party contributions help us grow and improve QMK. We want to make the pull
|
|||||||
|
|
||||||
## I Don't Want to Read This Whole Thing! I Just Have a Question!
|
## I Don't Want to Read This Whole Thing! I Just Have a Question!
|
||||||
|
|
||||||
If you'd like to ask questions about QMK you can do so on the [OLKB Subreddit](https://reddit.com/r/olkb) or on [Discord](https://discord.gg/Uq7gcHh).
|
If you'd like to ask questions about QMK you can do so on the [OLKB Subreddit](https://reddit.com/r/olkb) or on [Discord](https://discord.gg/qmk).
|
||||||
|
|
||||||
Please keep these things in mind:
|
Please keep these things in mind:
|
||||||
|
|
||||||
@ -29,7 +29,7 @@ QMK is largely written in C, with specific features and parts written in C++. It
|
|||||||
|
|
||||||
# Where Can I Go for Help?
|
# Where Can I Go for Help?
|
||||||
|
|
||||||
If you need help you can [open an issue](https://github.com/qmk/qmk_firmware/issues) or [chat on Discord](https://discord.gg/Uq7gcHh).
|
If you need help you can [open an issue](https://github.com/qmk/qmk_firmware/issues) or [chat on Discord](https://discord.gg/qmk).
|
||||||
|
|
||||||
# How Do I Make a Contribution?
|
# How Do I Make a Contribution?
|
||||||
|
|
||||||
@ -128,7 +128,7 @@ We also ask that you follow these guidelines:
|
|||||||
|
|
||||||
Before you put a lot of work into building your new feature you should make sure you are implementing it in the best way. You can get a basic understanding of QMK by reading [Understanding QMK](understanding_qmk), which will take you on a tour of the QMK program flow. From here you should talk to us to get a sense of the best way to implement your idea. There are two main ways to do this:
|
Before you put a lot of work into building your new feature you should make sure you are implementing it in the best way. You can get a basic understanding of QMK by reading [Understanding QMK](understanding_qmk), which will take you on a tour of the QMK program flow. From here you should talk to us to get a sense of the best way to implement your idea. There are two main ways to do this:
|
||||||
|
|
||||||
* [Chat on Discord](https://discord.gg/Uq7gcHh)
|
* [Chat on Discord](https://discord.gg/qmk)
|
||||||
* [Open an Issue](https://github.com/qmk/qmk_firmware/issues/new)
|
* [Open an Issue](https://github.com/qmk/qmk_firmware/issues/new)
|
||||||
|
|
||||||
Feature and Bug Fix PRs affect all keyboards. We are also in the process of restructuring QMK. For this reason it is especially important for significant changes to be discussed before implementation has happened. If you open a PR without talking to us first please be prepared to do some significant rework if your choices do not mesh well with our planned direction.
|
Feature and Bug Fix PRs affect all keyboards. We are also in the process of restructuring QMK. For this reason it is especially important for significant changes to be discussed before implementation has happened. If you open a PR without talking to us first please be prepared to do some significant rework if your choices do not mesh well with our planned direction.
|
||||||
|
@ -184,7 +184,7 @@ Whenever possible you should customize your keyboard by using `process_record_*(
|
|||||||
|
|
||||||
### Example `matrix_scan_*` Implementation
|
### Example `matrix_scan_*` Implementation
|
||||||
|
|
||||||
This example has been deliberately omitted. You should understand enough about QMK internals to write this without an example before hooking into such a performance sensitive area. If you need help please [open an issue](https://github.com/qmk/qmk_firmware/issues/new) or [chat with us on Discord](https://discord.gg/Uq7gcHh).
|
This example has been deliberately omitted. You should understand enough about QMK internals to write this without an example before hooking into such a performance sensitive area. If you need help please [open an issue](https://github.com/qmk/qmk_firmware/issues/new) or [chat with us on Discord](https://discord.gg/qmk).
|
||||||
|
|
||||||
### `matrix_scan_*` Function Documentation
|
### `matrix_scan_*` Function Documentation
|
||||||
|
|
||||||
|
@ -40,7 +40,7 @@ That's amazing! We would love to assist you with that!
|
|||||||
|
|
||||||
In fact, we have a [whole page](https://qmk.fm/powered/) dedicated to adding QMK Branding to your page and keyboard. This covers pretty much everything you need (knowledge and images) to officially support QMK.
|
In fact, we have a [whole page](https://qmk.fm/powered/) dedicated to adding QMK Branding to your page and keyboard. This covers pretty much everything you need (knowledge and images) to officially support QMK.
|
||||||
|
|
||||||
If you have any questions about this, open an issue or head to [Discord](https://discord.gg/Uq7gcHh).
|
If you have any questions about this, open an issue or head to [Discord](https://discord.gg/qmk).
|
||||||
|
|
||||||
## What Differences Are There Between QMK and TMK?
|
## What Differences Are There Between QMK and TMK?
|
||||||
|
|
||||||
|
@ -231,7 +231,7 @@ Once you have confirmed that the keyboard is working, if you have used a seperat
|
|||||||
|
|
||||||
If you found this fullfilling you could experiment by adding additional features such as [in switch LEDs](https://geekhack.org/index.php?topic=94258.0), [in switch RGB](https://www.reddit.com/r/MechanicalKeyboards/comments/5s1l5u/photoskeyboard_science_i_made_a_handwired_rgb/), [RGB underglow](https://medium.com/@DavidNZ/hand-wired-custom-keyboard-cdd14429c7b3#.7a1ovebsk) or even an [OLED display!](https://www.reddit.com/r/olkb/comments/5zy7og/adding_ssd1306_oled_display_to_your_build/)
|
If you found this fullfilling you could experiment by adding additional features such as [in switch LEDs](https://geekhack.org/index.php?topic=94258.0), [in switch RGB](https://www.reddit.com/r/MechanicalKeyboards/comments/5s1l5u/photoskeyboard_science_i_made_a_handwired_rgb/), [RGB underglow](https://medium.com/@DavidNZ/hand-wired-custom-keyboard-cdd14429c7b3#.7a1ovebsk) or even an [OLED display!](https://www.reddit.com/r/olkb/comments/5zy7og/adding_ssd1306_oled_display_to_your_build/)
|
||||||
|
|
||||||
There are a lot of possibilities inside the firmware - explore [docs.qmk.fm](https://docs.qmk.fm) for a full feature list, and dive into the different keyboards to see how people use all of them. You can always stop by [the OLKB subreddit](https://reddit.com/r/olkb) or [QMK Discord](https://discord.gg/Uq7gcHh) for help!
|
There are a lot of possibilities inside the firmware - explore [docs.qmk.fm](https://docs.qmk.fm) for a full feature list, and dive into the different keyboards to see how people use all of them. You can always stop by [the OLKB subreddit](https://reddit.com/r/olkb) or [QMK Discord](https://discord.gg/qmk) for help!
|
||||||
|
|
||||||
## Links to Other Guides
|
## Links to Other Guides
|
||||||
|
|
||||||
|
@ -32,7 +32,7 @@ There are a lot of ways you can contribute to the QMK Community. The easiest way
|
|||||||
|
|
||||||
* Help people out on our forums and chat rooms:
|
* Help people out on our forums and chat rooms:
|
||||||
* [/r/olkb](https://www.reddit.com/r/olkb/)
|
* [/r/olkb](https://www.reddit.com/r/olkb/)
|
||||||
* [Discord Server](https://discord.gg/Uq7gcHh)
|
* [Discord Server](https://discord.gg/qmk)
|
||||||
* Contribute to our documentation by clicking "Edit This Page" at the bottom
|
* Contribute to our documentation by clicking "Edit This Page" at the bottom
|
||||||
* [Report a bug](https://github.com/qmk/qmk_firmware/issues/new/choose)
|
* [Report a bug](https://github.com/qmk/qmk_firmware/issues/new/choose)
|
||||||
* [Open a Pull Request](contributing)
|
* [Open a Pull Request](contributing)
|
||||||
|
@ -15,7 +15,7 @@ Different keyboards have different ways to enter this special mode. If your PCB
|
|||||||
* Press the physical `RESET` button, usually located on the underside of the PCB
|
* Press the physical `RESET` button, usually located on the underside of the PCB
|
||||||
* Locate header pins on the PCB labeled `RESET` and `GND`, and short them together while plugging your PCB in
|
* Locate header pins on the PCB labeled `RESET` and `GND`, and short them together while plugging your PCB in
|
||||||
|
|
||||||
If you've attempted all of the above to no avail, and the main chip on the board says `STM32` or `RP2-B1` on it, this may be a bit more complicated. Generally your best bet is to ask on [Discord](https://discord.gg/Uq7gcHh) for assistance. It's likely some photos of the board will be asked for -- if you can get them ready beforehand it'll help move things along!
|
If you've attempted all of the above to no avail, and the main chip on the board says `STM32` or `RP2-B1` on it, this may be a bit more complicated. Generally your best bet is to ask on [Discord](https://discord.gg/qmk) for assistance. It's likely some photos of the board will be asked for -- if you can get them ready beforehand it'll help move things along!
|
||||||
|
|
||||||
Otherwise, you should see a message in yellow, similar to this in QMK Toolbox:
|
Otherwise, you should see a message in yellow, similar to this in QMK Toolbox:
|
||||||
|
|
||||||
@ -129,4 +129,4 @@ Congrats! Your custom firmware has been programmed to your keyboard and you're r
|
|||||||
With a little bit of luck everything will work perfectly, but if not there are steps that will help you figure out what's wrong.
|
With a little bit of luck everything will work perfectly, but if not there are steps that will help you figure out what's wrong.
|
||||||
Testing your keyboard is usually pretty straightforward. Press every single key and make sure it sends the keys you expect. You can use [QMK Configurator](https://config.qmk.fm/#/test/)'s test mode to check your keyboard, even if it doesn't run QMK.
|
Testing your keyboard is usually pretty straightforward. Press every single key and make sure it sends the keys you expect. You can use [QMK Configurator](https://config.qmk.fm/#/test/)'s test mode to check your keyboard, even if it doesn't run QMK.
|
||||||
|
|
||||||
Still not working? Browse the FAQ topics for more information, or [chat with us on Discord](https://discord.gg/Uq7gcHh).
|
Still not working? Browse the FAQ topics for more information, or [chat with us on Discord](https://discord.gg/qmk).
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
This is a non-exhaustive checklist of what the QMK Collaborators will be checking when reviewing submitted PRs.
|
This is a non-exhaustive checklist of what the QMK Collaborators will be checking when reviewing submitted PRs.
|
||||||
|
|
||||||
If there are any inconsistencies with these recommendations, you're best off [creating an issue](https://github.com/qmk/qmk_firmware/issues/new) against this document, or getting in touch with a QMK Collaborator on [Discord](https://discord.gg/Uq7gcHh).
|
If there are any inconsistencies with these recommendations, you're best off [creating an issue](https://github.com/qmk/qmk_firmware/issues/new) against this document, or getting in touch with a QMK Collaborator on [Discord](https://discord.gg/qmk).
|
||||||
|
|
||||||
## Requirements for all PRs
|
## Requirements for all PRs
|
||||||
|
|
||||||
|
@ -6,7 +6,7 @@ Please read our [Code of Conduct](https://qmk.fm/coc/) before participating in a
|
|||||||
|
|
||||||
## Realtime Chat
|
## Realtime Chat
|
||||||
|
|
||||||
If you need help with something, the best place to get quick support is going to be on our [Discord Server](https://discord.gg/Uq7gcHh). There is usually somebody online, and there are a bunch of very helpful people there.
|
If you need help with something, the best place to get quick support is going to be on our [Discord Server](https://discord.gg/qmk). There is usually somebody online, and there are a bunch of very helpful people there.
|
||||||
|
|
||||||
## OLKB Subreddit
|
## OLKB Subreddit
|
||||||
|
|
||||||
|
@ -187,5 +187,5 @@ def doctor(cli):
|
|||||||
return 1
|
return 1
|
||||||
else:
|
else:
|
||||||
cli.log.info('{fg_red}Major problems detected, please fix these problems before proceeding.')
|
cli.log.info('{fg_red}Major problems detected, please fix these problems before proceeding.')
|
||||||
cli.log.info('{fg_blue}Check out the FAQ (https://docs.qmk.fm/#/faq_build) or join the QMK Discord (https://discord.gg/Uq7gcHh) for help.')
|
cli.log.info('{fg_blue}Check out the FAQ (https://docs.qmk.fm/#/faq_build) or join the QMK Discord (https://discord.gg/qmk) for help.')
|
||||||
return 2
|
return 2
|
||||||
|
@ -5,7 +5,7 @@ Warning- This is the `develop` branch of QMK Firmware. You may encounter broken
|
|||||||
# Quantum Mechanical Keyboard Firmware
|
# Quantum Mechanical Keyboard Firmware
|
||||||
|
|
||||||
[![Current Version](https://img.shields.io/github/tag/qmk/qmk_firmware.svg)](https://github.com/qmk/qmk_firmware/tags)
|
[![Current Version](https://img.shields.io/github/tag/qmk/qmk_firmware.svg)](https://github.com/qmk/qmk_firmware/tags)
|
||||||
[![Discord](https://img.shields.io/discord/440868230475677696.svg)](https://discord.gg/Uq7gcHh)
|
[![Discord](https://img.shields.io/discord/440868230475677696.svg)](https://discord.gg/qmk)
|
||||||
[![Docs Status](https://img.shields.io/badge/docs-ready-orange.svg)](https://docs.qmk.fm)
|
[![Docs Status](https://img.shields.io/badge/docs-ready-orange.svg)](https://docs.qmk.fm)
|
||||||
[![GitHub contributors](https://img.shields.io/github/contributors/qmk/qmk_firmware.svg)](https://github.com/qmk/qmk_firmware/pulse/monthly)
|
[![GitHub contributors](https://img.shields.io/github/contributors/qmk/qmk_firmware.svg)](https://github.com/qmk/qmk_firmware/pulse/monthly)
|
||||||
[![GitHub forks](https://img.shields.io/github/forks/qmk/qmk_firmware.svg?style=social&label=Fork)](https://github.com/qmk/qmk_firmware/)
|
[![GitHub forks](https://img.shields.io/github/forks/qmk/qmk_firmware.svg?style=social&label=Fork)](https://github.com/qmk/qmk_firmware/)
|
||||||
|
Loading…
Reference in New Issue
Block a user