Documentation updates for Jul 13, 2026
Refactor Known Issues documentation structure
Renamed the 'Known Issues' folder to lowercase for consistency and added metadata descriptions. The page now clearly outlines when to check for known issues and lists specific problems like missing models in project-level overrides.
Updated pages:
- Troubleshooting Designer
- Known Issues
- Incorrect Model Resolution for Project-Level Overrides on UI
- Tunnel Address Mappings Can Override Each Other
Model Documentation Property
ADITO model elements now support a documentation property to store technical or functional explanations directly on the model. This helps clarify purpose and assumptions for non-self-explanatory elements like Entities, Fields, and Parameters using AsciiDoc format.
Updated pages:
Database Best Practices: Reserved Words & SQL Safety
Updated guidance on avoiding reserved words for better portability. Added recommendations for using prepared statements with SqlBuilder, qualifying column names to avoid ambiguity, and clarifying DATETIME vs TIMESTAMP usage. Also notes that Liquibase changesets are immutable once committed.
Updated pages:
Solr 9 Global Search Limitations
Starting with ADITO 2025.0, certain field types (ADDRESS, PROPERNAME, TELEPHONE) may hit Solr's maxBooleanClauses limit due to term expansion. Recommendations include using TEXTNOSTOPWORDS or COMMUNICATION fields to reduce term generation when specific matching features are not required.
Updated pages:
- Appendix A - Index RecordContainer Properties
- Guides
- Global Search reaches maxBooleanClauses limit
- 2024.2 to 2025.0
Update Agent documentation and remove Roadmap links
Removed the deprecated Roadmap page from AI documentation. Updated agent guidance to reflect that ADITO does not yet ship a dedicated agent framework, clarifying how to build basic loops using function calling.
Updated pages: