TypeDoc VS DocFX

Finally, JSDoc can be used to generate documentation for your code using tools like JSDoc itself and TypeDoc. These tools generate HTML or Markdown documentation based on your JSDoc annotations, making it easier for others to understand how your code works and how to use it. - Source: dev.to / about 1 year ago

Since you're using TypeScript, use TypeDoc. Source: about 1 year ago

I was thinking of using something like https://typedoc.org to do it, do you have experience with this sort of tools? Source: about 1 year ago

JSDoc is a terrible standard. I would rather go for TypeScript + TSDoc, then use TypDoc to generate the actual documentation based on TS typings. Alternatively, you can go for Vue Styleguidist. It's an excellent tool, but, opposite to TSDoc it's not a standard, it's just a tool. Source: over 1 year ago

API docs can be generated from docblocks the format of which will depend on the language in question e.g. TS = TypeDoc (parses TSdoc). Source: over 1 year ago

This is a better looking version of what Java and C# have had for a long time (kudos to the author for that!), is that the inspiration for this tool? https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html https://dotnet.github.io/docfx/ I saw the author mentioned in another comment that they found themselves peeping inside type declaration files "too often". While I do often use sites generated... - Source: Hacker News / 4 months ago

Actually, we use it for OptiTune, it's called "docfx" https://dotnet.github.io/docfx/. Source: about 2 years ago

We would really prefer to use a somewhat generic pre-made tool for this (such as DocFX) compared to rolling our own solution. We can roll our own solution... But would prefer not to so that we can minimize development and maintenance overhead. Source: over 2 years ago

I use docfx from microsoft to generate documentation for all my oss libraries. Source: over 2 years ago

My best guess would be that there's a CI/CD pipeline in GitHub that utilizes DocFX to convert the Markdown files to HTML. The constructed HTML files are then placed in an Azure Storage account that configured for Static Website Hosting combined with Azure CDN. Source: over 2 years ago