Worked on the phpDocumentor/guides repository to deliver comprehensive improvements to admonition rendering in documentation. Developed new templates for various admonition types, including attention, danger, error, hint, and generic, ensuring rendering behavior aligns with specification requirements and only occurs when a title is present. Addressed content handling so directive text immediately following the indicator is properly included, enhancing documentation clarity. Expanded both unit and integration test coverage to validate multiple admonition configurations and updated fixtures for accuracy. Utilized PHP, HTML, and Twig to implement these changes, which improve documentation consistency, readability, and maintainability for users and contributors alike.