1 files changed, 46 insertions, 0 deletions
diff --git a/users/wpcarro/README.md b/users/wpcarro/README.md
new file mode 100644
index 000000000000..fdc885be2072
--- /dev/null
+++ b/users/wpcarro/README.md
@@ -0,0 +1,46 @@
+# wpcarro
+
+Welcome to my monorepo.
+
+Herein you will find a variety of libraries, packages, and documents. Some of
+this work in finished and other work is incomplete or just a sketch for a
+future project.
+
+Where applicable, I try to include `README.md` files in some of the
+subdirectories to help orient both myself and any onlookers.
+
+## Sign posts
+
+Below I have outlined a few projects that you might find interesting.
+
+- `boilerplate`: scaffolding for projects. Boilerplate's goal is to reduce the
+  startup costs of a project.
+- `configs`: my dotfiles (e.g. `config.fish`, `init.vim`).
+- `emacs`: Emacs is both my preferred text editor and my window manager; with
+  tens of thousands of lines of Emacs Lisp, you can safely assume that this
+  directory hosts a lot of libraries and packages.
+- `monzo_ynab`: `systemd` timer unit that imports my Monzo (i.e. a U.K.-based
+  online bank) transactions into the personal finance tool YNAB (i.e.
+  youneedabudget.com).
+- `nixos`: my declarative configuration for my NixOS machines. If you are
+  unfamiliar with Nix, I recommend reading about the NixOS project.
+- `tools`: some scripts and projects that simplify my life.
+- `website`: everything required to build my website, https://wpcarro.dev.
+
+## Installation
+
+### Google Machine
+
+- ensure `/google-briefcase` exists
+- read `/google-briefcase/README.md`
+
+### NixOS Machine
+
+- Ensure Nix is installed.
+- Ensure direnv is installed.
+- Ensure `~/.password-store` exists.
+- Transfer GPG stuffs:
+  - old computer: `configs/.gnupg/export.sh $outdir`
+  - new computer: `configs/.gnupg/import.sh <path-to-zip>`
+  from the new machine.
+- Consult `Makefile`.