Specify system requirements and reformat

README.md

@@ -1,29 +1,42 @@
-# README
+README
+======
 
 Quantified self
 
-* Ruby version: 3.1
-* System dependencies: none
+
+Software requirements
+---------------------
+
+* Server side:
+    * Ruby version: developed on Ruby 3.x
+    * database with recursive Common Table Expressions (CTE) support, e.g.
+      MySQL >= 8.0, MariaDB >= 10.2.2
+    * for testing: browser as specified in _Client side_ requirements
+* Client side:
+    * browser supporting below requirements (e.g. Firefox >= 121):
+        * [`import maps`](https://caniuse.com/import-maps)
+          (required by `importmap-rails` gem >= 2.0)
+        * CSS [`:has()` pseudo-class](https://caniuse.com/css-has)
 
 
-
-## Installation
+Installation
+------------
 
     git clone https://gitea.michalczyk.pro/fixin.me/fixin.me.git
     bundle config set --local path '.gem'
     bundle install
 
 
-
-## Configuration
+Configuration
+-------------
 
     cp -a config/application.rb.dist config/application.rb
 
 Modify configuration settings below `SETUP` comment appropriately.
 
 
-
-## Database
+Database
+--------
 
 Grant database user and privileges:
 
@@ -41,9 +54,8 @@ Run database creation and migration tasks:
     RAILS_ENV="production" bundle exec rake db:create db:migrate db:seed
 
 
-
-## Running
-
+Running
+-------
 
 ### Standalone Rails server + Apache proxy
 
@@ -62,10 +74,11 @@ Run server
 
 ### Apache mod_passenger
 
+TODO: add sample configuration
 
 
-## Contributing
-
+Contributing
+------------
 
 ### Database