Pete Gonzalez

This feature could also be used to wrap long lines, e.g. to satisfy an ESLint rule that limits line length. ``` /** * For more info please see https://github.com/micro *+soft/tsdoc/issues/166...

Here's a poll where you can vote on the syntax: 🙂 https://twitter.com/octogonz_/status/1204589348525527040?s=19

> but `+` and `-` are both markdown unordered list delimiters, so this has the potential for being misinterpreted as a list (both visually and by the parser). That could...

By the way, we do plan to support HTML character entity references in TSDoc markdown. So instead of `&COMMENT_CLOSE;`, you would be able to represent `*/` as `*/` in many...

> This seems like a lot of effort to work around a problem that could more readily be solved with "don't put `*/` in your code examples". Not sure how...

As a counterpoint, maybe we could look for a real world instance of `*+` that would get misinterpreted under this proposal. But it has to be a project where the...

I don't think `\*/` will work. @sindresorhus Your suggestion would require changing the ECMAScript grammar. Even if we could do that, the `\` escape would imply that backslashes need to...

This problem is the one thing that makes me want to switch to `///` comments as discussed in #160. But the `*+` notation above is a pretty workable compromise. I...

Blocks contain a `DocSection` that is an array of `DocParagraph` objects, which are delimited by blank lines (because their content may span multiple lines). Adding an extra line is the...

Both your issues https://github.com/microsoft/tsdoc/issues/200 and https://github.com/microsoft/tsdoc/issues/201 seek to improve the aesthetic appearance of the `TSDocEmitter.renderComment()` API. Perhaps they could be tackled together. At the time when I implemented `TSDocEmitter.renderComment()`, I...