docs: 📝 update docs

docs/admin/integrations/librenms_setup.md

@@ -36,6 +36,8 @@ The way you add your LibreNMS server instance is through the "External Integrati
 
 Once this is created, go into the Extensibility Menu and select `External Integrations`. Add an External Intergration with the Remote URL being your LibreNMS server URL (including http(s)://), set the method to `GET`, and select any other headers/settings you might need for your specific instance. Select the secrets group you created as this will inject the API token. Once created, you will select this External Integration when you run the LibreNMS to Nautobot SSoT job.
 
+![LibreNMS External Integration](../../images/librenms-external-integration.png)
+
 #### LibreNMS as DataTarget
 
 NotYetImplemented

docs/user/integrations/librenms.md

@@ -4,6 +4,30 @@
 
 ### LibreNMS as DataSource
 
+The LibreNMS SSoT integration is built as part of the [Nautobot Single Source of Truth (SSoT)](https://github.com/nautobot/nautobot-app-ssot) app. the SSoT app enables Nautobot to be the aggregation point for data coming from multiple systems of record (SoR).
+
+#### Job Options
+
+- Debug: Additional Logging
+- Librenms Server: External integration object pointing to the required LibreNMS instance.
+- hostname_field: Which LibreNMS field to use as the hostname in Nautobot. sysName or hostanme.
+- sync_location_parents: Whether to lookup City and State to add parent locations for geo locations.
+
+From LibreNMS into Nautobot, the app synchronizes devices, their interfaces, associated IP addresses, and Locations. Here is a table showing the data mappings when syncing from LibreNMS.
+
+| LibreNMS objects        | Nautobot objects             |
+| ----------------------- | ---------------------------- |
+| geo location            | Location  `*`                |
+| device                  | Device                       |
+| interface               | Interface                    |
+| device os               | Platform/Manufacturer `**`   |
+| os version              | Software/SoftwareImage       |
+| ip address              | IPAddress                    |
+| hardware                | DeviceType                   |
+
+`*` geo locations are looked up gia the [geocode api](https://geocode.xyz) if gps coordinates are set in LibreNMS and Regions will be created for City and State as parents for the actual location.
+
+`**` Device OS from LibreNMS is not standardized and therefore there is a mapping that can be updated in the `constants.py` file for the integration as more device manufacturers and platforms need to be added.
 
 ### LibreNMS as DataTarget