DocFX VS Jekyll

DocFX Reviews

Jekyll Reviews

DocFX mentions (7)

• TSDocs.dev: type docs for any JavaScript library

  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 / 5 months ago

• What Does Microsoft Use to Create their KB Articles?

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

• Library / Codebase Documentation - Multiple aggregated libraries - How to create? DocFx does not support this?

  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

• CSharp Docuementation Site

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

• What platform is Microsoft Docs hosted on?

  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

Jekyll mentions (180)

• Creating excerpts in Astro

  This blog is running on Hugo. It had previously been running on Jekyll. Both these SSGs ship with the ability to create excerpts from your markdown content in 1 line or thereabouts. - Source: dev.to / about 2 months ago

• JS Toolbox 2024: Essential Picks for Modern Developers Series Overview

  We also take a look into static site generators, covering Astro, Nuxt, Hugo, Gatsby, and Jekyll. We take a detailed look into their usability, performance, and community support. - Source: dev.to / 2 months ago

• Starlight vs. Docusaurus for building documentation

  In that case, what we need would be closer to a static site generator (like Gatsby, Hugo, Jekyll). But, static site generators aren't the best choice either because we would have to build a lot of documentation-focused functionality (like versioning, search, and code blocks) ourselves. - Source: dev.to / 3 months ago

• Ask HN: Looking for lightweight personal blogging platform

  In future, if you want to move from Jekyll to something else, you just have to worry about that `_posts` and `_assets` folder. They may have different naming convention but you can just config-managed it or change it to your choice. This is why I suggested owning that two yourself. You also may not worry about FrontMatter[3] (meta in the header) and its accompanying jazz by asking Jekyll to use the plugins... - Source: Hacker News / 3 months ago

• Ask HN: Looking for lightweight personal blogging platform

  As per many other comments, it sounds like a static site generator like Hugo (https://gohugo.io/) or Jekyll (https://jekyllrb.com/), hosted on GitHub Pages (https://pages.github.com/) or GitLab Pages (https://about.gitlab.com/stages-devops-lifecycle/pages/), would be a good match. If you set up GitHub Actions or GitLab CI/CD to do the build and deploy (see e.g.... - Source: Hacker News / 3 months ago