Last updated 12/15/2025

Who this is for

• Anyone uploading documents into your AviaryAI knowledge base (KB).
• Goal: Help the KB (and your users, including screen reader users) understand your content more reliably.

Important note (so this doesn’t feel like “homework”)

You don’t have to rewrite all of your documents to use the KB—AviaryAI is built to handle real-world formats. These are best practices that can improve:

• retrieval accuracy (finding the right information),
• answer completeness,
• accessibility and human readability.

Quick formatting checklist

• Prefer one-column layouts when possible.
• Use clear headings (H1 → H2 → H3) so sections are easy to identify.
• Use real bullets/numbering for lists and step-by-step procedures.
• Put important facts in plain text, not only in images, icons, or diagrams.
• Keep tables straightforward (simple rows/columns) when possible.
• Define acronyms at first use (and/or use Magic Query to build an acronym bank).
• Avoid uploading fillable forms as-is (see “Things to avoid” below).

Best practices