-
Notifications
You must be signed in to change notification settings - Fork 14
Description
Currently the documentation is a jekyll site using markdown/html, blog posts, and the just-the-docs theme.
What we need:
-
Accessibility - images don't have alt tags, for example, but I'm sure there are tons of accessibility issues we're not thinking of.
-
Cross-documentation linking that does not break if a detail is changed (e.g. moved to a different category)
-
Easy separation of tracks - one for end-user documentation, and one for developer documentation
-
Multi-media support - at the very least, text formatting, images and gifs. Movie support is a plus
-
Something fully supported by github - the theme is not supported and every page build gives a warning.
-
Workflow capabilities - e.g. developers can take different paths, like building the foundation and then building charts, or building the foundation and then building the iOS app. Right now we are using different blog categories and blog post dates to order and separate the workflows, which is suboptimal.
-
Easy to update and contribute to - this is an open source project, after all! Changes may be rapid and we want to make sure we can update stale items.
Converting the documentation is a bigger project, and is blocked by this.