Refactor fabric documentation

[ClausHolbechArista]

Change Summary

Complete rewrite of the fabric documentation for eos_l3ls_evpn

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Code style update (formatting, renaming)
• Refactoring (no functional changes)
• Documentation content changes
• Other (please describe):

Related Issue(s)

Fixes issue #552
Fixes issue #475

Component(s) name

arista.avd.eos_l3ls_evpn
arista.avd.build_output_folders

Proposed changes

• Move fabric documentation to documentation/fabric/
• Change Markdown filename to <fabric_name>-documentation.md
• Change directory and documentation tasks to run_once
• Document fabric_name, dc_name and pod_name variables
• Include POD Name in fabric documentation
• Only include L3 links between inventory devices in p2p CSV files
• Include all links of all types in topology CSV files
• Support 5-stage CLOS and multiple PODs in single fabric documentation file
• Support for super-spine, overlay-controller device types
• Updated molecule folders
• Update molecule makefile to support cleanup (needed when changing folder structure)

How to test

Tested with my repo as well as all the molecule test scenarios.
Works for both l3ls and multipod

Checklist:

• My code has been rebased from devel before I start
• I have read the CONTRIBUTING document.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have updated molecule CI testing accordingly
• All new and existing tests passed (pre-commit, make linting and make sanity-lint).

[titom73]

Looks good to me!
(Tested with an additional 3-stage clos fabric)

[ClausHolbechArista]

Hold on a second. Found a few issues I will fix

[titom73]

If we list mlag_peer in the topology, should not we also provide L3 interfaces for MLAG as well since these links are now listed in the documentation?

[ClausHolbechArista]

I did not want to delay this by adding too many new areas, but we should add (in another PR):
Summary of # devices of each type
List of other interfaces (excl server) (custom and comming dci)
Mlag peer and ibgp vlan and pools
L2leaf inband management

[titom73]

I did not want to delay this by adding too many new areas, but we should add (in another PR):
Summary of # devices of each type
List of other interfaces (excl server) (custom and comming dci)
Mlag peer and ibgp vlan and pools
L2leaf inband management

Ok sounds like a good plan.

[titom73]

Looks good to me!