The most crucial improvement needed for Silex at this point is to revamp and expand its documentation. This effort needs to address the lack of structure, clarity, and coherence in the current docs. In addition to that, the documentation should be multilingual (starting with English and French) so we need a strategy.
To support users effectively, the documentation is available in several places / formats:
- Videos: Step-by-step video tutorials hosted on video.silex.me to visually guide users through Silex features and workflows.
- Text-Based Guides: Written documentation on docs.silex.me, providing detailed instructions, examples, and troubleshooting tips.
- Inline Help: Contextual help directly within the Silex interface, offering users quick assistance as they navigate the platform. There is a feature request here to improve inline documentation
- Onboarding Emails: Users receive a series of emails when they first sign in, after 30 days, and after publishing their site for the first time. These emails contain essential guidance and links to further resources, making them a key part of the documentation ecosystem. They may need to be translated, or rewritten completely. Here is the content of each email
- Silex Resource Center is a page in Silex new website that is supposed to be the first step into Silex documentation. This is probably a duplicate of the page on docs.silex.me
Let’s use this space here to start discussing how to move forward—every point of view counts. Feel free to share ideas or suggestions on how to improve both the content and the structure of the documentation.