General docs tidy ups. Improve Script guides - Githubissues

argoproj-labs / hera

Hera makes Python code easy to orchestrate on Argo Workflows through native Python integrations. It lets you construct and submit your Workflows entirely in Python. ⭐️ Remember to star!

https://hera.rtfd.io

Apache License 2.0

560 stars 105 forks source link

General docs tidy ups. Improve Script guides #1199

Closed elliotgunton closed 5 days ago

elliotgunton commented 5 days ago

Pull Request Checklist

[x] Fixes #1198
[ ] ~Tests added~
[x] Documentation/examples added
[x] Good commit messages and/or PR title

Description of PR From issue description:

Script basics "explicit" example passes source=echo in a Task - this is not possible
Script annotations is quite confusing to read. Examples are overly complex/wordy, some being incorrect. We can also show that name can be inferred when #1193 is merged
expr guide's first link is dead, also some formatting can be tidied up
README is duplicated due to mascot image link, but we can fix this. Also note the PyPI page has a broken image