opensearch-benchmark icon indicating copy to clipboard operation
opensearch-benchmark copied to clipboard

[META] Enhance OpenSearch Benchmark Documentation

Open IanHoang opened this issue 1 year ago • 2 comments

The OSB documentation debuted in 2023 and has been improved on over the course of the last year. As new users join the community and OSB continues to grow, the documentation should be continuously refined. This META issue is dedicated to making enhancements towards the documentation.

Below is a table of planned enhancements to the documentation:

Page Title / Task Which Section to Add in PRs Status
OSB 2.0.0 & Migration Steps User Guide & Reference https://github.com/opensearch-project/documentation-website/pull/7888 Doc-Review
Enhance Operations Reference User Guide & Reference https://github.com/opensearch-project/documentation-website/pull/7974/files Doc-Review
Glossary Reference In Progress
Flesh out Telemetry Devices in User Guide Reference Not Started
Reorganize User Guide into Sub Sections Reference Not Started
Build Custom Components Tutorials Not Started
Create Workload Enhancements User Guide Not Started
Performance Testing Best Practices User Guide Not Started
How to Duplicate the Nightly Runs Setup Tutorials Not Started
Enhance Developer Documentation User Guide Not Started
Tutorial: Setup OSB in a VPC / non-VPC Tutorials Not Started

IanHoang avatar Aug 06 '24 16:08 IanHoang

Enhance Operations Reference is In-Progress. We'll start the Glossary this week as well.

Naarcha-AWS avatar Aug 26 '24 19:08 Naarcha-AWS

OSB 2.0.0 document is ready and will be converted to draft until we are ready to release OSB 2.0.0

IanHoang avatar Aug 26 '24 20:08 IanHoang

Let's convert this to a board and convert them items into issues

IanHoang avatar Oct 01 '24 21:10 IanHoang

Closing this as we can now use the board https://github.com/orgs/opensearch-project/projects/228/views/1

IanHoang avatar Oct 03 '24 15:10 IanHoang