Re: Improving the Apache Ozone Website and Documentation

It’s been about a month since my last website status update. In the time I’ve found to work on this, most of my focus has been on providing a smooth developer experience to better facilitate contributions, with some minor housekeeping items on the side. Here’s what has happened since then: -

Re: Improving the Apache Ozone Website and Documentation

Hi all, I just wanted to provide some updates on the new website. I will try to send out these update emails more regularly in this thread to summarize progress. - We have a staging website deployed at https://ozone-site-v2.staged.apache.org. This is also linked from the main website Jira HDDS-922

Re: Improving the Apache Ozone Website and Documentation

Hi Ozone devs, It has been a while since I started this thread and got carried off into other issues. However, I have recently been able to shift focus back to this improvement effort. The overall website improvement is tracked under HDDS-9225, which is split into multiple child tasks. I have beg

Re: Improving the Apache Ozone Website and Documentation

In addition to layout revamp, one thing I'd love to see is more user docs. Our doc is by and large written for core Ozone developers. We need to have more content around how to run workarounds, how to migrate existing applications from HDFS to Ozone, API guide ... etc. On Mon, Aug 28, 2023 at 5:25

Re: Improving the Apache Ozone Website and Documentation

Yes Algolia integration for search would be something we would want to add as part of this effort. Yunikorn has it, and Spark has it as well, although they are using Jekyll. Either way, it looks like Apache projects are able to leverage Algolia and

Re: Improving the Apache Ozone Website and Documentation

Thank you for kicking off this much needed initiative Ethan. I’m not up to date on all the site generation frameworks however Docusaurus looks pretty good me. Also one major omission in our current docs website is search capability. I see the Yunikorn website you linked is using Algolia, it would

Re: Improving the Apache Ozone Website and Documentation

+1, thanks Ethan for the initiative. >From time to time, I have received feedback from the community that some of our documents are not-update-to-date. And I also noticed that many documents lack a Mandarin/Chinese edition. Here is track JIRA https://issues.apache.org/jira/browse/HDDS-2708. We a

Re: Improving the Apache Ozone Website and Documentation

Thanks Ethan for the initiative. +1 for the proposal. And +1 for Docusaurus. I've played with this doc framework a few months back. It is fine overall with decent community support as far as I can tell. Versioning is great, as well as i18n. Docusaurus v2 generates an SPA

Re: Improving the Apache Ozone Website and Documentation

I cannot seem to send the doc on this email thread, sorry for the confusion. I have instead filed HDDS-9225 as a parent Jira for this task and attached the doc there. The link is here

RE: Improving the Apache Ozone Website and Documentation

t 7946 550 Veterans United Drive | Columbia, MO 65201 eric.br...@vu.com<mailto:eric.br...@vu.com> | VeteransUnited.com<https://www.veteransunited.com/> From: Ethan Rose Sent: Tuesday, August 29, 2023 1:17 PM To: dev@ozone.apache.org Subject: [EXT] Re: Improving the Apache

Re: Improving the Apache Ozone Website and Documentation

Thanks for the responses, it seems the PDF document did not attach correctly. I have re-attached it to this email. If it is still not visible I will post it on Jira and share the link. Ethan On Tue, Aug 29, 2023 at 1:45 AM Zita Dombi wrote: > +1, this is a really good idea, I think many people

Re: Improving the Apache Ozone Website and Documentation

+1, this is a really good idea, I think many people will benefit from it. I started working on Ozone freshly graduated, as my first job, so I felt the disadvantages of the current website and documentation while learning about Ozone. The document you shared on the community sync is very detailed, y

Re: Improving the Apache Ozone Website and Documentation

+1 , this is a much needed improvement. Thanks, Dinesh On Mon, Aug 28, 2023 at 8:25 PM Ethan Rose wrote: > Hello Ozone Community, > > As many of you are aware, Ozone's website and documentation has remained > somewhat disorganized and lacking in content for a while. I would like to > kick star

Re: Improving the Apache Ozone Website and Documentation

kef> From: Ethan Rose Sent: Monday, August 28, 2023 5:25:16 PM To: dev@ozone.apache.org Subject: Improving the Apache Ozone Website and Documentation Hello Ozone Community, As many of you are aware, Ozone's website and documentation has remained somewhat disorganized and lacking in content

Improving the Apache Ozone Website and Documentation

Hello Ozone Community, As many of you are aware, Ozone's website and documentation has remained somewhat disorganized and lacking in content for a while. I would like to kick start an initiative to change that. I have attached a document outlining a plan to redo Ozone's website and documentation s