README tweaks

README.md

@@ -8,15 +8,17 @@ Google Reader inspired self-hosted RSS reader, based on Quarkus and React/TypeSc
 
 - 4 different layouts
 - Light/Dark theme
-- Fully responsive
+- Fully responsive, works great on both mobile and desktop
 - Keyboard shortcuts for almost everything
 - Support for right-to-left feeds
 - Translated in 25+ languages
 - Supports thousands of users and millions of feeds
 - OPML import/export
-- REST API and a Fever-compatible API for native mobile apps
+- REST API
+- Fever-compatible API for native mobile apps
+- Can automatically mark articles as read based on user-defined rules
 - [Browser extension](https://github.com/Athou/commafeed-browser-extension)
-- Compiles to native code for very fast startup and low memory usage
+- Compiles to native code for blazing fast startup and low memory usage
 - Supports 4 databases
     - H2 (embedded database)
     - PostgreSQL
@@ -56,12 +58,12 @@ memory usage.
 
 ### Build from sources
 
-    ./mvnw clean package -P<database> [-DskipTests] [-Pnative]
+    ./mvnw clean package [-P<database>] [-Pnative] [-DskipTests]
 
-- `<database>` can be one of `h2`, `postgresql`, `mysql` or `mariadb`.
-- `-DskipTests` is optional but recommended because tests require a Docker environment to run against a real database.
+- `<database>` can be one of `h2`, `postgresql`, `mysql` or `mariadb`. The default is `h2`.
 - `-Pnative` compiles the application to native code. This requires GraalVM to be installed (`GRAALVM_HOME` environment
   variable pointing to a GraalVM installation).
+- `-DskipTests` to speed up the build process by skipping tests.
 
 When the build is complete:
 
@@ -71,42 +73,10 @@ When the build is complete:
 - if you used the native profile, the executable is located at
   `commafeed-server/target/commafeed-<version>-<database>-<platform>-<arch>-runner[.exe]`
 
-### Memory management (`jvm` package only)
-
-The Java Virtual Machine (JVM) is rather greedy by default and will not release unused memory to the
-operating system. This is because acquiring memory from the operating system is a relatively expensive operation.
-This can be problematic on systems with limited memory.
-
-#### Hard limit
-
-The JVM can be configured to use a maximum amount of memory with the `-Xmx` parameter.
-For example, to limit the JVM to 256MB of memory, use `-Xmx256m`.
-
-#### Dynamic sizing
-
-In addition to the previous setting, the JVM can be configured to release unused memory to the operating system with the
-following parameters:
-
-    -Xms20m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:-ShrinkHeapInSteps -XX:G1PeriodicGCInterval=10000 -XX:-G1PeriodicGCInvokesConcurrent -XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=10
-
-See [here](https://docs.oracle.com/en/java/javase/17/gctuning/garbage-first-g1-garbage-collector1.html)
-and [here](https://docs.oracle.com/en/java/javase/17/gctuning/factors-affecting-garbage-collection-performance.html) for
-more
-information.
-
-#### OpenJ9
-
-The [OpenJ9](https://eclipse.dev/openj9/) JVM is a more memory-efficient alternative to the HotSpot JVM, at the cost of
-slightly slower throughput.
-
-IBM provides precompiled binaries for OpenJ9
-named [Semeru](https://developer.ibm.com/languages/java/semeru-runtimes/downloads/).
-This is the JVM used in the [Docker image](https://github.com/Athou/commafeed/blob/master/Dockerfile).
-
 ## Configuration
 
 CommaFeed doesn't require any configuration to run with its embedded database (H2). The database file will be stored in
-the `data` directory in the working directory.
+the `data` directory of the current directory.
 
 To use a different database, you will need to configure the following properties:
 
@@ -133,13 +103,45 @@ When logging in, credentials are stored in an encrypted cookie. The encryption k
 meaning that you will have to log back in after each restart of the application. To prevent this, you can set the
 `quarkus.http.auth.session.encryption-key` property to a fixed value (min. 16 characters).
 
-All  [CommaFeed settings](commafeed-server/src/main/java/com/commafeed/CommaFeedConfiguration.java)
-are optional and have sensible default values. Quarkus settings can be
-found [here](https://quarkus.io/guides/all-config).
+All [CommaFeed settings](commafeed-server/src/main/java/com/commafeed/CommaFeedConfiguration.java)
+are optional and have sensible default values.
+Other Quarkus settings can be found [here](https://quarkus.io/guides/all-config).
 
 When started, the server will listen on http://localhost:8082.
 The default user is `admin` and the default password is `admin`.
 
+### Memory management (`jvm` package only)
+
+The Java Virtual Machine (JVM) is rather greedy by default and will not release unused memory to the
+operating system. This is because acquiring memory from the operating system is a relatively expensive operation.
+This can be problematic on systems with limited memory.
+
+#### Hard limit
+
+The JVM can be configured to use a maximum amount of memory with the `-Xmx` parameter.
+For example, to limit the JVM to 256MB of memory, use `-Xmx256m`.
+
+#### Dynamic sizing
+
+In addition to the previous setting, the JVM can be configured to release unused memory to the operating system with the
+following parameters:
+
+    -Xms20m -XX:+UseG1GC -XX:+UseStringDeduplication -XX:-ShrinkHeapInSteps -XX:G1PeriodicGCInterval=10000 -XX:-G1PeriodicGCInvokesConcurrent -XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=10
+
+See [here](https://docs.oracle.com/en/java/javase/17/gctuning/garbage-first-g1-garbage-collector1.html)
+and [here](https://docs.oracle.com/en/java/javase/17/gctuning/factors-affecting-garbage-collection-performance.html) for
+more
+information.
+
+#### OpenJ9
+
+The [OpenJ9](https://eclipse.dev/openj9/) JVM is a more memory-efficient alternative to the HotSpot JVM, at the cost of
+slightly slower throughput.
+
+IBM provides precompiled binaries for OpenJ9
+named [Semeru](https://developer.ibm.com/languages/java/semeru-runtimes/downloads/).
+This is the JVM used in the [Docker image](https://github.com/Athou/commafeed/blob/master/Dockerfile).
+
 ## Translation
 
 Files for internationalization are