diff --git a/keyboards/ibm/model_m/yacobo/keymaps/default/keymap.c b/keyboards/ibm/model_m/yacobo/keymaps/default/keymap.c
index ed79f7ddc87..27647d4ed3c 100644
--- a/keyboards/ibm/model_m/yacobo/keymaps/default/keymap.c
+++ b/keyboards/ibm/model_m/yacobo/keymaps/default/keymap.c
@@ -1,6 +1,4 @@
/* Copyright 2021 Stephen Edwards
- *
- * Adapted from the Model H Project by Jonathan Hawthorn.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
@@ -14,6 +12,8 @@
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
+ *
+ * Adapted from the Model H Project by Jonathan Hawthorn.
*/
#include QMK_KEYBOARD_H
diff --git a/keyboards/ibm/model_m/yacobo/keymaps/default/readme.md b/keyboards/ibm/model_m/yacobo/keymaps/default/readme.md
deleted file mode 100644
index f4990c02152..00000000000
--- a/keyboards/ibm/model_m/yacobo/keymaps/default/readme.md
+++ /dev/null
@@ -1 +0,0 @@
-# The default keymap for yacobo
diff --git a/keyboards/ibm/model_m/yacobo/keymaps/sje/keymap.c b/keyboards/ibm/model_m/yacobo/keymaps/sje/keymap.c
deleted file mode 100644
index db1390ba1f3..00000000000
--- a/keyboards/ibm/model_m/yacobo/keymaps/sje/keymap.c
+++ /dev/null
@@ -1,39 +0,0 @@
-/* Copyright 2021 Stephen Edwards
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see .
- */
-#include QMK_KEYBOARD_H
-
-#ifndef _______
-#define _______ KC_TRNS
-#endif
-
-const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
- [0] = LAYOUT_fullsize_ansi_wkl( /* Base layer */
- KC_ESC, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, KC_PSCR, KC_SCROLL_LOCK, KC_PAUS,
- KC_GRV, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_EQL, KC_BSPC, KC_INS, KC_HOME, KC_PGUP, KC_NUM_LOCK, KC_PSLS, KC_PAST, KC_PMNS,
- KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LBRC, KC_RBRC, KC_BSLS, KC_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
- MO(1), KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT, KC_ENT, KC_P4, KC_P5, KC_P6,
- KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_P1, KC_P2, KC_P3, KC_PENT,
- KC_LCTL, KC_LALT, KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT
- ),
- [1] = LAYOUT_fullsize_ansi_wkl( /* Function layer */
- _______, KC_MUTE, KC_VOLD, KC_VOLU, _______, QK_BOOT, _______, _______, _______, _______, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______,
- _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, _______, _______, KC_DEL, _______, _______, _______, KC_CAPS, _______, _______, _______,
- _______, _______, KC_UP, _______, _______, _______, KC_HOME, KC_PGDN, KC_PGUP, KC_END, _______, _______, _______, KC_INS, _______, _______, _______, _______, _______, _______, _______,
- MO(1), KC_LEFT, KC_DOWN, KC_RIGHT, _______, _______, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT, _______, _______, _______, _______, _______, _______,
- KC_CAPS, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_VOLU, _______, _______, _______, _______,
- KC_LCTL, KC_LCMD, _______, KC_RGUI, _______, _______, KC_VOLD, _______, _______, _______
- ),
-};
diff --git a/keyboards/ibm/model_m/yacobo/keymaps/sje/readme.md b/keyboards/ibm/model_m/yacobo/keymaps/sje/readme.md
deleted file mode 100644
index f4990c02152..00000000000
--- a/keyboards/ibm/model_m/yacobo/keymaps/sje/readme.md
+++ /dev/null
@@ -1 +0,0 @@
-# The default keymap for yacobo
diff --git a/keyboards/ibm/model_m/yacobo/readme.md b/keyboards/ibm/model_m/yacobo/readme.md
index 1590f291b30..3a7e8968e57 100644
--- a/keyboards/ibm/model_m/yacobo/readme.md
+++ b/keyboards/ibm/model_m/yacobo/readme.md
@@ -1,16 +1,30 @@
# yacobo
+
+
+*A replacement qmk-compatible control board for the 101-key Model M keyboards.
+Inspired by and based on the ModelH by jhawthorn, with the primary difference
+being the use of 100% through-hole components (including the widely available
+STM32F103C8T6 "Blue Pill" development board) for ease of assembly by hobbyists.*
+
* Keyboard Maintainer: [Stephen Edwards](https://github.com/sje-mse)
* Hardware Supported: IBM 101-key Model M with Yacobo replacement control boards.
+* Hardware Availability: [Yacobo PCB](https://github.com/sje-mse/yacobo).
-Based on ModelH by jhawthorn.
+Make example for this keyboard (after setting up your build environment):
-# Build Directions
+ make yacobo:default
-1. Set up a QMK build environment
-2. Copy the contents of this "firmware" folder to a new folder `qmk_firmware/keyboards/yacobo`
-3. Connect a suitable STM32F103C8T6 Blue Pill device with stmduino firmware.
-4. qmk compile yacobo:default
-5. qmk flash yacobo:default
+Flashing example for this keyboard:
+
+ make yacobo:default:flash
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
+
+## Bootloader
+
+Enter the bootloader in 3 ways:
+
+* **Bootmagic reset**: Hold down the key at (0,0) in the matrix (usually the top left key or Escape) and plug in the keyboard
+* **Physical reset button**: Press the "Reset" button on the Blue Pill daughterboard.
+* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available