1 files changed, 37 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ef5f8f1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+Skatteverket in .se requires taxes to be declared every year. While they do
+provide "e-tjänster" to do this online, those are essentially worthless¹ and
+filling in paper forms are practically still the easiest way to get this stuff
+done.
+
+Manually filling in papers is boring and error prone. Thus the existance of
+these scripts. They are only written to work for me and no warranties are
+given or implied.
+
+Seriously. Please hold no expectations that these scripts could be of any use
+for you. It's low quality scripting, run at most once per year. I publish it on
+the odd chance that possibly someone might find inspiration on how to deal with
+instutitions still depending on actual paper forms for things.
+
+The idea is that running `bin/deklarera.sh` should interactively go through the
+steps necessary to file taxes. It is basically just a checklist. Some auxiliary
+scripts prepares svg files with numbers placed in the right boxes. Fragile and
+only implemented for forms and fields that I have encountered.
+
+Consider it all to be in the public domain. Patches are welcome.
+
+1. Skatteverket's e-tjänster have arbitrary unavailability planned for parts of
+   each and every day, and require the use of e-legitimation which practically
+   means BankID. While BankID has legitimate use cases, that authentication
+   solution is unsuitable for filing taxes. As with any task required to be
+   performed on a tight schedule, it is best done without potentially involving
+   the requirement to run out and buy a new MacBook and/or spending a few days
+   messing with a bank's customer service. In addition, I assume all the usual
+   disadvantages of modern websites exist. All too quick automatic logout on
+   percieved inactivity and user interfaces that change between every time? It
+   is likely is about as buggy as one can expect.
+   In case anyone at Skatteverket with sufficient power ever happens to read
+   this; If you'd wish to process less paper forms, could you please launch
+   initiatives to incent some e-legitimation to again be usable by open source
+   software? If you've noticed a bump in the trend, remember that BankID used
+   to work with fribid.se before those monopolists started to actively block
+   auditable and secure software for no good reason.