FreshRSS (Customized)/docs/en, branch edge

Initial conventions for AI agents and humans: AGENTS.md, SKILLS.md, instructions.md (#8478)

2026-02-01T12:06:53+00:00

Not stable yet, but initial structure https://agents.md https://agentskills.io/specification https://code.visualstudio.com/docs/copilot/customization/custom-instructions https://code.visualstudio.com/docs/copilot/customization/agent-skills

Update the 'Refreshing feeds' documentation page (#8468)

2026-01-28T07:31:19+00:00

* Update the 'Refreshing feeds' page * add the 'user' parameter and clarify the 'token' parameter usage * remove old token screenshots, add a new one from profile page * update the authentication page screenshot * clarify the anonymous refreshing of the feeds * Add myself to CREDITS.md * Update Refresh feeds docs page content * Tweak the content headings to match the actual headings * Fix the link to Form authentication paragraph * PNG compress more (16 colours + OptiPNG) * Minor typography --------- Co-authored-by: Alexandre Alapetite

Update documentation in regards to CSP warnings (#8439)

2026-01-17T21:28:56+00:00

* Add a reference to the check where the warning is triggered Note: This is the place where the admin sees the browser pointing to. Adding this information here allows the admin to find the matching documentation entry. * Update Content-Security-Policy section of english ServerConfig documentation Note: This fixes some minor formating/typping issues and adds some clarity to the fact that this warning is also triggered on correctly configured hosts, simply due to the nature of how correctness of CSP rules are checked. * Move CSP infor source-code comment into console.info Note: Improve visibility of why this is happening. * Point towards static website documentation instead of git This URL should also remain more fixed even accross new branches/releases. Co-authored-by: Inverle * Minor fixes * Remove overwrite part --------- Co-authored-by: Inverle Co-authored-by: Alexandre Alapetite

Document mounting own CA on FreshRSS container (#8406)

2026-01-05T21:06:09+00:00

closes https://github.com/FreshRSS/FreshRSS/issues/8405 - Add documentation on how to trust own CA that issued self-signed certificate as authentik signing key - Add example in Docker Example How to test the feature manually: 1. Create your own CA 2. Issue a certificate 3. Use the issued certificate as a signing-key in authentik when configuring FreshRSS provider 4. Add created CA on host's CA store by running `update-ca-certificates` 5. Mount the `/etc/ssl/certs/ca-certificates.crt` file on FreshRSS container 6. Start the container 7. Navigate to FreshRSS in the browser 8. Authentik login form should be displayed and work as normal.

Improve layout of documentation page and add search feature (#8247)

2025-12-04T19:06:21+00:00

* Improve layout of documentation page and add search feature Closes https://github.com/FreshRSS/FreshRSS/issues/7915, https://github.com/FreshRSS/FreshRSS/issues/5325 Also: anchor headings and fix building site locally * Further improvements * Set color of hyperlinks * Consistent styling of close aside button across devices * Mobile layout 600px -> 1200px * Add suffix to docs `` * Note: titles of pages probably need to be improved, since currently they are just derived from the names of the first heading on every page * Add favicon * Improve font * Try to fix favicon not loading correctly on GH pages * Use local font * Attempt to fix GH pages * Final improvements * Copy to clipboard button * Support for nojs search * Dark mode * Load search.json (200KB json) only on search input focus * Keep scroll state of sidebar across navigations * Clickable images and CSP CSP so we avoid hotlinking resources and clickable images are useful for zooming on mobile for example * Fix typos * Disable Dark Reader extension if dark mode CSS is loaded * Support internationalisation (via language dropdown) * Add Gemfile.lock * Make CI build work with the custom plugin * Make menus closable with Esc * Fix typos CI * Suggestions * Use `ruby/setup-ruby` action in workflow for installing and caching gems. * Run build only when there are changes to `docs/` See: https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows?versionId=free-pro-team%40latest&productId=actions#running-your-workflow-only-when-a-push-to-specific-branches-occurs * Change font to `Open Sans` * Increase line height * Fix Liquid syntax error </article> <article> <h1>Fix MariaDB updateCachedValues (#8255)</h1> <p>2025-11-26T22:47:29+00:00</p> Changed syntax for an even wider compatibility. Follow-up of https://github.com/FreshRSS/FreshRSS/pull/8254 Regression from https://github.com/FreshRSS/FreshRSS/pull/6957 MariaDB images on Docker Hub go back to 10.6, so changed documentation to indicate support from that version, as I cannot easily test even older versions. </article> <article> <h1>OPML export/import of unicity criteria (#8243)</h1> <p>2025-11-24T21:01:46+00:00</p> Found during https://github.com/FreshRSS/FreshRSS/discussions/8242#discussioncomment-15052838 </article> <article> <h1>Fix link to Minz docs in 05_Extensions.md (#8229)</h1> <p>2025-11-18T14:16:14+00:00</p> The link to the Minz docs works on GitHub but 404's on the [live site](https://freshrss.github.io/FreshRSS/en/developers/03_Backend/05_Extensions.html). Replacing the absolute path with a relative path should correct the 404. </article> <article> <h1>Add new translate action: `move`, `make i18n-move-key` (#8214)</h1> <p>2025-11-16T17:44:07+00:00</p> So that renaming something like `conf.shortcut.toggle_sidebar` to `conf.shortcut.toggle_aside` can be done easily even after already having added `conf.shortcut.toggle_sidebar` and translated it in multiple languages. Example of usage: ```console ./cli/manipulate.translation.php -a move -k conf.shortcut.toggle_sidebar -n conf.shortcut.toggle_aside ``` ```console make i18n-move-key key="conf.shortcut.toggle_sidebar" new-key="conf.shortcut.toggle_aside" ``` The key will be moved and all values/states will be kept. </article> <article> <h1>Housekeeping lib_rss.php (#8193)</h1> <p>2025-11-11T07:17:12+00:00</p> * Housekeeping lib_rss.php `lib_rss.php` had become much too large, especially after https://github.com/FreshRSS/FreshRSS/pull/7924 Moved most functions to other places. Mostly no change of code otherwise (see comments). * Extension: composer run-script phpstan-third-party </article> </main></body></html>