Overhaul docs

README.md

@@ -41,6 +41,10 @@ This Nautobot application framework includes the following integrations:
 
 Read more about integrations [here](https://docs.nautobot.com/projects/ssot/en/latest/user/integrations). To enable and configure integrations follow the instructions from [the install guide](https://docs.nautobot.com/projects/ssot/en/latest/admin/install/#integrations-configuration).
 
+### Building Your Own Integration
+
+If you need an integration that is not supported, you can build your own! Check out the documentation [here](https://docs.nautobot.com/projects/ssot/en/latest/dev/jobs).
+
 ### Screenshots
 
 ---

changes/468.documentation

@@ -0,0 +1 @@
+Overhauled developer documentation structure.

changes/468.fixed

@@ -0,0 +1 @@
+Fixed SSoT jobs only allowing dry run unless you overwrote the `run` method.

docs/dev/issues.md

@@ -0,0 +1,21 @@
+# Reference: Common Issues and Solutions
+
+This pages describes common issues when implementing SSoT integrations and their respective solutions.
+
+## Converting Types Between Database and Pydantic
+
+Developers are able to override the default loading of basic parameters to control how that parameter is loaded from Nautobot.
+
+This only works with basic parameters belonging to the model and does not override more complex parameters (foreign keys, custom fields, custom relationships, etc.).
+
+To override a parameter, add a method with the name `load_param_{param_key}` to your adapter class inheriting from `NautobotAdapter`:
+
+```python
+from nautobot_ssot.contrib import NautobotAdapter
+
+class YourSSoTNautobotAdapter(NautobotAdapter):
+    ...    
+    def load_param_time_zone(self, parameter_name, database_object):
+        """Custom loader for `time_zone` parameter."""
+        return str(getattr(database_object, parameter_name))
+```

docs/user/app_getting_started.md

@@ -44,3 +44,5 @@ PLUGINS_CONFIG = {
 ## What are the next steps?
 
 You can check out the [Use Cases](app_use_cases.md) section for more examples.
+
+Alternatively, if you intend to build your own integration, check out [Developing Data Source and Data Target Jobs](../dev/jobs.md).

mkdocs.yml

@@ -120,7 +120,6 @@ nav:
           - Cisco Meraki: "user/integrations/meraki.md"
           - ServiceNow: "user/integrations/servicenow.md"
           - Slurpit: "user/integrations/slurpit.md"
-      - Modeling: "user/modeling.md"
       - Performance: "user/performance.md"
       - Frequently Asked Questions: "user/faq.md"
       - External Interactions: "user/external_interactions.md"
@@ -166,12 +165,14 @@ nav:
           - v1.1: "admin/release_notes/version_1.1.md"
           - v1.0: "admin/release_notes/version_1.0.md"
   - Developer Guide:
-      - Extending the App: "dev/extending.md"
-      - Developing Jobs: "dev/jobs.md"
-      - Debugging Jobs: "dev/debugging.md"
-      - Contributing to the App: "dev/contributing.md"
+      - "Tutorial: Developing Jobs": "dev/jobs.md"
+      - "How To: Debugging Jobs": "dev/debugging.md"
+      - "Reference: Issues": "dev/issues.md"
+      - "Reference: Modeling": "dev/modeling.md"
       - Development Environment: "dev/dev_environment.md"
       - Upgrading SSoT Apps: "dev/upgrade.md"
+      - Extending the App: "dev/extending.md"
+      - Contributing to the App: "dev/contributing.md"
       - Code Reference:
           - "dev/code_reference/index.md"
           - Package: "dev/code_reference/package.md"