Update README.md

and fix example revbank.accounts

README.md

@@ -1,9 +1,20 @@
 # revbank - Banking for hackerspace visitors
 
+## Using revbank (for end users)
+
+Type `help`.
+
+Even more helpful text is available on the [the RevBank page on the RevSpace
+wiki](https://revspace.nl/RevBank).
+
 ## Upgrading
 
-When upgrading from a previous version, please refer to the file [UPGRADING.md](UPGRADING.md)
+When upgrading from a previous version, please refer to the file
-because there might be incompatible changes that require your attention.
+[UPGRADING.md](UPGRADING.md) because there might be incompatible changes that
+require your attention.
+
+In general, upgrading is done by committing any changed files and then doing a
+`git pull`.
 
 ## Installing
 
@@ -16,11 +27,49 @@ Generic: cpan Term::ReadLine::Gnu
 
 2. Clone the repository, run revbank :)
 
-## Using revbank
+## Configuring
 
-Type `help`.
+`revbank` uses data files from the _working directory_ from which it runs. You
+can use that to your advantage, if you don't want to change anything in your
+git working tree - in that case, copy `revbank.*` to the intended working
+directory, and symlink `plugins`. But you can also just change the files and
+deal with merge conflicts later, if you prefer.
 
-Even more helpful text is available on the [the RevBank page on the RevSpace wiki](https://revspace.nl/RevBank).
+*RevBank just works out of the box* if you're in a hurry, but there's a lot you
+could customize.
+
+- `revbank.plugins`: enable or disable plugins here.
+- `revbank.accounts`: if you're migrating from another system, you can add the
+  existing account balances here. Only the first two columns are mandatory
+  (account name and balance). Editing the accounts file when revbank is in
+  active use is not recommended because you might overwrite the effect of the
+  latest transactions, but you can maybe get away with it if you're fast
+  enough.
+- `revbank.products`: list your products here; the first column is a comma
+  separated (no space after the comma!) list of product codes. Only the
+  description makes it into the logs so make it sufficiently unique.
+- `plugins/deposit_methods`: if you want to enable this plugin (which is highly
+  recommended!), at least change the bank account number. When customizing
+  plugins, you can either copy the file and use your own, or edit the existing
+  file and deal with merge conflicts later. Either way you'll have to pay
+  attention to changes when upgrading.
+
+After changing `revbank.plugins` or any of the actual plugin files, you'll need
+to restart `revbank`. The easiest way to do that is ctrl+D. No restart is
+required after editing `revbank.products`, `revbank.market`, or
+`revbank.accounts`.
+
+If your terminal is unable to beep, e.g. if it's Linux console on a Raspberry
+Pi, copy the `beep_terminal` plugin to a new file, and figure out another way
+to play a sound or make a light flash. This is optional, but in general it's
+useful to have something that alerts users to the mistakes they make. An
+audible bell works better than a visual effect, but why not both?
+
+### Cash box
+
+If you want RevBank to indicate how much money it thinks the cash box should
+contain after every cash transaction, you'll probably want to enable the
+plugins `deposit_methods`, `cash`, and `skim`.
 
 ## Writing plugins
 

revbank.accounts

@@ -1,5 +1,2 @@
 juerd              +163.48 2022-06-04_02:19:56 +@2021-12-03_18:27:54
 bla                 -36.00 2022-01-19_17:11:25 -@2022-01-19_17:00:43
- 0.00 2022-06-11_16:47:33
-fooooo 0.00 2022-06-11_16:52:48
--cash                -0.50 2022-06-11_16:56:36 -@2022-06-11_16:56:36