[martinjagodic]

Brings the docs up to date with what has shipped in decap-cms up to 3.17.2: merges the open docs PRs whose features are released, and documents recent changes that never made it into the docs.

Merge with a merge commit, not a squash, so the four merged PRs keep their authors and are marked as merged.

Merged PRs

• docs: add Neon Object Storage to the media library docs #182 Neon Object Storage (feat(media-library-s3): list Neon Object Storage as a supported provider decap-cms#8041, 3.17.2)
• docs: document missing options and fix outdated examples #181 missing options and outdated examples
• docs: document the notes pane #175 notes pane (3.15, GitLab in 3.16.3, Turbo in 3.17)
• Add preview.visualEditing to docs and to site's config #138 visual editing (feat: visual editing (click-to-edit) decap-cms#7374, 3.6)

Fixes applied on top, after checking each claim against the decap-cms source:

• Add preview.visualEditing to docs and to site's config #138: resolved the conflict with docs: document the notes pane #175 in the editor section. The site config set preview: visualEditing, which the CMS ignores; it's now editor: visualEditing. Reverted the docs.js change, since the preview entry is already encoded for visual editing and widgetFor('title') put a margined div inside the h1.
• docs: document the notes pane #175: version tags per host; authorId decides ownership only on Turbo, where author can be the editor's email; the issue link appears once the entry has notes.
• docs: add Neon Object Storage to the media library docs #182: Neon's storage:write scope already includes read and list; public_url_prefix goes in config.yml, not in site variables.
• docs: document missing options and fix outdated examples #181: Forgejo's editorial workflow needs 3.16.2 (fix: support Forgejo editorial workflow PR heads decap-cms#7976) and open authoring with a renamed fork 3.17.2 (fix(forgejo): use existing fork when it has a different name decap-cms#8013); the slug byte cap is lower for long collection names; preview_context also works on turbo-github and turbo-gitlab; Forgejo's branch and api_root defaults; Git Gateway and Decap Turbo support the editorial workflow.

Newly documented

• backend.signoff_commits (3.12, feat: add config option to enable Signed-off-by in commit messages decap-cms#7766)
• preview_path_preserve_slashes (3.12.2, feat: allow special characters to pass through slugification decap-cms#6220)
• The uuid widget, registered by default since 3.15 (feat: add uuid widget decap-cms#6675)
• Inline editor components for the markdown widget (3.16.2, feat(widget-markdown): support inline custom editor components decap-cms#7958)
• Relation filters on list fields (fix(relation): match filters against multiple-value fields decap-cms#8006) and preSave returning a whole entry (fix(core): preserve full entries returned by preSave handlers decap-cms#7989), both 3.17.2
• JavaScript front matter is no longer evaluated (3.17.2); such a file loads empty and saving it overwrites it
• Unpublished entries in collection views (3.8, heading and sorting in 3.15)
• The list of UI locale codes, including the new sk, hr, sr_Cyrl and mk
• The Decap Proxy page: local-only default since decap-server 3.11.6, MODE=git and the editorial workflow (with a warning that git mode commits everything in the working tree), GIT_REPO_DIRECTORY, LOG_LEVEL, Node.js 20, reaching the proxy from another device, and the broken BIND_HOST=8082 example

Not included

These docs PRs wait for decap-cms PRs that are still open: #180 (decaporg/decap-cms#8036), #178 (decaporg/decap-cms#8012), #177 (decaporg/decap-cms#7999), #176 (decaporg/decap-cms#7984), #157 (decaporg/decap-cms#7382), #92 (decaporg/decap-cms#7329), #85 (decaporg/decap-cms#7310), #76 (decaporg/decap-cms#7031), #61 (decaporg/decap-cms#6836), #60 (decaporg/decap-cms#6469). #172, #148 and #104 don't document a shipped feature.

Testing

• hugo --gc --minify builds with no new warnings (Hugo 0.166 locally; Netlify pins 0.148.1, so the deploy preview is the real check).
• Every internal /docs/ link and anchor added on this branch resolves in the build output.

🤖 Generated with Claude Code