Skip to content

docs(eslDoc): automatic documentation generation - #1250

Draft
fshovchko wants to merge 6 commits into
mainfrom
docs/tsDoc-documentation
Draft

docs(eslDoc): automatic documentation generation#1250
fshovchko wants to merge 6 commits into
mainfrom
docs/tsDoc-documentation

Conversation

@fshovchko

Copy link
Copy Markdown
Contributor

In the scope of this PR was implemented a parser for .ts files to automatically generate documentation.
Closes #451

@fshovchko fshovchko added the documentation Improvements or additions to documentation label Sep 28, 2022
@fshovchko
fshovchko requested a review from a team September 28, 2022 12:30
@fshovchko fshovchko self-assigned this Sep 28, 2022
@fshovchko
fshovchko requested review from abarmina, ala-n and yadamskaya and removed request for a team September 28, 2022 12:30
@fshovchko
fshovchko marked this pull request as draft September 29, 2022 08:35
@ala-n ala-n linked an issue Oct 14, 2022 that may be closed by this pull request
@fshovchko
fshovchko requested a review from dshovchko December 17, 2022 23:27
@ala-n ala-n added the postponed Postponed issue label Aug 8, 2023
@ala-n ala-n removed this from the 🍀 GH Pages Redesign Enhancements milestone Aug 8, 2023
Base automatically changed from main-beta to main April 13, 2026 15:21
@qltysh

qltysh Bot commented Apr 13, 2026

Copy link
Copy Markdown

6 new issues

Tool Category Rule Count
editorconfig-checker Lint Trailing whitespace 4
qlty Structure Function with many returns (count = 6): visitChild 2

ts.ScriptTarget.Latest,
true
);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trailing whitespace [editorconfig-checker:trim_trailing_whitespace]

if (ts.isFunctionDeclaration(declaration)) return addFunctionOverloads(declaration, output);
if (ts.isTypeAliasDeclaration(declaration)) return output.push(getAlias(declaration));
if (ts.isVariableStatement(declaration) && ts.isFunctionLike(declaration.declarationList.declarations[0].initializer))
return output.push(getFunctionStatement(declaration));

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Function with many returns (count = 6): visitChild [qlty:return-statements]

if (ts.isSetAccessorDeclaration(member)) return declarationObj.setAccessors.push(getFunctionDeclaration(member));
});
if (!declarationObj.ctors.length) declarationObj.ctors.push(getConstRuctorDeclaration(declaration));
return declarationObj;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Function with many returns (count = 7): getClass [qlty:return-statements]

}

function getArgument(parameter) {
const tags = ts.getJSDocTags(parameter)[0];

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trailing whitespace [editorconfig-checker:trim_trailing_whitespace]


module.exports = {
getTypeSignature,
getGenericTypes

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trailing whitespace [editorconfig-checker:trim_trailing_whitespace]

const name = getDeclarationName(declaration);
const comment = getJSDocFullText(declaration);
const signature = `${name} = ${declaration.type.getText()}`;
return {type, name, comment, signature};

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trailing whitespace [editorconfig-checker:trim_trailing_whitespace]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation postponed Postponed issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[🚀site]: ts-doc based interactive documentation mechanism

2 participants