Pete Gonzalez

This is a good idea. However I think we might want to approach it via the [tsdoc.json config file](https://github.com/microsoft/tsdoc/tree/master/tsdoc-config) rather than via ESLint's configuration. The reason is that you are...

BTW the [api-demo/src/advancedDemo.ts](https://github.com/Microsoft/tsdoc/blob/master/api-demo/src/advancedDemo.ts#L66) demo illustrates an approach for collecting comments. The compiler itself already discards some of the weirder places where `/** */` comments can appear (e.g. inserted after function...

We don't use files-as-namespacs in any of the projects I work on, although I've had external requests for this feature that seem reasonable. API Extractor does rely on file-level comments...

Getting back in the saddle, today we merged the PR that sets up the initial tsdoc parser library project. I'm starting with Option 2 and we'll see how that goes....

> I want to know is there any other inline tags being used today and what's the possibility that tsdoc will add more inline tags in the future? If both...

So, the big architecture of the parser would be like this: 1. Extract comment lines from "`/** */`" their blocks (see [this PR](https://github.com/Microsoft/tsdoc/pull/25)) 2. Tokenize the content of the lines...

**Important Update:** Friends, I am losing my mind trying to pick out an internally-consistent subset of CommonMark syntax! Recall that the planned compromise was to allow ambiguity about how documentation...

I opened a separate issue #29 to provide some concrete details about this "TSFM" idea.

> At least w/ ESDoc and hence my significantly updated fork TJSDoc comment blocks are parsed such that all text above the first tag parsed from a new line is...

Could you share a more complete example that includes the definition of `y` and `isConfig`?