In a discussion about enhancing theme customization in Discourse, Biscuit recommends adding a Description field to themes for better documentation, especially for long-term maintenance and team collaboration. codinghorror asks if metadata or comments already exist, prompting david to explain that a description can be added via a YML file under /locales/en.yml using theme_metadata. Biscuit follows up, asking for the same functionality to be available directly in the UI for hosted instances — specifically within ADMIN > Customize > Themes — since many users create themes without editing YML files. david responds that while direct UI support isn’t currently available, users can leverage the Discourse Theme CLI to add metadata files on hosted instances. He also notes that adding a description field to the UI could be explored in the future. Finally, david shares a link to a guide on adding metadata to a theme, making the process more accessible. The conversation highlights a gap in UX for theme documentation and suggests both a workaround and potential future improvement.
Recommendation: Please consider adding a Description field to custom-made themes and components.
Reason:
I created some themes a while back and haven’t looked at them for several months. They are no longer fresh in my mind and I realised it would be useful to have a description or notes field, so I can leave comments about the theme’s functionality and/or status (eg: completeness) for myself and/or others admins to reference.
How about for themes that people are creating through the UI, without creating YML files, on hosted instances of Discourse?
For example, when I click on: ADMIN > Customize > Themes, there’s no field to describe the themes I’ve created. I’d like to have the same commenting ability here, that you’ve added for YML files.