You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Right now we have a documentation project in this repository which is just release and testing information for core team. This doesn't seem super useful to maintain as a project and the content feels misplaced.
Operations information should be in our ops playbook docs and testing/development info doesn't really require a whole documentation project. This could be in the readme or our development playbook docs, but the content in the readme here is mostly replicating the marketing content that we're maintaining in our application docs.
The documentation our users need from us is instead deeper information on our API, events triggered, and CSS customization. We have some examples and a basic list at:
But it is cumbersome and disconnected to have to document this level of detail in another repository. Especially because we benefit on the development side from documentation in source files.
What I'm describing is:
Move operations documentation for core team to our operations playbook docs
Keep the readme just information needed to work with the repository
Move/keep marketing content in our application documentation and website for now -- screenshots/etc
Thoroughly document the library API, events, and CSS customization here. Use Sphinx (and probably JSDoc and autoanysrc for CSS) to document at the source files.
Right now we have a documentation project in this repository which is just release and testing information for core team. This doesn't seem super useful to maintain as a project and the content feels misplaced.
Operations information should be in our ops playbook docs and testing/development info doesn't really require a whole documentation project. This could be in the readme or our development playbook docs, but the content in the readme here is mostly replicating the marketing content that we're maintaining in our application docs.
The documentation our users need from us is instead deeper information on our API, events triggered, and CSS customization. We have some examples and a basic list at:
https://docs.readthedocs.com/platform/stable/addons.html
But it is cumbersome and disconnected to have to document this level of detail in another repository. Especially because we benefit on the development side from documentation in source files.
What I'm describing is:
The text was updated successfully, but these errors were encountered: