[Bug]: Doc comments are cut off at inline tags

[rmhartog]

Describe the bug

When using doc comments (TSDoc syntax), inline tags such as {@link} or any other text containing an @-symbol cause the description to be cut off at the @-symbol.

Reproduction

Reproduction in Playground

The following example

import "@typespec/http";
using TypeSpec.Http;

/**
 * Example of a description {@link https://github.com/microsoft/tsdoc}
 * Some more text here
 */
@service()
namespace Service;

results in the following OpenAPI output

openapi: 3.0.0
info:
  title: (title)
  description: Example of a description {
  version: 0.0.0
tags: []
paths: {}
components: {}

The same applies for any other text containing an @-symbol, like email-adresses, unless escaped with backticks.

I'm not sure to what extent TSDoc compatibility is a goal, but I've noticed tags like @param are supported, so I imagine this is a issue.

Checklist

• Follow our Code of Conduct
• Check that there isn't already an issue that request the same bug to avoid creating a duplicate.
• Check that this is a concrete bug. For Q&A open a GitHub Discussion.
• The provided reproduction is a minimal reproducible example of the bug.

[timotheeguerin]

we do not support that syntax just yet but it is on our plans, see this issue #1358

[markcowl]

Closing as duplicate of: #1358