docs: rewrite of the documentation (#219)

see title

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **Documentation**
- Updated section title for improved clarity on the plugin's
functionality.
- Added a new subsection with usage hints, including installation
instructions and performance metrics.
- Introduced a section for reporting bugs and feature requests to
enhance user engagement and support.
- Expanded descriptions of SLURM resource specifications with detailed
examples and configurations.
  - Added a new section for frequently asked questions to assist users.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: David Laehnemann <david.laehnemann@hhu.de>

Author: 3 people