<![CDATA[New Cloudron Docs Framework - Requesting feedback]]>Hello Cloudron Community

Currently, the Cloudron Docs at docs.cloudron.io are build with mkdocs and mkdocs-material.
Unfortunately mkdocs-material is now in maintenance mode which means we have to look for alternatives.

We have looked into Docusaurus and migrated the documentation and would appreciate some feedback from the community.

Here is the URL: https://docs-ng.cloudron.io/

My personal favourite is the new API Doc which has an interactive component to test the API.
Example: https://docs-ng.cloudron.io/api/list-apps-by-user you can edit the URL and your token and actually use the API:
3b4a71b1-6c55-4ca4-bd54-8f1592aef642-image.png

]]>https://forum.cloudron.io/topic/14787/new-cloudron-docs-framework-requesting-feedbackRSS for NodeTue, 14 Apr 2026 16:15:46 GMTTue, 23 Dec 2025 09:39:48 GMT60<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Mon, 05 Jan 2026 12:17:12 GMT]]>Hello there and thank you for always moving forward.
The docusaurus option seems good to me and the UI is clean.

Just a suggestion, maybe a left-margin +15 pixel on the second column (the content one) might be nice.

]]>https://forum.cloudron.io/post/117937https://forum.cloudron.io/post/117937Mon, 05 Jan 2026 12:17:12 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Mon, 29 Dec 2025 13:14:41 GMT]]>Hello @mononym

Thanks for reporting. We will have to look into it.

Fixed.

]]>https://forum.cloudron.io/post/117661https://forum.cloudron.io/post/117661Mon, 29 Dec 2025 13:14:41 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Mon, 29 Dec 2025 10:32:29 GMT]]>Quick look. Don't know if that's intended but the "Next" button at the bottom of a page does not link to the next category (though the "Previous" button goes back one category).

image.png

]]>https://forum.cloudron.io/post/117660https://forum.cloudron.io/post/117660Mon, 29 Dec 2025 10:32:29 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Mon, 29 Dec 2025 10:01:24 GMT]]>Hello Community

Update on https://docs-ng.cloudron.io/

The search is now scoped to docs and API.
If the search is used in the docs, only the docs are returned.
If the search is used in the API, only the API is returned.

We would greatly appreciate some extra eyes looking over https://docs-ng.cloudron.io/ to give feedback if anything is missing, broken, too different from the old docs and so on.

]]>https://forum.cloudron.io/post/117659https://forum.cloudron.io/post/117659Mon, 29 Dec 2025 10:01:24 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Wed, 24 Dec 2025 09:20:18 GMT]]>Feature - Persistent check boxes

In the docs.cloudron.io and docs-ng.cloudron.io we added a feature that checkbox items will persist.
Meaning, if you follow a documentation / guide that has checkboxes, you can actually check them to keep track of what you are doing.
The state of a checkbox is stored in the browser local storage, but the state is volatile.
If you clear your browser cache (or just for the doc pages) the checkbox state is lost.

For docs-ng.cloudron.io it looks like this:

For docs.cloudron.io it looks like this:

]]>https://forum.cloudron.io/post/117517https://forum.cloudron.io/post/117517Wed, 24 Dec 2025 09:20:18 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Tue, 23 Dec 2025 22:32:20 GMT]]>@james said in New Cloudron Docs Framework - Requesting feedback:

Docusaurus

Thank you, James. I really appreciate the useful tips from the forum thread compilations and the additional details on the documentation website.

]]>https://forum.cloudron.io/post/117501https://forum.cloudron.io/post/117501Tue, 23 Dec 2025 22:32:20 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Tue, 23 Dec 2025 21:31:17 GMT]]>@James looks good to me

]]>https://forum.cloudron.io/post/117499https://forum.cloudron.io/post/117499Tue, 23 Dec 2025 21:31:17 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Tue, 23 Dec 2025 16:18:05 GMT]]>Hello @humptydumpty
Thanks for reporting. It used to work. We will look into it.

Edit:
Found the problem, fix is beeing deployed.

]]>https://forum.cloudron.io/post/117496https://forum.cloudron.io/post/117496Tue, 23 Dec 2025 16:18:05 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Tue, 23 Dec 2025 15:58:50 GMT]]>Looks great and very lightweight. BUT, search isn't working for me. I typed "migrating" and it just spins forever. It was flawless on the old app and showed the result(s) in the dropdown almost immediately. This is on PC/Firefox.

]]>https://forum.cloudron.io/post/117495https://forum.cloudron.io/post/117495Tue, 23 Dec 2025 15:58:50 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Tue, 23 Dec 2025 13:53:28 GMT]]>Hello @jdaviescoates

@jdaviescoates said in New Cloudron Docs Framework - Requesting feedback:

presumably you looked at Zensical

Yes we have looked at Zensical.
Zensical is still early in development and subjected to a lot of change.
We need to consider stability, longevity and support, since we have to maintain it.

@mononym said in New Cloudron Docs Framework - Requesting feedback:

I have a remark related to who you expect to contribute.

For contributing to the doc with Docusaurus only npm or yarn is needed and a little knowledge with Markdown.

]]>https://forum.cloudron.io/post/117488https://forum.cloudron.io/post/117488Tue, 23 Dec 2025 13:53:28 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Tue, 23 Dec 2025 13:01:05 GMT]]>Docusaurus looks promising to me. I have a remark related to who you expect to contribute. I often see that the learning curve to contribute to docs build as a static site is too steep for non-techies. They have a difficult time when there's no CMS. That is also the reason I posted once about the Kalmia project. The real problem is that the documentation is actually a very good place for non-techies to contribute. I sometimes feel like it needs more skills to build the documentation than the project itself.

]]>https://forum.cloudron.io/post/117485https://forum.cloudron.io/post/117485Tue, 23 Dec 2025 13:01:05 GMT<![CDATA[Reply to New Cloudron Docs Framework - Requesting feedback on Tue, 23 Dec 2025 12:05:49 GMT]]>@james first question: presumably you looked at Zensical https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/ and ruled it out for some reason?

]]>https://forum.cloudron.io/post/117481https://forum.cloudron.io/post/117481Tue, 23 Dec 2025 12:05:49 GMT