Skip to content

Releases: peterpeterparker/tsdoc-markdown

v0.6.0

18 Apr 10:20
Compare
Choose a tag to compare

Features

  • Generate jsDoc @example content (#28).

Shout-out to mingtianyihou33 for the contributions! 💪

v0.5.0

10 Apr 19:50
Compare
Choose a tag to compare

Features

  • Support for Enum.

Shout-out to mingtianyihou33 for the contributions! 💪

v0.4.0

17 Mar 10:44
Compare
Choose a tag to compare

Features

  • Enable strictNullChecks per default when creating TypeScript compiler program. This allow exporting parameters and results that unions null or undefined.

For example:

/**
 * Markdown should handle ` | ` for the type.
 */
export const genericType = <T>(value: [] | [T]): T | undefined => value?.[0];

Previously did not parsed the result | undefined in the resulting documentation.

v0.3.0

16 Feb 10:31
Compare
Choose a tag to compare

Features

  • Add support for jsDocs in Interfaces when generating markdown.

v0.2.1

16 Feb 06:24
Compare
Choose a tag to compare

Fix

  • Remove backtick for the description of the Interfaces in generated markdown content.

v0.2.0

16 Feb 06:12
Compare
Choose a tag to compare

Features

  • Support for generating documentation for interfaces and types. This new feature is optional and can be enabled using the build options --types.

v0.1.0

22 Sep 06:45
67a8bfb
Compare
Choose a tag to compare

Features

  • upgrade to typescript@^5 (#13)

Docs

  • use all-contributors do showcase contributors on README (#15)

Build

  • release to npm from CI with provenance flag

Shout-out to mia-riezebos for the contributions! 💪

v0.0.4

02 Jul 12:30
Compare
Choose a tag to compare

Features

  • generate links to source code for class members (#12)

v0.0.3

02 Jul 11:55
Compare
Choose a tag to compare

Breaking Changes

  • provide the links to the source code in the json output as well (#11)

Fix

  • use relative path to generate links (#10)

Because this release aim to provide the links to the source code in the outputed JSON file as well, the configuration has to be change.
i.e. the repo URL is not a MarkdownOptions anymore but, a BuildOptions

generateDocumentation({
  inputFiles: utilsInputFiles,
  outputFile: './packages/utils/YOLO.md',
  buildOptions: {
    explore: true,
    repo: {
      url: 'https://github.com/peterpeterparker/tsdoc-markdown'
    }
  }
});

v0.0.2

02 Jul 11:03
Compare
Choose a tag to compare

Features

  • generate links to the documented source code (#5)
  • ignore constructors without documentation (#4)

Docs

  • display a note about the limitation regarding Types and Interfaces (#6)

Build

  • bump dev dependencies

Generating links is an optional feature as it requires the knowledge of the repository URL to which the links should point. If you are using the provided script, you can pass the URL using the --repo parameter. Alternatively, when using the code, you can provide the repository URL through the MarkdownOptions object.

generateDocumentation({
  inputFiles: utilsInputFiles,
  outputFile: './packages/utils/YOLO.md',
  buildOptions: {explore: true},
  markdownOptions: {
    repo: {
      url: 'https://github.com/peterpeterparker/tsdoc-markdown'
    }
  }
});