## formatting points
use mark tag
use abbr tags -- we could define a common block at the top of each document
understand line breaks, p vs br, and keep list items together
remove generated HTML from the conversion, if remaining
replace genereated button-link elements with proper Button components
note: code titles don't work
shell scripts need 'bash' as a language not 'sh'



# TODO for launch
- [x] clean up content in docusaurus demo, with clear styleguide pages
- [x] create netlify project and deploy
- [x] ask elise, ella, akela what else should go here, demo-wise
    - [ ] refer them to where the source lives
- [x] copy the version dropdown code, do an interim hack version switcher
- [ ] add the sidebar link for the API docs, get that page working
- [ ] fix the global responsive layout issues
- [ ] create rasa docs logotype, create better rasa favicon
- [ ] fix the global footer
- [ ] get the default components for docs imported
- [ ] fix block image rendering, so they work standalone
- [ ] add MDX linting to the demo project
- [ ] remove dependencies:
    - rehype-figure
    - remark-collapse
    - remark-images
    - remark-unwrap-images

## in `rasa` / `rasa-x`:

### hi prio

- [ ] content issues
  - [x] integrate 'getting-started' content in to each repo; remove 'Rasa Overview' nav link
  - [x] figure out why some pages have no sidebar (it's because they are not listed in teh sidebar file)
  - [ ] changelogs must not include links to private repos
  - [ ] python autodoc generates duplicate references when folder and file have same name
  - [ ] writing should include new formatting affordances
    - [ ] mark, abbr, kbd
    - [ ] Q: can remark-abbr also be given global abbreviation lookups?
  - [ ] sidebar nesting must be 3 levels max
  - [ ] HTML generated by conversion should be replaced with custom components or deleted
- [ ] navigation
  - [x] remove the dropdowns in the header
  - [ ] ~~scope the prism CSS somehow?~~
  - [ ] spit out the versions in the sidebar; copy the parsing logic from the other branch
  - [ ] place API Docs link in the sidebar with "external link" icon
  - [ ] load redoc component asynchronously on the /api page
- [ ] versioning
  - [x] ~~look at [`react-dropdown-aria`](https://jfangrad.github.io/react-dropdown-aria/) (small, already a dep of redoc)~~ too many features, will have to use existing dropdown for now
  - [ ] figure out how to add arbitrary additional items to the dropdown
  - [ ] create the client redirects on build, for all current version pages
  - [ ] figure out canonical link output logic WRT versions

### lo prio
- [ ] add local MDX linting [mdx-js/eslint-mdx](https://github.com/mdx-js/eslint-mdx)
- [ ] configure the 'ideal image' plugin
- [ ] add to markdown features:
	- [ ] auto heading levels?
  - [ ] modifiable heading IDs?
	- [ ] footnotes?
- [ ] resolve title, description, tagline in config vs. page meta tag outputs
  - [ ] separate pageTitle from metaTitle (title) in frontmatter

## in `docusaurus-theme`:
- [ ] styling
  - [ ] make prose use font-family, font-size, line-height etc. like f base
  - [ ] make prose-[fz] set
    - [ ] font-family-[default] and font-size-[default]-[fz]
    - [ ] stack-gap = line-height
  - [ ] make pre and codeBlock component horizontally scrollable
- [ ] bring in the global footer from rasa-tech-test
- [ ] re-create version-dropdown component, implement new versions logic
- [ ] custom components needed
  - [ ] Tabs, TabItem, Button(s), Conversation (Chat),
	- [ ] "chat bubbles"
		h [ ]ttps://github.com/RasaHQ/rasa/blob/1.10.x/docs/core/about.rst
		h [ ]ttps://rasa.com/docs/rasa/core/about/
	- [ ] `.btn-link` / `TrainButton`
		h [ ]ttps://rasa.com/docs/rasa/user-guide/installation/
		h [ ]ttps://raw.githubusercontent.com/RasaHQ/rasa/master/docs/docs/prototype-an-assistant.mdx
- [ ] remove Prototyper from theme and from common MDX scope, return to `rasa`
	- [ ] but set it to dependency on built-in components e.g. `Button`
- [ ] review [other blockers/todos from old thread](https://github.com/RasaHQ/growth/issues/1436#issuecomment-653581157)