From 33178f1261a4a5e66dbb22ecb7c7f4d3a4caac1c Mon Sep 17 00:00:00 2001 From: Drashna Jaelre Date: Fri, 12 Apr 2019 15:11:44 -0700 Subject: [PATCH 1/4] update readme --- readme.md | 58 +++++++++++++++++++++++++++++++++---------------------- 1 file changed, 35 insertions(+), 23 deletions(-) diff --git a/readme.md b/readme.md index 6e6cfaa1bd10..a22760d2cffd 100644 --- a/readme.md +++ b/readme.md @@ -1,35 +1,47 @@ -# Quantum Mechanical Keyboard Firmware +# ZSA's fork of QMK Firmware -[![Current Version](https://img.shields.io/github/tag/qmk/qmk_firmware.svg)](https://github.com/qmk/qmk_firmware/tags) -[![Build Status](https://travis-ci.org/qmk/qmk_firmware.svg?branch=master)](https://travis-ci.org/qmk/qmk_firmware) -[![Discord](https://img.shields.io/discord/440868230475677696.svg)](https://discord.gg/Uq7gcHh) -[![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 forks](https://img.shields.io/github/forks/qmk/qmk_firmware.svg?style=social&label=Fork)](https://github.com/qmk/qmk_firmware/) +[![Current Version](https://img.shields.io/github/tag/ErgoDox-EZ/qmk_firmware.svg)](https://github.com/ErgoDox-EZ/qmk_firmware/tags) +[![Build Status](https://travis-ci.org/ErgoDox-EZ/qmk_firmware.svg?branch=master)](https://travis-ci.org/ErgoDox-EZ/qmk_firmware) +[![GitHub contributors](https://img.shields.io/github/contributors/ErgoDox-EZ/qmk_firmware.svg)](https://github.com/ErgoDox-EZ/qmk_firmware/pulse/monthly) +[![GitHub forks](https://img.shields.io/github/forks/ErgoDox-EZ/qmk_firmware.svg?style=social&label=Fork)](https://github.com/ErgoDox-EZ/qmk_firmware/) -This is a keyboard firmware based on the [tmk\_keyboard firmware](http://github.com/tmk/tmk_keyboard) with some useful features for Atmel AVR and ARM controllers, and more specifically, the [OLKB product line](https://olkb.com), the [ErgoDox EZ](http://www.ergodox-ez.com) keyboard, and the [Clueboard product line](http://clueboard.co/). - -## Documentation - -* [See the official documentation on docs.qmk.fm](https://docs.qmk.fm) - -The docs are hosted on [Gitbook](https://www.gitbook.com/book/qmk/firmware/details) and [GitHub](/docs/) (they are synced). You can request changes by making a fork and [pull request](https://github.com/qmk/qmk_firmware/pulls), or by clicking the "suggest an edit" link on any page of the docs. +This purpose of this fork is maintain a clean repo that only contains the keyboard code that we need, and as little else as possible. This is to keep it lightweight, since we only need a couple of keyboards, since this is the repo that the EZ Configurator will pull from. ## Supported Keyboards -* [Planck](/keyboards/planck/) -* [Preonic](/keyboards/preonic/) +* [Planck](/keyboards/planck/ez) * [ErgoDox EZ](/keyboards/ergodox_ez/) -* [Clueboard](/keyboards/clueboard/) -* [Cluepad](/keyboards/clueboard/17/) -* [Atreus](/keyboards/atreus/) - -The project also includes community support for [lots of other keyboards](/keyboards/). ## Maintainers QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, [Hasu](https://github.com/tmk). The OLKB product firmwares are maintained by [Jack Humbert](https://github.com/jackhumbert), the Ergodox EZ by [Erez Zukerman](https://github.com/ezuk), the Clueboard by [Zach White](https://github.com/skullydazed), and the Atreus by [Phil Hagelberg](https://github.com/technomancy). -## Official website +This repo is maintained for ZSA Technology Labs, Inc by [Drashna](https://github.com/drashna/), [Erez Zukerman](https://github.com/ezuk), and [Florian]. + +# Update Process + +1. Check out branch from ZSA's master branch: + 1. `git remote add zsa https://github.com/ErgoDox-EZ/qmk_firmware.git` + 2. `git fetch --all` + 3. `git checkout -B branchname zsa/master` + 4. `git push -u zsa branchname` +2. Check for core changes: + - [https://github.com/qmk/qmk_firmware/commits/master/quantum](https://github.com/qmk/qmk_firmware/commits/master/quantum) + - [https://github.com/qmk/qmk_firmware/commits/master/tmk_core](https://github.com/qmk/qmk_firmware/commits/master/tmk_core) + - [https://github.com/qmk/qmk_firmware/commits/master/util](https://github.com/qmk/qmk_firmware/commits/master/util) + - [https://github.com/qmk/qmk_firmware/commits/master/drivers](https://github.com/qmk/qmk_firmware/commits/master/drivers) + - [https://github.com/qmk/qmk_firmware/commits/master/lib](https://github.com/qmk/qmk_firmware/commits/master/lib) + - These folders are the important ones for maintaining the repo and keeping it properly up to date. Most, but not all, changes on this list should be pulled into our repo. +3. `git cherry-pick` the commits we want + - `git rm docs/* -r` to remove the document updates when cherry picking. Repeat for any keyboard/keymap/etc that have changes that we aren't interested in +4. Commit update + * Include commit info in `[changelog.md](http://changelog.md)` +5. Open Pull request, and include information about the commit + +## Strategy + +To keep PRs small and easier to test, they should ideally be 1:1 with commits from QMK Firmware master. They should only group commits if/when it makes sense. Such as multiple commits for a specific feature (split RGB support, for instance) + +## Merging -[http://qmk.fm](http://qmk.fm) is the official website of QMK, where you can find links to this page, the documentation, and the keyboards supported by QMK. +Pull Requests should be merged/rebased, not squashed, so we can maintain a commit history that is close to QMK Firmware's, for ease of reference. From cd1a59c6147ec9173c4aeaabc73a828cddfd892e Mon Sep 17 00:00:00 2001 From: Erez Zukerman Date: Mon, 15 Apr 2019 17:25:01 -0700 Subject: [PATCH 2/4] Update readme.md Co-Authored-By: drashna --- readme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/readme.md b/readme.md index a22760d2cffd..00bcbb8b36e2 100644 --- a/readme.md +++ b/readme.md @@ -5,7 +5,7 @@ [![GitHub contributors](https://img.shields.io/github/contributors/ErgoDox-EZ/qmk_firmware.svg)](https://github.com/ErgoDox-EZ/qmk_firmware/pulse/monthly) [![GitHub forks](https://img.shields.io/github/forks/ErgoDox-EZ/qmk_firmware.svg?style=social&label=Fork)](https://github.com/ErgoDox-EZ/qmk_firmware/) -This purpose of this fork is maintain a clean repo that only contains the keyboard code that we need, and as little else as possible. This is to keep it lightweight, since we only need a couple of keyboards, since this is the repo that the EZ Configurator will pull from. +This purpose of this fork is maintain a clean repo that only contains the keyboard code that we need, and as little else as possible. This is to keep it lightweight, since we only need a couple of keyboards. This is the repo that the EZ Configurator will pull from. ## Supported Keyboards From 8b5c5b5699da1dab56ac5b0d33bcb1ee536cf89a Mon Sep 17 00:00:00 2001 From: Erez Zukerman Date: Mon, 15 Apr 2019 17:25:24 -0700 Subject: [PATCH 3/4] Update readme.md Co-Authored-By: drashna --- readme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/readme.md b/readme.md index 00bcbb8b36e2..562a12a36204 100644 --- a/readme.md +++ b/readme.md @@ -14,7 +14,7 @@ This purpose of this fork is maintain a clean repo that only contains the keyboa ## Maintainers -QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, [Hasu](https://github.com/tmk). The OLKB product firmwares are maintained by [Jack Humbert](https://github.com/jackhumbert), the Ergodox EZ by [Erez Zukerman](https://github.com/ezuk), the Clueboard by [Zach White](https://github.com/skullydazed), and the Atreus by [Phil Hagelberg](https://github.com/technomancy). +QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, [Hasu](https://github.com/tmk). The ZSA branch is maintained by Drashna, ZSA's official QMK Liaison, and by Florian Didron, ZSA's lead developer, with input from Erez Zukerman (ZSA CEO). This repo is maintained for ZSA Technology Labs, Inc by [Drashna](https://github.com/drashna/), [Erez Zukerman](https://github.com/ezuk), and [Florian]. From 1fa1feec59f4a8bffab6ff66ebf1867e4c9a80f0 Mon Sep 17 00:00:00 2001 From: Erez Zukerman Date: Mon, 15 Apr 2019 17:26:03 -0700 Subject: [PATCH 4/4] Update readme.md Co-Authored-By: drashna --- readme.md | 1 - 1 file changed, 1 deletion(-) diff --git a/readme.md b/readme.md index 562a12a36204..ff8ce3731e52 100644 --- a/readme.md +++ b/readme.md @@ -16,7 +16,6 @@ This purpose of this fork is maintain a clean repo that only contains the keyboa QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, [Hasu](https://github.com/tmk). The ZSA branch is maintained by Drashna, ZSA's official QMK Liaison, and by Florian Didron, ZSA's lead developer, with input from Erez Zukerman (ZSA CEO). -This repo is maintained for ZSA Technology Labs, Inc by [Drashna](https://github.com/drashna/), [Erez Zukerman](https://github.com/ezuk), and [Florian]. # Update Process