DEV Community

Discussion on: A short-list with documentation generators in 2019

Collapse
 
cjbrooks12 profile image
Casey Brooks

I've been building Orchid to be especially good for making a single website for both wiki-type prose documentation, and also API docs for your code. It also deploys your site automatically to Github Pages!

GitHub logo orchidhq / Orchid

Build and deploy beautiful documentation sites that grow with you

Orchid

Linux and Mac Build Status Windows Build status Current Version License: LGPL-3.0 Codacy Grade Codacy Coverage Gitter chat Backers on Open Collective Sponsors on Open Collective Open Source Helpers

A beautiful and truly unique documentation engine and static site generator.

Example Orchid site

Orchid is a brand-new, general-purpose static site generator for Java and Kotlin, with a focus on extensibility and aimed at developers looking to improve their technical documentation. Orchid was born out of a desire for better-looking Javadocs and frustration with how difficult is it to manage large Jekyll sites and keep it up-to-date with your code.

Orchid supports a variety of plugins, including a wiki, static pages, blogs, and much more. It aims to have high compatibility with many of the existing static site generators, such as Jekyll, Gitbook, and Hugo, so that migration to Orchid is painless. And if you can't find a plugin to do what you need, Orchid provides an intuitive way to add your own private plugins and a rich API so you can make your site as beautiful and unique as an Orchid.

It currently supports generating docs for Java, Kotlin, Groovy, and Swift; Ruby and Javascript are on the roadmap too. A recent update also added support for automatically pulling in wiki content from Github and Gitlab Wikis.

Here's a good intro to getting started with Orchid:

Collapse
 
sm0ke profile image
Sm0ke

looks good.