hendriknielaender / zBench

📊 zig benchmark
https://hendriknielaender.github.io/zBench/
MIT License
38 stars 8 forks source link

Add Advanced Guides to zBench Documentation #28

Open hendriknielaender opened 6 months ago

hendriknielaender commented 6 months ago

Issue Description

Currently, the zBench documentation provides coverage of basic usage. However, there's a need for more advanced guides that delve deeper into the library's capabilities, particularly for users who are ready to explore complex benchmarking scenarios.

Need for Advanced Guides

Advanced users of zBench could greatly benefit from guides that explore:

These topics are essential for users who wish to leverage the full potential of zBench in more complex environments.

Proposed Advanced Guides

  1. Custom Metrics Guide: A detailed walkthrough on how to implement and use custom metrics in zBench.
  2. Concurrent Benchmarking Guide: Instructions and examples on how to benchmark concurrent or asynchronous code.
  3. Result Analysis Guide: Techniques and tips for performing an in-depth analysis of benchmarking results.
  4. CI/CD Integration Guide: A guide on integrating zBench into CI/CD pipelines to automate performance testing.

Action Items

Expected Outcome

The addition of these advanced guides will not only enrich our documentation but also empower our users to use zBench more effectively in complex scenarios. It will bridge the gap between intermediate and advanced usage, making zBench a more versatile tool for performance analysis.

Additional Notes

Any contributions, suggestions, or discussions regarding the content and structure of these guides are highly welcome. Collaboration on this task is key to ensuring that the guides are comprehensive and beneficial to our user base.

FObersteiner commented 1 month ago

Not exactly an advanced guide but speaking of docs (not worth an extra issue IMHO) - currently, the "Install Options" take up a lot of space in the main readme.

hendriknielaender commented 1 month ago

Good point! I will quickly create a PR for it 👍