From 2140ab51deed88e90eafebf9520fa5f9995dc7c9 Mon Sep 17 00:00:00 2001
From: twells46 <173561638+twells46@users.noreply.github.com>
Date: Wed, 31 Dec 2025 13:28:05 -0600
Subject: Migrate from stow

---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..dd8e0c2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Dotfiles
+
+These are my personal dotfiles.
+I do not use all of these programs all the time (that's why there are five different editor configs), so some may be broken or out of date.
+
+## Usage
+
+I manage these using GNU stow.
+Clone this repo into your home directory, then stow whichever configurations you want to use.
+For example, to use the fish config:
+
+```bash
+stow fish
+```
+
+Most of the directories are pretty self-explanatory (just look up the program), but here's a quick explanation of the less obvious ones:
+
+- **service**: `runit` user services managed using `turnstiled`.
+[More info](https://docs.voidlinux.org/config/services/user-services.html).
+- **service-env**: Environment variables for user services.
+- **shell**: Useful environment variables for interactive shell usage.
+This sets the variables for `dash` (user shell), which are inherited by `fish`, which I call explicitly when opening a terminal window (i.e. `st /usr/bin/fish`).
+- **scripts**: Some scripts that I have written and used at various points in time.
+Many of them are only really useful for quick reference, but there are a few actually useful ones.
-- 
cgit v1.2.3