docs-page-opening-optimizer

To optimize Elastic documentation intros, refine the H1 title for specificity, craft a concise opening paragraph, and add a 'Before you begin' section. This ensures pages align with content type conventions and improve searchability.

The best way to write an intro paragraph for a tutorial or reference doc is to define the topic and its value without repeating frontmatter descriptions. Tailor the content based on the page classification to ensure it meets reader expectations.

To format Elastic product names and UI elements in markdown, enforce Jinja2 substitutions like `{{product.kibana}}` instead of hardcoded names. This ensures adherence to style guidelines and maintains consistency across documentation pages.

You should add a 'Before you begin' section when a documentation page requires specific prerequisites like user privileges or data. Exclude obvious or generic requirements to keep the section concise and relevant to the user's setup.

Documentation H1 titles need anchors and specificity to enhance discoverability and align with content type conventions. Specific titles help users find relevant pages through search and navigate directly to the required information.

Yes, content optimization analyzes your documentation page to classify its type, such as tutorial, how-to, reference, explanation, or overview. This classification then tailors the H1, intro, and requirements optimization strategies.