tsdoc.json not detected in yarn workspaces project
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 5k
- Forks
- 162
- Avg merge
- 17h 24m
- Merged PRs (30d)
- 8
Description
Hi,
I'm trying to add custom tags to use alongside tsdoc via creating a tsdoc.json and eslint-plugin-tsdoc. However, eslint doesn't seem to recognise the tsdoc.json file and I still get error messages like tsdoc-undefined-tag: The TSDoc tag "@description" is not defined in this configurationeslint[tsdoc/syntax](https://tsdoc.org/pages/packages/eslint-plugin-tsdoc).
The project I'm working using yarn workspaces. I wonder whether this is affecting the discoverability of the tsdoc.json file. It is placed at the highest level in the project next to the tsconfig.json as the documentation recommends.
Is there another step for getting it to work in this kind of project? Or is there something else I could be getting wrong?
Below is the tsdoc.json I'm trying to use:
{
"$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
"tagDefinitions": [
{
"tagName": "@description",
"syntaxKind": "block"
}
],
"supportForTags": {
"@description": true
}
}
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Reproduce the report in a TypeScript project using Yarn workspaces, with tsdoc.json beside tsconfig.json and eslint-plugin-tsdoc configured. Start by checking how eslint-plugin-tsdoc discovers tsdoc.json; done means the workspace configuration is found and the custom @description tag no longer produces the undefined-tag error.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- documentation, tooling
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100