Consider restructuring the documentation page slightly so it's easier to navigate and examples are more evident / "front and center"

[flaviuvadan]

Feedback from multiple sources suggest that documentation can be improved both in content and in structure. See this Hera discussion and this CNCF Slack conversation. In order to facilitate onboarding and usage, we should restructure and document parts of Hera's features more