Move documentation to wiki or readthedocs or any other multi page format

The one page documentation is getting too large: it is very slow (unusable on a cell phone), the search often fails (for example can’t find get_id), the search from the browser fails too (as the page scrolls and the url is updated).

The forum contains a lot of useful information, but it is not organized and mixed with useless or even bad posts, and it’s difficult to find what you are looking for.

For example this post has a some useful information and should be part of the documentation, but it is too messy. It should be cleaned up and added to the documentation / wiki.

I am a fan of the wiki format, but anything easier to use than the single page documentation would be an improvement. The wiki could be mostly written and managed by the Anvil team, but open to user contributions.

2 Likes

Agreed, the search on the docs is not brilliant.

And I for one would be happy to help translate some of the docs to another format.

Maybe Sphinx as it’s a fairly common way to doc. python stuff (or so I seem to find)?
http://www.sphinx-doc.org/en/master/

(edit) - I particularly like this layout/theme : http://bootstrap-datepicker.readthedocs.io/en/latest/

:smile:
YES, THANK YOU, FINALLY!!!
:smile:

4 Likes