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