More assorted content tweaks.

supahgreg · supahgreg · commit f54224af053c · 2025-11-10T03:29:49.000Z
diff --git a/docs/API-Reference.md b/docs/API-Reference.md
@@ -4,12 +4,10 @@ title: API Reference
 nav_order: 60
 ---
 
-{: .no_toc }
-
 ## Table of contents
 {: .no_toc .text-delta }
 
-1. TOC
+- TOC
 {:toc}
 
 ---
diff --git a/docs/FAQ.md b/docs/FAQ.md
@@ -7,8 +7,6 @@ nav_order: 3
 {: .note }
 > [Docker-related stuff is on a separate page](Installation-Guide#faq)
 
-{: .no_toc }
-
 ## Table of contents
 {: .no_toc .text-delta }
 
diff --git a/docs/Global-Config.md b/docs/Global-Config.md
@@ -4,9 +4,16 @@ title: Global Configuration
 nav_order: 4
 ---
 
-All settings (see `_DEFAULTS[]` for default values) are listed here:
+## Table of contents
+{: .no_toc .text-delta }
 
-- <https://github.com/tt-rss/tt-rss/blob/main/classes/Config.php> (source code, including default values)
+- TOC
+{:toc}
+
+## tt-rss configuration
+
+All tt-rss settings may be found in <https://github.com/tt-rss/tt-rss/blob/main/classes/Config.php>; the default values are in `_DEFAULTS`.
+You might find the [`Prefs_Effective_Config`](https://github.com/tt-rss/tt-rss-plugin-prefs-effective-config) plugin helpful.
 
 It is preferred to adjust tt-rss global configuration through the environment (e.g. using your Docker `.env` file):
 
@@ -24,7 +31,7 @@ putenv('TTRSS_DB_HOST=myserver');
 putenv('TTRSS_SESSION_COOKIE_LIFETIME='.(86400*30));
 ```
 
-- Note lack of quotes around values.
+- Note the lack of quotes around values.
 - Options should be always prefixed by `TTRSS_`.
 - Don't modify `classes/config.php`.
 - You don't need to put everything to `config.php`, only the options which you've changed from the defaults.
@@ -35,13 +42,13 @@ Legacy plugin-required constants also go to `config.php`, using `define()`:
 define('LEGACY_CONSTANT', 'value');
 ```
 
-To set computed values via `putenv()` you have to get them evaluated by PHP, this would work:
+To set computed values via `putenv()` you have to get them evaluated by PHP, so this would work:
 
 ```js
 putenv('TTRSS_SESSION_COOKIE_LIFETIME='.(86400*30));
 ```
 
-However, these won't give you expected results:
+However, these won't give you the expected results:
 
 ```js
 putenv("TTRSS_SESSION_COOKIE_LIFETIME='2592000'");
@@ -57,7 +64,7 @@ putenv('TTRSS_SESSION_COOKIE_LIFETIME=86400*30');
 
 ## Minimal config.php for a non-Docker setup
 
-Should have at least these options defined:
+You should have at least these options defined:
 
 ```php
 <?php
@@ -70,7 +77,12 @@ putenv('TTRSS_SELF_URL_PATH=http://example.com/tt-rss/'); # fully-qualified URL
 putenv('TTRSS_PHP_EXECUTABLE=/path/to/php-cli-binary'); # normally something like /usr/bin/php
 ```
 
-## Migrating from old style config.php
+{: .note }
+> In recent versions of tt-rss you may be able to omit `TTRSS_SELF_URL_PATH` and
+> rely on auto-detection, but it should be set if you use email digests or other background
+> processes that need your instance's URL (or if you run into issues).
+
+## Migrating from the old-style config.php
 
 For any `config.php` settings you have changed from the defaults (normally this
 is the `DB_` group of settings and `SELF_URL_PATH`, replace as follows, using
diff --git a/docs/Installation-Guide.md b/docs/Installation-Guide.md
@@ -239,7 +239,7 @@ APP_WEB_ROOT=/var/www/html/tt-rss
 APP_BASE=
 ```
 
-Don't forget to remove `/tt-rss/` from `TTRSS_SELF_URL_PATH`.
+Don't forget to remove `/tt-rss/` from `TTRSS_SELF_URL_PATH` (if you have it set).
 
 ### How do I apply configuration options?
 
diff --git a/index.md b/index.md
@@ -6,8 +6,6 @@ description: "Tiny Tiny RSS (tt-rss) is a free, flexible, open-source, web-based
 permalink: /
 ---
 
-{: .no_toc }
-
 Tiny Tiny RSS (tt-rss) is a free, flexible, open-source, web-based news feed (RSS/Atom/other) reader and aggregator.
 
 ## Screenshots
@@ -55,19 +53,7 @@ See the [Installation Guide](docs/Installation-Guide.md) for detailed instructio
 * Go to [https://github.com/tt-rss/tt-rss/discussions](https://github.com/tt-rss/tt-rss/discussions) if you have questions or want to discuss something.
 * Go to [https://github.com/tt-rss/tt-rss/issues](https://github.com/tt-rss/tt-rss/issues) if you want to report an issue, request an enhancement/feature, etc.
 
-## Documentation
-
-Browse the documentation:
-
-- [Installation Guide](docs/Installation-Guide.md)
-- [API Reference](docs/API-Reference.md)
-- [Plugins](docs/Plugins.md) and [Making Plugins](docs/Making-Plugins.md)
-- [Themes](docs/Themes.md)
-- [Content Filters](docs/Content-Filters.md)
-- [FAQ](docs/FAQ.md)
-- [Global Configuration](docs/Global-Config.md)
-
-## Development and Contributing
+## Development and contributing
 
 Contributions (code, translations, reporting issues, etc.) are welcome.
 Please see <https://github.com/tt-rss/tt-rss/blob/main/CONTRIBUTING.md> for more information.
