Create user guide for Wireless Networks

[smk4664]

What's Changed

This is the user guide for Wireless Networks. We are using the Central Mode as an example as this utilizes the most features of Wireless Networks and Controllers.

Screenshots

TODO

• Explanation of Change(s)
• Added change log fragment(s) (for more information see the documentation)
• Attached Screenshots, Payload Example
• Unit, Integration Tests
• Documentation Updates (when adding/changing features)
• Example App Updates (when adding/changing features)
• Outline Remaining Work, Constraints from Design

[gsnider2195]

Looks good! These suggestions are by no means required, I just think they will help readability.

[cmsirbu]

My only criticism here would be that the data created in the guide is not linked to the opening diagram. Other users may not notice immediately that devices are just whatever existed on the demo sandbox and belong to mixed locations etc.

I was expecting that this guide would take users to a complete configuration of the topology presented at the start... so they can see how all the objects tie together in a real life scenario.

[smk4664]

My only criticism here would be that the data created in the guide is not linked to the opening diagram. Other users may not notice immediately that devices are just whatever existed on the demo sandbox and belong to mixed locations etc.

I was expecting that this guide would take users to a complete configuration of the topology presented at the start... so they can see how all the objects tie together in a real life scenario.

That was on purpose as I did not cover the creation of location or devices, plus the opening diagram was being replaced, the new diagram will use the names from Sandbox.

[cmsirbu]

My only criticism here would be that the data created in the guide is not linked to the opening diagram. Other users may not notice immediately that devices are just whatever existed on the demo sandbox and belong to mixed locations etc.
I was expecting that this guide would take users to a complete configuration of the topology presented at the start... so they can see how all the objects tie together in a real life scenario.

That was on purpose as I did not cover the creation of location or devices, plus the opening diagram was being replaced, the new diagram will use the names from Sandbox.

I'd say there's no need to cover creation, but you could list out at the start the related objects (the names as used in the design, not just the types) that you'll be using which are already there for this whole design: Locations, Vlans, Devices, Platforms - and yes use as much of the new demo data as possible!

I think the screenshots are great and showcase the "how" (to add a particular object) step by step... and would benefit greatly from listing which objects you'd create for this design with real names and an explanation of the "why".

Remember, this should help a network operator/engineer transpose their network into Nautobot models by implementing a fully fledged example. What we need is a story to tie it all together "how do I go from my Visio diagram of the network to data in Nautobot that models it and allows me to automate deployment/verification etc?"