You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jdo-dev@db.apache.org by Craig Russell <ap...@gmail.com> on 2019/07/24 22:03:32 UTC

Fwd: Docsy - documentation website

Hi,

This is the web site builder I was talking about in the last meeting.

We have volunteers from the Google cloud folks to help us set up a site and give them feedback on how useful, easy, challenging, or whatever it is for JDO.

Check it out.

Craig

> Begin forwarded message:
> 
> From: Aizhamal Nurmamat kyzy <ai...@apache.org>
> Subject: Docsy - documentation website
> Date: July 24, 2019 at 1:57:58 PM PDT
> To: "* Craig L Russell" <cl...@apache.org>, ke4qqq@apache.org
> 
> Hi David and Craig,
> 
> Apologies that it took me so long to send you info and links about Docsy. Here a little bit of a background:
> 
> - Docsy is a template for Hugo, which is a popular open-source static site generator written in Go.
> - Docsy was started by the documentation team at Google, because they wanted to create a template for documentation and information architecture that was very easy to use, set up, and that that open source projects could adopt easily.
> - Many static websites are built in Jekyll. One of the main strengths of Docsy over Jekyll is multi-language support, which is not great in Jekyll. Docsy is built in Hugo and it natively supports many languages, which makes the localization efforts easier for open source projects
> - Another notable thing about Docsy is that it is very simple and fast to set up. Also, being built with Go, it has very fast build time for the website; so it enables quick development workflows.
> 
> Here is an example site [1]. There are few open source projects that already use Docsy for their documentation, like Kubeflow [2] and Agones [3].
> 
> Let me know if you find it useful and want to set up something in Docsy. I will be very happy to help :) 
> 
> Thanks,
> Aizhamal
> 
> [1] https://example.docsy.dev/ <https://example.docsy.dev/>
> [2] https://www.kubeflow.org/ <https://www.kubeflow.org/>
> [3] https://agones.dev/site/ <https://agones.dev/site/>

Craig L Russell
clr@apache.org