Re: Improving the Apache Ozone Website and Documentation

2023-08-30 Thread Wei-Chiu Chuang
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

2023-08-30 Thread Ethan Rose
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

2023-08-30 Thread Arpit Agarwal
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

2023-08-30 Thread Sammi Chen
+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