First draft of At A Glance article - #53
Conversation
Mark90
left a comment
There was a problem hiding this comment.
Great start! Left some comments.
I'm also not sure yet where best to place this in the nav bar
| # Behind the Scenes | ||
|
|
||
| So what's actually happening behind the scenes when we run these workflows? | ||
|
|
||
| WFO provides none of the facilities for talking to Netbox, NSO, Ansible, etc. | ||
| These features are implemented by other packages or by the software team leveraging the framework. |
There was a problem hiding this comment.
This section could probably be expanded a little more
There was a problem hiding this comment.
I elaborated a bit, but I'm not sure if it's in the direction you have in mind. What would feel most helpful / relevant to share?
There was a problem hiding this comment.
On second read it is good actually. "WFO provides none of the facilities for talking to Netbox, NSO, Ansible, etc." is fair, although for ansible there is the option to use LSO.
Maybe we could also briefly describe in the next paragraph the (at least for us, and in example-orchestrator) common pattern of implementing a services/netbox.py module for system interaction, and using that in workflow steps.
There was a problem hiding this comment.
Updated with a tiny little commit!
* Add mkdocs-glightbox for clicking on screenshots to enlarge them * Fix mkdocs-glightbox not working consistently * Fix reload error on subprojects
30dd427 to
f31d68b
Compare
Here's my first pass at a draft of the "not a video" crash course.
The goal is provide a brief elevator pitch that's accessible to network operators, developers, managers, etc. People want to know what it is, what it does, and what it would look like to use it.
Some open questions for reviewers:
Closes #19