Library/Emitter authoring documentation is not usable

[tjprescott]

I was asked to create an emitter in a fresh repo using the emitter framework. I have been trying to follow the directions here and they simply do not work as written.

Fundamentally, if I'm writing an emitter (or library) I want to be able to do three things:

1. compile my code
2. write tests so I can do test-driven development
3. debug into those tests since it's preferable to creating a bunch of manual test files and debugging into those

There are several small issues in the documentation like typos, but there are larger ones.

• The whole first section about setting things up becomes inaccurate once you try to set up testing in a section below. But the testing section doesn't actually correctly address what needs to be adjusted from the earlier section.
• The testing section doesn't provide guidance on how to set up testing, so the third priorty (debugging into tests) is totally absent

This is all before I can even get to the whole point of this exercise, which is to use the emitter framework.

As someone who has been working on TypeSpec for over a year, if it is this difficult to get set up, I don't see how we could expect our customers to find success.