AutoYADM commit: 2025-07-28 13:16:59

.config/kak/README.md

@@ -1,9 +1,11 @@
 <h1>Daniel's Personal `kakrc`</h1>
 
 This is my personal Kakoune configuration. I use autoyadm to keep the upstream
-repository up-to-date. I'll do my best to document everything, but note that
-this document may be out-of-date at any given time -- my configuration tends to
-evolve quickly.
+repository up-to-date.
+
+> [!NOTE]
+> My configuration tends to change pretty often. Please assume that **any** of
+> what's written here could be out of date at any given moment.
 
 <!--toc:start-->
 
@@ -43,6 +45,9 @@ been separated into other repositories. Check
   any load order_).
 - [`scripts`](./scripts) contains scripts written in formats other than Kakoune.
 - [`autoload`](#autoload) contains everything that isn't in `kakrc`.
+- [`extra`](./extra.kak) contains load logic for commands and functionality that
+  have external dependencies. It's convenient to group them here because I can
+  conditionally choose _not_ to source this file, such as on remote servers.
 
 ### Autoload
 
@@ -52,8 +57,6 @@ been separated into other repositories. Check
 - `detection` contains patched versions of standard RC files.
 - `filetype` contains custom filetype support.
 - `fishr` is a module for writing expansions in `fish` shell.
-- `bootstrap.kak` installs external dependencies of my configuration. Untested
-  and likely out-of-date.
 - `byline.kak` is a fork of a plugin adding Helix-like `x` and `X` commands.
 - `clipboard.kak` has `wl-clipboard` integration.
 - `colemak.kak` rebinds defaults according to my preferences as a Colemak-DH