Need advice about which tool to choose?Ask the StackShare community!


+ 1

+ 1

+ 1
Decisions about DocGen, Gatsby, and Jekyll
Manuel Feller
Frontend Engineer at BI X · | 4 upvotes · 91.1K views

As a Frontend Developer I wanted something simple to generate static websites with technology I am familiar with. GatsbyJS was in the stack I am familiar with, does not need any other languages / package managers and allows quick content deployment in pure HTML or Markdown (what you prefer for a project). It also does not require you to understand a theming engine if you need a custom design.

See more
Get Advice from developers at your company using Private StackShare. Sign up for Private StackShare.
Learn More
Pros of DocGen
Pros of Gatsby
Pros of Jekyll
    Be the first to leave a pro
    • 20
      Generated websites are super fast
    • 14
    • 11
    • 8
      Progressive Web Apps generation
    • 7
      Reusable components (React)
    • 7
      Easy to connect with lots of CMS via official plugins
    • 6
      Allows to use markdown files as articles
    • 4
    • 4
    • 3
      List of starters as base for new project
    • 3
      All the benefits of a static website + React+GraphQL
    • 3
      Easy to connect with Drupal via official plugin
    • 2
      Open source
    • 1
      Gitlab pages integration
    • 1
      Incremental Build
    • 74
      Github pages integration
    • 53
      Open source
    • 37
      It's slick, customisable and hackerish
    • 23
      Easy to deploy
    • 22
      Straightforward cms for the hacker mindset
    • 6
      Gitlab pages integration
    • 4
      Best for blogging
    • 2
      Easy to integrate localization
    • 2
      Low maintenance
    • 1
      Huge plugins ecosystem
    • 1
      Authoring freedom and simplicity

    Sign up to add or upvote prosMake informed product decisions

    Cons of DocGen
    Cons of Gatsby
    Cons of Jekyll
      Be the first to leave a con
      • 6
        No ssr
      • 3
        Documentation isn't complete.
      • 2
        Very slow builds
      • 2
      • 2
        Slow builds
      • 2
        Flash of unstyled content issues
      • 1
        Problematic between develop and build commands
      • 1
        Difficult debugging
      • 1
        Plugin driven development
      • 1
        Difficult maintenance
      • 1
        Too many dependencies
      • 4
        Build time increases exponentially as site grows
      • 2
        Lack of developments lately
      • 1
      • 1
        Og doesn't work with postings dynamically

      Sign up to add or upvote consMake informed product decisions

      What is DocGen?

      DocGen is a command-line documentation tool for software products. It takes plain text or CommonMark (Markdown) as input, and generates both a static website and a PDF copy.

      What is Gatsby?

      Gatsby lets you build blazing fast sites with your data, whatever the source. Liberate your sites from legacy CMSs and fly into the future.

      What is Jekyll?

      Think of Jekyll as a file-based CMS, without all the complexity. Jekyll takes your content, renders Markdown and Liquid templates, and spits out a complete, static website ready to be served by Apache, Nginx or another web server. Jekyll is the engine behind GitHub Pages, which you can use to host sites right from your GitHub repositories.

      Need advice about which tool to choose?Ask the StackShare community!

      What companies use DocGen?
      What companies use Gatsby?
      What companies use Jekyll?

      Sign up to get full access to all the companiesMake informed product decisions

      What tools integrate with DocGen?
      What tools integrate with Gatsby?
      What tools integrate with Jekyll?

      Sign up to get full access to all the tool integrationsMake informed product decisions

      Blog Posts

      What are some alternatives to DocGen, Gatsby, and Jekyll?
      It is the only complete API development environment, used by nearly five million developers and more than 100,000 companies worldwide.
      Swagger UI
      Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API
      Hugo is a static site generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full html website. Hugo makes use of markdown files with front matter for meta data.
      Hexo is a fast, simple and powerful blog framework. It parses your posts with Markdown or other render engine and generates static files with the beautiful theme. All of these just take seconds.
      A minimalistic static site generator with a Vue-powered theming system, and a default theme optimized for writing technical documentation. It was created to support the documentation needs of Vue's own sub projects.
      See all alternatives