Skip to content

docs(admin): clarify MIME type customization - #16053

Open
joshtrichards wants to merge 1 commit into
masterfrom
jtr/docs-admin-MIMEtypes
Open

joshtrichards wants to merge 1 commit into
masterfrom
jtr/docs-admin-MIMEtypes

Conversation

@joshtrichards

Copy link
Copy Markdown
Member

☑️ Resolves

The MIME types chapter was outdated and unclear in several places, and did not cover MIME type display names.

Changes:

  • Clarify extension mappings and aliases, including their configuration files and maintenance commands.
  • Document MIME type display names.
  • Explain secure MIME alternatives and when to use them.
  • Clarify icon selection, fallback behavior, and the limits of custom icon support.
  • Move and clarify the file-cache repair guidance and related commands.
  • Add an AMR audio mapping example.

🖼️ Screenshots

✅ Checklist

  • I have built the documentation locally and reviewed the output
  • Screenshots are included for visual changes
  • I have not moved or renamed pages (or added a redirect if I did)
  • I have run codespell or similar and addressed any spelling issues

Improve explanations of extension mappings versus aliases, including their configuration files and maintenance commands.

Document MIME type display names.

Clarify secure MIME alternatives which was too vague previously to be actionable.

Improve explanation of icon selection and fallback, and the limits of custom icon support.

Move and qualify the database repair guidance and command instructions.

Add a mapping example (AMR audio).

Assisted-by: Copilot:gpt-6.1-terra

Signed-off-by: Josh <josh.t.richards@gmail.com>
@github-actions

Copy link
Copy Markdown
Contributor

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Sat, 14 Nov 2026 17:00:20 GMT

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant