Structure documentation to prevent information overload and improve readability by using appropriate organizational elements and callouts judiciously.
Structure documentation to prevent information overload and improve readability by using appropriate organizational elements and callouts judiciously.
Key principles:
Break up complex information: When a single section contains multiple concepts or choices, use tabs, collapsible details, or separate sections to organize the content logically.
Use callouts appropriately: Reserve “important” admonitions for truly critical information. Use “tip” for helpful but non-essential information, and regular text for general explanations.
Avoid empty headings: Don’t have empty space between headings. Each heading should immediately be followed by content or subheadings.
Group related content: When documenting multiple related items (like components from the same provider), group them together under a common section.
Minimize visual clutter: Wrap lengthy code outputs or JSON responses in collapsible <details>
sections when only specific parts are relevant to the reader.
Example of good organization:
## Configure MCP servers
### Install the server locally
1. Install the weather server:
```bash
uv pip install mcp_weather_server
:::tip Environment variables
Langflow passes environment variables from the .env
file to MCP, but not global variables declared in the UI.
:::
```
This approach separates installation from configuration, uses tabs for different options, and reserves the tip callout for helpful supplementary information rather than critical instructions.
Enter the URL of a public GitHub repository