Feedback request: how can we make pyinfra’s documentation better

[Fizzadar]

I’d like to improve pyinfra’s documentation, I think there’s a few things that open come up and clearly need documenting better. Off the top of my head some of these are:

• operation execution (when do things execute)
• how to get output from an operation
• how to read system data before operations execute (ie the server.Command fact)

Would be amazing to hear what other things are unclear to people, and any ideas on how to better document or structure the docs would be much appreciated! 🙏