# Training 28 Debrief

[Guide](/assets/guide.e0dfe9614fed24c805b8c5bc3e738e6ef42bd48e2b10878e2427d4b5e0c0f4a0.4d54b910.md)

## What made you smile?

- Progress appears pretty quickly - you can see the split screen just by adding the initial Markdoc tag.
- The docs are smart to have people start small, and iterate slowly, bc so many moving piecies, it is easy to break something, and not know what broke, unless you are doing things slowly in small steps.


## What did you find confusing?

- This is very tedious, all of the repetitive entries - it will drive developers nuts!
- Images don't work in preview.
- Preview isn't anchored by step and it doesn't work if embedded in step as one would assume.
- We weren't able to figure out how to switch filter automatically based on content.
- I don't understand toggle. Why not use the description HTML tag?
- The editor was marking our chunking as broken syntax, even though it worked. Maybe add some kind of note or front matter variable to let editor know what is going on?
-