Documentation missing for built-in decorators

[mikekistler]

I discovered a neat trick for checking for missing decorator docs. If you compile any cadl file and specify --trace bind.js.decorator cadl will print diagnostics that show all the bound decorators in known namespaces. Filtering this by the "Cadl" namespace and cross checking with the Built-in decorators page on the website shows that the following decorators are missing from the docs:

• [ ] @discriminator
• [ ] @indexer
• [ ] @list
• [ ] @maxValueExclusive
• [ ] @minValueExclusive
• [ ] @overload
• [ ] @projectedName (misspelled - @projectedNames)

[bterlson]

These are all manually documented right now. @allenjzhang is looking into auto-generating stdlib docs (along with compiler API docs which are also missing).

[nguerrera]

I think for decorators, these should be moved to extern dec declarations if only documented in .ts now. That would get picked up by the existing doc infrasructure and the IDE. I believe we planned to filter out the $-prefixed decorator functions from the JS API docs?

[markcowl]

Please find the duplicate issue

[markcowl]

verify: are we generating docs from the core library?

[tjprescott]

@serviceVerson and @serviceTitle have been removed... so that's two down 😄