README.rst: add one for Codeberg's sake

diff --git a/README.rst b/README.rst
new file mode 100644 (file)
index 0000000..09178c9
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,28 @@
+Overview
+========
+
+My personal shell configuration. Used IRL with `BASH
+<https://www.gnu.org/software/bash/>`_, but syntactically compatible
+with `Dash <https://git.kernel.org/pub/scm/utils/dash/dash.git>`_ as
+well.
+
+
+Usage
+=====
+
+Aliases, variables, and functions are organized into ``*.sh``
+files. The easiest way to use them is to "build" the project with
+
+.. code-block:: console
+
+  $ make
+
+This will concatenate ``*.sh`` into one big file called ``all``. Now
+in your ``~/.bashrc`` or equivalent, append the line
+
+.. code-block:: shell
+
+  . /path/to/shell.d.git/all
+
+That's it. Or if you would prefer to use only a subset of the ``*.sh``
+files, only source the ones you need.