nautobot 2.0.0a3__py3-none-any.whl → 2.0.0b1__py3-none-any.whl

nautobot/docs/installation/upgrading-from-nautobot-v1.md

@@ -2,192 +2,42 @@
 
 ## Dependency Changes
 
+- Nautobot no longer uses or supports the use of `django-cryptography`.
 - Nautobot no longer uses or supports the use of `django-mptt`.
 - Nautobot no longer uses or supports the use of `django-rq`.
 
 ## Database (ORM) Changes
 
-### Database Behavior Changes
+### Database Field Behavior Changes
 
-| Model        | Field          | Changes                                                                           |
-|--------------|----------------|-----------------------------------------------------------------------------------|
-| (all)        | `created`      | Changed from DateField to DateTimeField                                           |
-| JobLogEntry  | `absolute_url` | No longer accepts `null` values, use `""` instead                                 |
-|              | `log_object`   | No longer accepts `null` values, use `""` instead                                 |
-| Prefix       | `is_pool`      | Replaced by new field `type`, valid choices are "Container", "Network" and "Pool" |
-|              | `status`       | Container status has been replaced by new field `type`                            |
-| ScheduledJob | `queue`        | No longer accepts `null` values, use `""` instead                                 |
-| Webhook      | `ca_file_path` | No longer accepts `null` values, use `""` instead                                 |
+Most of the database field behavior changes in Nautobot 2.0 fall into the following general categories:
+
+1. The `created` field on models has changed from a date only ("2023-04-06") to being a date/time ("2023-04-06T19:57:45.320232Z")
+2. Various models that had a required `site` field and an optional `location` field now have a required `location` field.
+
+??? info "Full table of database field behavior changes"
+    {data-table installation/tables/v2-database-behavior-changes.yaml}
 
 ### Renamed Database Fields
 
-| Model                   | Renamed Field                           | New Name                                       |
-|-------------------------|-----------------------------------------|------------------------------------------------|
-| CablePath               | `circuittermination`                    | `circuit_terminations`                         |
-|                         | `consoleport`                           | `console_ports`                                |
-|                         | `consoleserverport`                     | `console_server_ports`                         |
-|                         | `interface`                             | `interfaces`                                   |
-|                         | `powerfeed`                             | `power_feeds`                                  |
-|                         | `poweroutlet`                           | `power_outlets`                                |
-|                         | `powerport`                             | `power_ports`                                  |
-| Circuit                 | `termination_a`                         | `circuit_termination_a`                        |
-|                         | `termination_z`                         | `circuit_termination_z`                        |
-|                         | `terminations`                          | `circuit_terminations`                         |
-|                         | `type`                                  | `circuit_type`                                 |
-| Cluster                 | `group`                                 | `cluster_group`                                |
-|                         | `type`                                  | `cluster_type`                                 |
-| ConfigContextSchema     | `schema`                                | `config_context_schema`                        |
-|                         | `device_set`                            | `devices`                                      |
-|                         | `virtualmachine_set`                    | `virtual_machines`                             |
-| ContentType             | `computedfield_set`                     | `computed_fields`                              |
-|                         | `configcontext_set`                     | `config_contexts`                              |
-|                         | `configcontextschema_set`               | `config_context_schemas`                       |
-|                         | `customlink_set`                        | `custom_links`                                 |
-|                         | `dcim_device_related`                   | `devices`                                      |
-|                         | `dynamicgroup_set`                      | `dynamic_groups`                               |
-|                         | `exporttemplate_set`                    | `export_templates`                             |
-|                         | `imageattachment_set`                   | `image_attachments`                            |
-|                         | `note_set`                              | `notes`                                        |
-|                         | `virtualization_virtualmachine_related` | `virtual_machines`                             |
-| CustomFieldChoice       | `field`                                 | `custom_field`                                 |
-| CustomField             | `choices`                               | `custom_field_choices`                         |
-|                         | `slug`                                  | `key`                                          |
-| Device                  | `consoleports`                          | `console_ports`                                |
-|                         | `consoleserverports`                    | `console_server_ports`                         |
-|                         | `devicebays`                            | `device_bays`                                  |
-|                         | `device_role`                           | `role`                                         |
-|                         | `frontports`                            | `front_ports`                                  |
-|                         | `inventoryitems`                        | `inventory_items`                              |
-|                         | `local_context_data`                    | `local_config_context_data`                    |
-|                         | `local_context_data_owner_content_type` | `local_config_context_data_owner_content_type` |
-|                         | `local_context_data_owner_object_id`    | `local_config_context_data_owner_object_id`    |
-|                         | `local_context_schema`                  | `local_config_context_schema`                  |
-|                         | `poweroutlets`                          | `power_outlets`                                |
-|                         | `powerports`                            | `power_ports`                                  |
-|                         | `rearports`                             | `rear_ports`                                   |
-| DeviceRedundancyGroup   | `members`                               | `devices`                                      |
-| DeviceType              | `consoleporttemplates`                  | `console_port_templates`                       |
-|                         | `consoleserverporttemplates`            | `console_server_port_templates`                |
-|                         | `devicebaytemplates`                    | `device_bay_templates`                         |
-|                         | `frontporttemplates`                    | `front_port_templates`                         |
-|                         | `interfacetemplates`                    | `interface_templates`                          |
-|                         | `instances`                             | `devices`                                      |
-|                         | `poweroutlettemplates`                  | `power_outlet_templates`                       |
-|                         | `powerporttemplates`                    | `power_port_templates`                         |
-|                         | `rearporttemplates`                     | `rear_port_templates`                          |
-| FrontPortTemplate       | `rear_port`                             | `rear_port_template`                           |
-| InventoryItem           | `child_items`                           | `children`                                     |
-|                         | `level`                                 | `tree_depth`                                   |
-| Job                     | `job_hook`                              | `job_hooks`                                    |
-|                         | `results`                               | `job_results`                                  |
-| JobResult               | `logs`                                  | `job_log_entries`                              |
-|                         | `schedule`                              | `scheduled_job`                                |
-| Location                | `powerpanels`                           | `power_panels`                                 |
-| PowerOutletTemplate     | `power_port`                            | `power_port_template`                          |
-| PowerPanel              | `powerfeeds`                            | `power_feeds`                                  |
-| PowerPort               | `poweroutlets`                          | `power_outlets`                                |
-| PowerPortTemplate       | `poweroutlet_templates`                 | `power_outlet_templates`                       |
-| Rack                    | `group`                                 | `rack_group`                                   |
-|                         | `powerfeed_set`                         | `power_feeds`                                  |
-|                         | `reservations`                          | `rack_reservations`                            |
-| RackGroup               | `level`                                 | `tree_depth`                                   |
-|                         | `powerpanel_set`                        | `power_panels`                                 |
-| RearPort                | `frontports`                            | `front_ports`                                  |
-| RearPortTemplate        | `frontport_templates`                   | `front_port_templates`                         |
-| Region                  | `level`                                 | `tree_depth`                                   |
-| Relationship            | `associations`                          | `relationship_associations`                    |
-| Secret                  | `groups`                                | `secrets_groups`                               |
-|                         | `secretsgroupassociation_set`           | `secrets_group_associations`                   |
-| RIR                     | `aggregates`                            | [`prefixes`](#aggregate-migrated-to-prefix)    |
-| SecretsGroup            | `device_set`                            | `devices`                                      |
-|                         | `deviceredundancygroup_set`             | `device_redundancy_groups`                     |
-|                         | `gitrepository_set`                     | `git_repositories`                             |
-|                         | `secretsgroupassociation_set`           | `secrets_group_associations`                   |
-| SecretsGroupAssociation | `group`                                 | `secrets_group`                                |
-| Service                 | `ipaddresses`                           | `ip_addresses`                                 |
-| Status                  | `circuits_circuit_related`              | `circuits`                                     |
-|                         | `dcim_cable_related`                    | `cables`                                       |
-|                         | `dcim_device_related`                   | `devices`                                      |
-|                         | `dcim_deviceredundancygroup_related`    | `device_redundancy_groups`                     |
-|                         | `dcim_interface_related`                | `interfaces`                                   |
-|                         | `dcim_location_related`                 | `locations`                                    |
-|                         | `dcim_powerfeed_related`                | `power_feeds`                                  |
-|                         | `dcim_rack_related`                     | `racks`                                        |
-|                         | `ipam_ipaddress_related`                | `ip_addresses`                                 |
-|                         | `ipam_prefix_related`                   | `prefixes`                                     |
-|                         | `ipam_vlan_related`                     | `vlans`                                        |
-|                         | `virtualization_virtualmachine_related` | `virtual_machines`                             |
-|                         | `virtualization_vminterface_related`    | `vm_interfaces`                                |
-| Tenant                  | `group`                                 | `tenant_group`                                 |
-|                         | `rackreservations`                      | `rack_reservations`                            |
-| TenantGroup             | `level`                                 | `tree_depth`                                   |
-| User                    | `changes`                               | `object_changes`                               |
-|                         | `note`                                  | `notes`                                        |
-|                         | `rackreservation_set`                   | `rack_reservations`                            |
-| VirtualMachine          | `local_context_data`                    | `local_config_context_data`                    |
-|                         | `local_context_data_owner_content_type` | `local_config_context_data_owner_content_type` |
-|                         | `local_context_data_owner_object_id`    | `local_config_context_data_owner_object_id`    |
-|                         | `local_context_schema`                  | `local_config_context_schema`                  |
-| VLAN                    | `group`                                 | `vlan_group`                                   |
+Most renamed database fields in Nautobot 2.0 fall into the following general categories:
+
+1. Renaming of foreign keys and reverse relations to more consistently and specifically match the related model name or plural name (for example, `Circuit.terminations` to `Circuit.circuit_terminations`, `Rack.group` to `Rack.rack_group`)
+2. Renaming of tree model fields for consistency and due to the change from `django-mptt` to `django-tree-queries` (for example, `InventoryItem.child_items` to `InventoryItem.children` and `InventoryItem.level` to `InventoryItem.tree_depth`)
+
+??? info "Full table of renamed database fields"
+    {data-table installation/tables/v2-database-renamed-fields.yaml}
 
 ### Removed Database Fields
 
-| Model                   | Removed Field    |
-|-------------------------|------------------|
-| CircuitTermination      | `site`           |
-| CircuitType             | `slug`           |
-| Cluster                 | `site`           |
-| ClusterGroup            | `slug`           |
-| ClusterType             | `slug`           |
-| ConfigContext           | `sites`          |
-|                         | `regions`        |
-| CustomLink              | `slug`           |
-|                         | `regions`        |
-| CustomField             | `name`           |
-| Device                  | `site`           |
-| DeviceRedundancyGroup   | `slug`           |
-| DynamicGroup            | `slug`           |
-| GitRepository           | `_token`         |
-|                         | `username`       |
-| GraphQLQuery            | `slug`           |
-|                         | `username`       |
-| InventoryItem           | `lft`            |
-|                         | `rght`           |
-|                         | `tree_id`        |
-| IPAddress               | `vrf`            |
-| JobHook                 | `slug`           |
-| Location                | `site`           |
-| Manufacturer            | `slug`           |
-| Platform                | `slug`           |
-| Provider                | `slug`           |
-| PowerFeed               | `site`           |
-| PowerPanel              | `site`           |
-| Prefix                  | `is_pool`        |
-|                         | `site`           |
-| Rack                    | `site`           |
-| RackGroup               | `lft`            |
-|                         | `rght`           |
-|                         | `tree_id`        |
-| Region                  | `lft`            |
-|                         | `rght`           |
-|                         | `tree_id`        |
-| RIR                     | `slug`           |
-| RelationshipAssociation | `slug`           |
-| Role                    | `slug`           |
-| RouteTarget             | `slug`           |
-| Secret                  | `slug`           |
-| SecretsGroup            | `slug`           |
-| SecretsGroupAssociation | `slug`           |
-| Status                  | `slug`           |
-| Tenant                  | `slug`           |
-| TenantGroup             | `lft`            |
-|                         | `rght`           |
-|                         | `slug`           |
-|                         | `tree_id`        |
-| VLAN                    | `site`           |
-| VLANGroup               | `site`           |
-| Webhook                 | `slug`           |
-| VRF                     | `enforce_unique` |
+Most removed database fields in Nautobot 2.0 fall into the following general categories:
+
+1. Removal of references to removed models such as `Site` and `Region`
+2. Removal of `slug` fields in preference to the use of autogenerated natural-key slugs.
+3. Removal of `django-mptt` internal fields (`lft`, `rght`, `tree_id`)
+
+??? info "Full table of removed database fields"
+    {data-table installation/tables/v2-database-removed-fields.yaml}
 
 ### Replaced Models
 
@@ -253,113 +103,34 @@ The `ipam.IPAddress` model has been modified to have a foreign key to `ipam.Pref
 
 ### API Behavior Changes
 
-| Model                 | Field          | Changes                                                                                                  |
-|-----------------------|----------------|----------------------------------------------------------------------------------------------------------|
-| (all)                 | `created`      | Now is a date/time (`"2023-02-14T19:57:45.320232Z"`) rather than only a date                             |
-| Cable                 | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| Circuit               | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| Device                | `location`     | Now `location` has changed to a required field on this model Serializer                                  |
-|                       | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| DeviceRedundancyGroup | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| Interface             | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| IPAddress             | `role`         | `/ipam/ip-addresses/` endpoint now uses role nested serializer for the role field, rather than a string. |
-|                       | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| Location              | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| PowerFeed             | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| PowerPanel            | `location`     | Now `location` has changed to a required field on this model Serializer                                  |
-| Prefix                | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| Rack                  | `location`     | Now `location` has changed to a required field on this model Serializer                                  |
-|                       | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| RackGroup             | `location`     | Now `location` has changed to a required field on this model Serializer                                  |
-|                       | `rack_count`   | Now only counts Racks directly belonging to this RackGroup, not those belonging to its descendants.      |
-| Region                | `site_count`   | Now only counts Sites directly belonging to this Region, not those belonging to its descendants.         |
-| Site                  | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| TenantGroup           | `tenant_count` | Now only counts Tenants directly belonging to this TenantGroup, not those belonging to its descendants.  |
-| VirtualMachine        | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| VLAN                  | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
-| VMInterface           | `status`       | Now uses a nested Status serializer, rather than `{"value": "<slug>", "label": "<name>"}`                |
+Most of the API behavior changes in Nautobot 2.0 fall into the following general categories:
+
+1. The `created` field on most models has changed from a date only ("2023-04-06") to being a date/time ("2023-04-06T19:57:45.320232Z")
+2. The `status` fields on various models has changed from a pseudo-enum value (containing a "value" and a "label") to referencing the related Status object in full, similar to other foreign-key fields.
+3. Various models that had a required `site` field and an optional `location` field now have a required `location` field.
+
+??? info "Full table of API behavior changes"
+    {data-table installation/tables/v2-api-behavior-changes.yaml}
 
 ### Renamed Serializer Fields
 
-| Model                   | Renamed Field          | New Name                      |
-|-------------------------|------------------------|-------------------------------|
-| Circuit                 | `termination_a`        | `circuit_termination_a`       |
-|                         | `termination_z`        | `circuit_termination_z`       |
-|                         | `type`                 | `circuit_type`                |
-| ConfigContext           | `schema`               | `config_context_schema`       |
-| Cluster                 | `group`                | `cluster_group`               |
-|                         | `type`                 | `cluster_type`                |
-| CustomField             | `slug`                 | `key`                         |
-| CustomFieldChoice       | `field`                | `custom_field`                |
-| Device                  | `device_role`          | `role`                        |
-|                         | `local_context_data`   | `local_config_context_data`   |
-|                         | `local_context_schema` | `local_config_context_schema` |
-| FrontPortTemplate       | `rear_port`            | `rear_port_template`          |
-| Interface               | `count_ipaddresses`    | `ip_address_count`            |
-| IPAddress               | `family`               | `ip_version`                  |
-| InventoryItem           | `_depth`               | `tree_depth`                  |
-| Location                | `virtualmachine_count` | `virtual_machine_count`       |
-| Manufacturer            | `devicetype_count`     | `device_type_count`           |
-|                         | `inventoryitem_count`  | `inventory_item_count`        |
-| Platform                | `virtualmachine_count` | `virtual_machine_count`       |
-| Prefix                  | `family`               | `ip_version`                  |
-| PowerOutletTemplate     | `power_port`           | `power_port_template`         |
-| PowerPanel              | `powerfeed_count`      | `power_feed_count`            |
-| Rack                    | `group`                | `rack_group`                  |
-|                         | `powerfeed_count`      | `power_feed_count`            |
-| JobResult               | `schedule`             | `scheduled_job`               |
-| RackGroup               | `_depth`               | `tree_depth`                  |
-| Region                  | `_depth`               | `tree_depth`                  |
-| SecretsGroupAssociation | `group`                | `secrets_group`               |
-| Service                 | `ipaddresses`          | `ip_addresses`                |
-| Tenant                  | `group`                | `tenant_group`                |
-| TenantGroup             | `_depth`               | `tree_depth`                  |
-| VirtualMachine          | `local_context_data`   | `local_config_context_data`   |
-|                         | `local_context_schema` | `local_config_context_schema` |
-| VLAN                    | `group`                | `vlan_group`                  |
+Most renamed API fields in Nautobot 2.0 fall into the following general categories:
+
+1. Renaming of foreign keys and reverse relations to more consistently and specifically match the related model name or plural name (for example, `Circuit.type` to `Circuit.circuit_type`, `Interface.count_ipaddresses` to `Interface.ip_address_count`)
+2. Renaming of tree model fields for consistency and due to the change from `django-mptt` to `django-tree-queries` (for example, `InventoryItem._depth` to `InventoryItem.tree_depth`)
+
+??? info "Full table of renamed API fields"
+    {data-table installation/tables/v2-api-renamed-fields.yaml}
 
 ### Removed Serializer Fields
 
-| Model/Endpoint                       | Removed Field        | Comments                                              |
-|--------------------------------------|----------------------|-------------------------------------------------------|
-| `/api/status/`                       | `rq-workers-running` | Removed as RQ is no longer supported                  |
-| `/circuits/circuit-terminations/`    | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/circuits/circuit-types/`           | `slug`               | `slug` field no longer supported                      |
-| `/circuits/providers/`               | `slug`               | `slug` field no longer supported                      |
-| `/extras/config-contexts/`           | `regions`            | `Site` and `Region` models are replaced by `Location` |
-|                                      | `sites`              | `Site` and `Region` models are replaced by `Location` |
-| `/dcim/device-redundancy-groups/`    | `slug`               | `slug` field no longer supported                      |
-| `/dcim/devices/`                     | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/dcim/locations/`                   | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/dcim/manufacturers/`               | `slug`               | `slug` field no longer supported                      |
-| `/dcim/platforms/`                   | `slug`               | `slug` field no longer supported                      |
-| `/dcim/power-feeds/`                 | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/dcim/power-panels/`                | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/dcim/racks/`                       | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/dcim/rack-groups/`                 | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/extras/custom-links/`              | `slug`               | `slug` field no longer supported                      |
-| `/extras/dynamic-groups/`            | `slug`               | `slug` field no longer supported                      |
-| `/extras/graphql-queries/`           | `slug`               | `slug` field no longer supported                      |
-| `/extras/job-hooks/`                 | `slug`               | `slug` field no longer supported                      |
-| `/extras/relationship-associations/` | `slug`               | `slug` field no longer supported                      |
-| `/extras/roles/`                     | `slug`               | `slug` field no longer supported                      |
-| `/extras/secrets/`                   | `slug`               | `slug` field no longer supported                      |
-| `/extras/secrets-groups/`            | `slug`               | `slug` field no longer supported                      |
-| `/extras/statuses/`                  | `slug`               | `slug` field no longer supported                      |
-| `/extras/webhooks/`                  | `slug`               | `slug` field no longer supported                      |
-| `/ipam/prefixes/`                    | `is_pool`            | Functionality replaced by `type` field                |
-|                                      | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/ipam/ip-addresses/`                | `vrf`                | VRFs are now inherited from parent `Prefix`           |
-| `/ipam/rirs/`                        | `slug`               | `slug` field no longer supported                      |
-| `/ipam/route-targets/`               | `slug`               | `slug` field no longer supported                      |
-| `/ipam/vlans/`                       | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/ipam/vlangroups/`                  | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/ipam/vrfs/`                        | `enforce_unique`     | VRFs are no longer a boundary of IP uniqueness        |
-| `/virtualization/clusters/`          | `site`               | `Site` and `Region` models are replaced by `Location` |
-| `/tenancy/tenants/`                  | `slug`               | `slug` field no longer supported                      |
-| `/tenancy/tenant-groups/`            | `slug`               | `slug` field no longer supported                      |
-| `/virtualization/cluster-groups/`    | `slug`               | `slug` field no longer supported                      |
-| `/virtualization/cluster-types/`     | `slug`               | `slug` field no longer supported                      |
+Most removed database fields in Nautobot 2.0 fall into the following general categories:
+
+1. Removal of references to removed models such as `Site` and `Region`
+2. Removal of `slug` fields in preference to the use of autogenerated natural-key slugs.
+
+??? info "Full table of removed API fields"
+    {data-table installation/tables/v2-api-removed-fields.yaml}
 
 ### Removed 1.X Version Endpoints and Serializer Representations
 
@@ -377,504 +148,97 @@ These endpoints `/ipam/roles/`, `/dcim/rack-roles/` and `/dcim/device-roles/` ar
 | `/dcim/rack-roles/`   | `/extras/roles/` |
 | `/ipam/roles/`        | `/extras/roles/` |
 
+### API Query Parameters Changes
+
+Nautobot 2.0 removes the `?brief` query parameter and adds support for the `?depth` query parameter. As a result, the ability to specify `brief_mode` in `DynamicModelChoiceField`, `DynamicModelMultipleChoiceField`, and `MultiMatchModelMultipleChoiceField` has also been removed. For every occurrence of the aforementioned fields where you have `brief_mode` set to `True/False` (e.g. `brief_mode=True`), please remove the statement, leaving other occurrences of the fields where you do not have `brief_mode` specified as they are.
+Please see the [documentation on the `?depth` query parameter](../rest-api/overview.md/#depth-query-parameter) for more information.
+
 ## UI, GraphQL, and REST API Filter Changes
 
+### Removed Changelog URL from View Context
+
+`changelog_url` is no longer provided in the `ObjectView` context. To get a model instance's changelog URL, you can retrieve it from the instance itself if it supports it: `model_instance.get_changelog_url()`.
+
 ### Renamed Filter Fields
 
-| Model                   | Renamed Filter Field      | New Name                         | UI and Rest API endpoints Available in v2.X                               |
-|-------------------------|---------------------------|----------------------------------|---------------------------------------------------------------------------|
-| Cable                   | `tag`                     | `tags`                           | `/dcim/cables/?tags=<uuid/slug>`                                          |
-| Circuit                 | `tag`                     | `tags`                           | `/circuits/circuits/?tags=<uuid/slug>`                                    |
-|                         | `type`                    | `circuit_type`                   | `/circuits/circuits/?circuit_type=<uuid/slug>`                            |
-| Cluster                 | `tag`                     | `tags`                           | `/virtualization/clusters/?tags=<uuid/slug>`                              |
-| ConsolePort             | `cabled`                  | `has_cable`                      | `/dcim/console-ports/?has_cable=True/False`                               |
-| ConsoleServerPort       | `cabled`                  | `has_cable`                      | `/dcim/console-server-ports/?has_cable=True/False`                        |
-| CustomFieldChoice       | `field`                   | `custom_field`                   | `/extras/custom-field-choices/?custom_field=<uuid/key>`                   |
-| Device                  | `cluster_id`              | `cluster`                        | `/dcim/devices/?cluster=<uuid/slug>`                                      |
-|                         | `device_type_id`          | `device_type`                    | `/dcim/devices/?device_type=<uuid/slug>`                                  |
-|                         | `local_context_data`      | `local_config_context_data`      | `/dcim/devices/?local_config_context_data=True/False`                     |
-|                         | `local_context_schema_id` | `local_config_context_schema_id` | `/dcim/devices/?local_config_context_schema_id=<uuid>`                    |
-|                         | `local_context_schema`    | `local_config_context_schema`    | `/dcim/devices/?local_config_context_schema=<slug>`                       |
-|                         | `rack_group_id`           | `rack_group`                     | `/dcim/devices/?rack_group=<uuid/slug>`                                   |
-|                         | `rack_id`                 | `rack`                           | `/dcim/devices/?rack=<uuid/slug>`                                         |
-|                         | `tag`                     | `tags`                           | `/dcim/devices/?tags=<uuid/slug>`                                         |
-|                         | `virtual_chassis_id`      | `virtual_chassis`                | `/dcim/devices/?virtual_chassis=<uuid/slug>`                              |
-| DeviceBay               | `tag`                     | `tags`                           | `/dcim/device-bays/?tags=<uuid/slug>`                                     |
-| DeviceRedundancyGroup   | `tag`                     | `tags`                           | `/dcim/device-redundancy-groups/?tag=<uuid/slug>`                         |
-| DeviceType              | `has_instances`           | `has_devices`                    | `/dcim/device-types/?has_devices=True/False`                              |
-|                         | `instances`               | `devices`                        | `/dcim/device-types/?devices=<uuid>`                                      |
-|                         | `tag`                     | `tags`                           | `/dcim/device-types/?tags=<uuid/slug>`                                    |
-| FrontPort               | `cabled`                  | `has_cable`                      | `/dcim/front-ports/?has_cable=True/False`                                 |
-|                         | `tag`                     | `tags`                           | `/dcim/front-ports/?tags=<uuid/slug>`                                     |
-| GitRepository           | `tag`                     | `tags`                           | `/extras/git-repositories/?tags=<uuid/slug>`                              |
-| Interface               | `cabled`                  | `has_cable`                      | `/dcim/interfaces/?has_cable=True/False`                                  |
-| InventoryItem           | `child_items`             | `children`                       | `/dcim/inventory-items/?children=<uuid/name>`                             |
-|                         | `has_child_items`         | `has_children`                   | `/dcim/inventory-items/?has_children=True/False`                          |
-|                         | `tag`                     | `tags`                           | `/dcim/inventory-items/?tags=<uuid/slug>`                                 |
-| IPAddress               | `family`                  | `ip_version`                     | `/ipam/ip-addresses/?ip_version=<4/6>`                                    |
-|                         | `tag`                     | `tags`                           | `/ipam/ip-addresses/?tags=<uuid/slug>`                                    |
-| Job                     | `tag`                     | `tags`                           | `/extras/jobs/?tags=<uuid/slug>`                                          |
-| Location                | `tag`                     | `tags`                           | `/dcim/locations/?tags=uuid/slug>`                                        |
-| ObjectPermission        | `group`                   | `groups`                         | `/users/permissions/?groups=<slug>`                                       |
-|                         | `group_id`                | `groups_id`                      | `/users/permissions/?groups_id=<id>`                                      |
-|                         | `user`                    | `users`                          | `/users/permissions/?users=<uuid/username>`                               |
-| PowerFeed               | `cabled`                  | `has_cable`                      | `/dcim/power-feeds/?has_cable=True/False`                                 |
-|                         | `tag`                     | `tags`                           | `/dcim/power-feeds/?tags=<uuid/slug>`                                     |
-| PowerOutlet             | `cabled`                  | `has_cable`                      | `/dcim/power-outlets/?has_cable=True/False`                               |
-| PowerPanel              | `tag`                     | `tags`                           | `/dcim/power-panels/?tags=<uuid/slug>`                                    |
-| PowerPort               | `cabled`                  | `has_cable`                      | `/dcim/power-ports/?has_cable=True/False`                                 |
-| Prefix                  | `family`                  | `ip_version`                     | `/ipam/prefixes/?ip_version=<4/6>`                                        |
-|                         | `is_pool`                 | `type`                           | `/ipam/prefixes/?type=<container/network/pool>`                           |
-|                         | `tag`                     | `tags`                           | `/ipam/prefixes/?tags=<uuid/slug>`                                        |
-| Provider                | `tag`                     | `tags`                           | `/circuits/provider/?tags=<uuid/slug>`                                    |
-| ProviderNetwork         | `tag`                     | `tags`                           | `/circuits/provider-networks/?tags=<uuid/slug>`                           |
-| Rack                    | `group`                   | `rack_group`                     | `/dcim/racks/?rack_group=<uuid/slug>`                                     |
-|                         | `has_reservations`        | `has_rack_reservations`          | `/dcim/racks/?has_rack_reservations=True/False`                           |
-|                         | `reservations`            | `rack_reservations`              | `/dcim/racks/?rack_reservations=<uuid>`                                   |
-|                         | `tag`                     | `tags`                           | `/dcim/racks/?tags=<uuid/slug>`                                           |
-| RackReservation         | `group`                   | `rack_group`                     | `/dcim/rack-reservations/?rack_group=<uuid/slug>`                         |
-|                         | `tag`                     | `tags`                           | `/dcim/rack-reservations/?tags=<uuid/slug>`                               |
-| RearPort                | `cabled`                  | `has_cable`                      | `/dcim/rear-ports/?has_cable=True/False`                                  |
-|                         | `tag`                     | `tags`                           | `/dcim/rear-ports/?tags=<uuid/slug>`                                      |
-| RouteTarget             | `tag`                     | `tags`                           | `/ipam/route-targets/?tags=<uuid/slug>`                                   |
-| SecretsGroupAssociation | `group`                   | `secrets_group`                  | `/extras/secrets-groups-associations/?secrets_group=<uuid/slug>`          |
-| Service                 | `tag`                     | `tags`                           | `/ipam/services/?tags=<uuid/slug>`                                        |
-| Site                    | `tag`                     | `tags`                           | `/dcim/sites/?tags=<uuid/slug>`                                           |
-| Tenant                  | `tag`                     | `tags`                           | `/tenancy/tenants/?tags=<uuid/slug>`                                      |
-| User                    | `changes`                 | `object_changes`                 | `/users/users/?object_changes=<id>`                                       |
-|                         | `has_changes`             | `has_object_changes`             | `/users/users/?has_object_changes=True/False`                             |
-|                         | `group`                   | `groups`                         | `/users/users/?groups=<slug>`                                             |
-|                         | `group_id`                | `groups_id`                      | `/users/users/?groups_id=<id>`                                            |
-| VirtualMachine          | `local_context_data`      | `local_config_context_data`      | `/virtualization/virtual-machines/?local_config_context_data=True/False`  |
-|                         | `local_context_schema_id` | `local_config_context_schema_id` | `/virtualization/virtual-machines/?local_config_context_schema_id=<uuid>` |
-|                         | `local_context_schema`    | `local_config_context_schema`    | `/virtualization/virtual-machines/?local_config_context_schema=<slug>`    |
-|                         | `tag`                     | `tags`                           | `/virtualization/virtual-machines/?tags=<uuid/slug>`                      |
-| VLAN                    | `tag`                     | `tags`                           | `/ipam/vlans/?tags=<uuid/slug>`                                           |
-| VMInterface             | `tag`                     | `tags`                           | `/virtualization/interfaces/?tags=<uuid/slug>`                            |
-| VRF                     | `tag`                     | `tags`                           | `/ipam/vrfs/?tags=<uuid/slug>`                                            |
+Most renamed filter fields in Nautobot 2.0 fall into the following general categories:
+
+1. The `tag` filter is renamed to `tags` on all models supporting Tags.
+2. Renames to match renamed model/serializer fields as described earlier in this document.
+3. Related membership filters are renamed to `has_<related>` throughout, for example `ConsolePort.cabled` is renamed to `ConsolePort.has_cable`.
+4. Most `<related>_id` filters have been merged into the corresponding `<related>` filter (see ["Enhanced Filter Fields"](#enhanced-filter-fields) below).
+
+??? info "Full table of renamed filter fields"
+    {data-table installation/tables/v2-filters-renamed-fields.yaml}
 
 ### Enhanced Filter Fields
 
-Below is a table documenting [enhanced filter field changes](../release-notes/version-2.0.md#enhanced-filter-fields-2804) in v2.x.
-
-| Model                   | Enhanced Filter Field     | Changes                                                    | UI and Rest API endpoints Available in v2.X                    |
-|-------------------------|---------------------------|------------------------------------------------------------|----------------------------------------------------------------|
-| (all)                   | `created[__(gte/lte)]`    | Now can filter on multiple values; now supports date-times | `?created__gte=2023-02-14%2012:00:00`                          |
-| Cable                   | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/cabels/?tenant=<uuid/name>`                             |
-| Circuit                 | `circuit_type`            | Enhanced to support primary key UUIDs in addition to names | `/circuits/circuits/?circuit_type=<uuid/name>`                 |
-|                         | `provider`                | Enhanced to support primary key UUIDs in addition to names | `/circuits/circuits/?provider=<uuid/name>`                     |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/circuits/circuits/?tenant=<uuid/name>`                       |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/circuits/circuits/?tenant_group=<uuid/name>`                 |
-| Cluster                 | `cluster_group`           | Enhanced to support primary key UUIDs in addition to names | `/virtualization/clusters/?cluster_group=<uuid/name>`          |
-|                         | `cluster_type`            | Enhanced to support primary key UUIDs in addition to names | `/virtualization/clusters/?cluster_type=<uuid/name>`           |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/virtualization/clusters/?tenant=<uuid/name>`                 |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/virtualization/clusters/?tenant_group=<uuid/name>`           |
-| ConfigContext           | `cluster_group`           | Enhanced to support primary key UUIDs in addition to names | `/extras/config-contexts/?cluster_group=<uuid/name>`           |
-|                         | `device_redundancy_group` | Enhanced to support primary key UUIDs in addition to names | `/extras/config-contexts/?device_redundancy_group=<uuid/name>` |
-|                         | `platform`                | Enhanced to support primary key UUIDs in addition to names | `/extras/config-contexts/?platform=<uuid/name>`                |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/extras/config-contexts/?tenant=<uuid/name>`                  |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/extras/config-contexts/?tenant_group=<uuid/name>`            |
-|                         | `dynamic_groups`          | Enhanced to support primary key UUIDs in addition to names | `/extras/config-contexts/?dynamic_groups=<uuid/name>`          |
-| ConsolePort             | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/console-ports/?device=<uuid/name>`                      |
-| ConsoleServerPort       | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/console-server-ports/?device=<uuid/name>`               |
-| Device                  | `cluster_id`              | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/devices/?cluster=<uuid/slug>`                           |
-|                         | `device_type_id`          | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/devices/?device_type=<uuid/slug>`                       |
-|                         | `device_redundancy_group` | Enhanced to support primary key UUIDs in addition to names | `/dcim/devices/?device_redundancy_group=<uuid/name>`           |
-|                         | `manufacturer`            | Enhanced to support primary key UUIDs in addition to names | `/dcim/devices/?manufacturer=<uuid/name>`                      |
-|                         | `platform`                | Enhanced to support primary key UUIDs in addition to names | `/dcim/devices/?platform=<uuid/name>`                          |
-|                         | `role`                    | Enhanced to support primary key UUIDs in addition to names | `/dcim/devices/?role=<uuid/name>`                              |
-|                         | `rack_id`                 | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/devices/?rack=<uuid/slug>`                              |
-|                         | `rack_group_id`           | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/devices/?rack_group=<uuid/slug>`                        |
-|                         | `serial`                  | Enhanced to permit filtering on multiple values            | `/dcim/devices/?serial=<value>&serial=<value>...`              |
-|                         | `secrets_group`           | Enhanced to support primary key UUIDs in addition to names | `/dcim/devices/?secrets_group=<uuid/name>`                     |
-|                         | `virtual_chassis_id`      | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/devices/?virtual_chassis=<uuid/slug>`                   |
-| DeviceBay               | `cable`                   | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/regions/?parent=<uuid/slug>`                            |
-|                         | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/device-bays/?device=<uuid/name>`                        |
-| DeviceType              | `manufacturer`            | Enhanced to support primary key UUIDs in addition to names | `/dcim/device-types/?manufacturer=<uuid/name>`                 |
-| DeviceRedundancyGroup   | `secrets_group`           | Enhanced to support primary key UUIDs in addition to names | `/dcim/device-redundancy-groups/?secrets_group=<uuid/name>`    |
-| DynamicGroupMembership  | `group`                   | Enhanced to support primary key UUIDs in addition to names | `/extras/dynamic-froup-membership/?group=<uuid/name>`          |
-|                         | `parent_group`            | Enhanced to support primary key UUIDs in addition to names | `/extras/dynamic-froup-membership/?parent_group=<uuid/name>`   |
-| FrontPort               | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/front-ports/?device=<uuid/name>`                        |
-| GitRepository           | `secrets_group`           | Enhanced to support primary key UUIDs in addition to names | `/extras/git-repository/?secrets_group=<uuid/name>`            |
-| Interface               | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/interfaces/?device=<uuid/name>`                         |
-| IPAddress               | `rir`                     | Enhanced to support primary key UUIDs in addition to names | `/ipam/ip-addresses/?rir=<uuid/name>`                          |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/ipam/ip-addresses/?tenant=<uuid/name>`                       |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/ipam/ip-addresses/?tenant_group=<uuid/name>`                 |
-| InventoryItem           | `device`                  | Enhanced to support primary key UUIDs in addition to name  | `/dcim/inventory-items/?device=<uuid/name>`                    |
-|                         | `manufacturer`            | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/inventory-items/?manufacturer=<uuid/slug>`              |
-|                         | `serial`                  | Enhanced to permit filtering on multiple values            | `/dcim/inventory-items/?serial=<value>&serial=<value>...`      |
-| Manufacturer            | `platforms`               | Enhanced to support primary key UUIDs in addition to names | `/dcim/manufacturers/?platforms=<uuid/name>`                   |
-| Platform                | `manufacturer`            | Enhanced to support primary key UUIDs in addition to names | `/dcim/platforms/?manufacturer=<uuid/name>`                    |
-| PowerOutlet             | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/power-outlets/?device=<uuid/name>`                      |
-| PowerPort               | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/power-ports/?device=<uuid/name>`                        |
-| Prefix                  | `rir`                     | Enhanced to support primary key UUIDs in addition to names | `/ipam/prefixes/?rir=<uuid/name>`                              |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/ipam/prefixes/?tenant=<uuid/name>`                           |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/ipam/prefixes/?tenant_group=<uuid/name>`                     |
-| ProviderNetwork         | `provider`                | Enhanced to support primary key UUIDs in addition to names | `/circuits/provider-networks/?provider=<uuid/name>`            |
-| Rack                    | `role`                    | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/racks/?role=<uuid/slug>`                                |
-|                         | `serial`                  | Enhanced to permit filtering on multiple values            | `/dcim/racks/?serial=<value>&serial=<value>...`                |
-| RackGroup               | `parent`                  | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/rack-groups/?parent=<uuid/slug>`                        |
-| RackReservation         | `user`                    | Enhanced to support primary key UUIDs in addition to slugs | `/dcim/rack-reservations/?user=<uuid/slug>`                    |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/rack-reservations/?tenant=<uuid/name>`                  |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/dcim/rack-reservations/?tenant_group=<uuid/name>`            |
-| RearPort                | `device`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/rear-ports/?device=<uuid/name>`                         |
-| Region                  | `parent`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/regions/?parent=<uuid/slug>`                            |
-| RouteTarget             | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/ipam/route-targets/?tenant=<uuid/name>`                      |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/ipam/route-targets/?tenant_group=<uuid/name>`                |
-| SecretsGroupAssociation | `secrets`                 | Enhanced to support primary key UUIDs in addition to names | `/extras/secrets-group-association/?secrets=<uuid/name>`       |
-|                         | `secrets_group`           | Enhanced to support primary key UUIDs in addition to names | `/extras/secrets-group-association/?secrets_group=<uuid/name>` |
-| Tenant                  | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/tenancy/tenants/?tenant_group=<uuid/name>`                   |
-| TenantGroup             | `parent`                  | Enhanced to support primary key UUIDs in addition to names | `/tenancy/tenant-groups/?parent=<uuid/name>`                   |
-|                         | `children`                | Enhanced to support primary key UUIDs in addition to names | `/tenancy/tenant-groups/?children=<uuid/name>`                 |
-|                         | `tenants`                 | Enhanced to support primary key UUIDs in addition to names | `/tenancy/tenant-groups/?tenants=<uuid/name>`                  |
-| VirtualChassis          | `master`                  | Enhanced to support primary key UUIDs in addition to name  | `/dcim/virtual-chassis/?master=<uuid/name>`                    |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/dcim/virtual-chassis/?tenant=<uuid/name>`                    |
-| VirtualMachine          | `cluster_group`           | Enhanced to support primary key UUIDs in addition to names | `/virtualization/virtual-machines/?cluster_group=<uuid/name>`  |
-|                         | `cluster_type`            | Enhanced to support primary key UUIDs in addition to names | `/virtualization/virtual-machines/?cluster_type=<uuid/name>`   |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/virtualization/virtual-machines/?tenant=<uuid/name>`         |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/virtualization/virtual-machines/?tenant_group=<uuid/name>`   |
-|                         | `platform`                | Enhanced to support primary key UUIDs in addition to names | `/virtualization/virtual-machines/?platform=<uuid/name>`       |
-| VRF                     | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/ipam/vrfs/?tenant=<uuid/name>`                               |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/ipam/vrfs/?tenant_group=<uuid/name>`                         |
-| VLAN                    | `available_on_device`     | Enhanced to permit filtering on multiple values            | `/ipam/vlans/?available_on_device=<uuid>&...`                  |
-|                         | `vlan_group`              | Enhanced to support primary key UUIDs in addition to slugs | `/ipam/vlans/?vlan_group=<uuid/slug>`                          |
-|                         | `tenant`                  | Enhanced to support primary key UUIDs in addition to names | `/ipam/vlans/?tenant=<uuid/name>`                              |
-|                         | `tenant_group`            | Enhanced to support primary key UUIDs in addition to names | `/ipam/vlans/?tenant_group=<uuid/name>`                        |
+Below is a table documenting [enhanced filter field changes](../release-notes/version-2.0.md#enhanced-filter-fields-2804) in Nautobot 2.0. These enhancements mostly fall into the following general categories:
+
+1. Many filters are enhanced to permit filtering by UUID _or_ by name.
+2. Filters that previously only supported a single filter value can now filter on multiple values.
+
+??? info "Full table of enhanced filter fields"
+    {data-table installation/tables/v2-filters-enhanced-fields.yaml}
 
 ### Corrected Filter Fields
 
-Below is a table documenting [corrected filter field changes](../release-notes/version-2.0.md#corrected-filter-fields-2804) in v2.x.
+Below is a table documenting [corrected filter field changes](../release-notes/version-2.0.md#corrected-filter-fields-2804) in Nautobot 2.0. These corrections mostly involve filters that previously permitted filtering on related membership only (`/api/dcim/devices/?console_ports=True`) and have now been corrected into filters for related membership (`/api/dcim/devices/?has_console_ports=True`) as well as by actual related objects (`/api/dcim/devices/?console_ports=<UUID>`).
 
-| Model             | Changed Filter Field   | Before                                                   | After                                                                                    |
-|-------------------|------------------------|----------------------------------------------------------|------------------------------------------------------------------------------------------|
-| CustomFieldChoice | `custom_field`         | `/extras/custom-field-choices/?custom_field=<uuid/name>` | `/extras/custom-field-choices/?custom_field=<uuid/key>`                                  |
-| Device            | `console_ports`        | `/dcim/devices/?console_ports=True`                      | `/dcim/devices/?console_ports=<uuid>` or `?has_console_ports=<True/False>`               |
-|                   | `console_server_ports` | `/dcim/devices/?console_server_ports=True`               | `/dcim/devices/?console_server_ports=<uuid>` or `?has_console_server_ports=<True/False>` |
-|                   | `device_bays`          | `/dcim/devices/?device_bays=True`                        | `/dcim/devices/?device_bays=<uuid>` or `?has_device_bays=<True/False>`                   |
-|                   | `front_ports`          | `/dcim/devices/?front_ports=True`                        | `/dcim/devices/?front_ports=<uuid>` or `?has_front_ports=<True/False>`                   |
-|                   | `interfaces`           | `/dcim/devices/?interfaces=True`                         | `/dcim/devices/?interfaces=<uuid>` or `?has_interfaces=<True/False>`                     |
-|                   | `power_ports`          | `/dcim/devices/?power_ports=True`                        | `/dcim/devices/?power_ports=<uuid>` or `?has_power_ports=<True/False>`                   |
-|                   | `power_outlets`        | `/dcim/devices/?power_outlets=True`                      | `/dcim/devices/?power_outlets=<uuid>` or `?has_power_outlets=<True/False>`               |
-|                   | `rear_ports`           | `/dcim/devices/?rear_ports=True`                         | `/dcim/devices/?rear_ports=<uuid>` or `?has_rear_ports=<True/False>`                     |
+??? info "Full table of corrected filter fields"
+    {data-table installation/tables/v2-filters-corrected-fields.yaml}
 
 ### Removed Filter Fields
 
 Below is a table documenting [removed filter field changes](../release-notes/version-2.0.md#removed-filter-fields-2804) in v2.x.
-Unless stated otherwise, all of the `*_id=<uuid>` filters have been replaced by generic filters that support both uuid and slug.
-For example `/circuits/circuits/?provider_id=<uuid>` has been replaced by `/circuits/circuits/?provider=<uuid>`.
-
-In addition, `region_id`/`region` and `site_id`/`site` are all being removed because `Region` and `Site` Models are being collapsed into `Location` Model.
-Their filters are also being replaced by `?location=<uuid/slug>`. For example `/dcim/devices/?site=ams-01` is replaced by `/dcim/devices/?location=ams-01`.
-
-| Model                   | Removed Filter Field  | UI and API endpoints that are no longer supported in v2.X                                     |
-|-------------------------|-----------------------|-----------------------------------------------------------------------------------------------|
-| Aggregate               | `tenant_group_id`     |                                                                                               |
-| Circuit                 | `provider_id`         |                                                                                               |
-|                         | `provider_network_id` |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-|                         | `type_id`             | instead of `/circuits/circuits/?type_id=<uuid>`, use `circuit_type=<uuid>`                    |
-| CircuitTermination      | `circuit_id`          |                                                                                               |
-|                         | `provider_network_id` |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| CircuitType             | `slug`                |                                                                                               |
-| Cluster                 | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-| ClusterGroup            | `slug`                |                                                                                               |
-| ClusterType             | `slug`                |                                                                                               |
-| ConfigContext           | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `role_id`             |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| ConsolePort             | `device_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| ConsoleServerPort       | `device_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| CustomFieldChoice       | `field_id`            | instead of `/extras/custom-field-choices/?field_id=<uuid>`, use `custom_field=<uuid>`         |
-| CustomLink              | `slug`                |                                                                                               |
-| Device                  | `manufacturer_id`     |                                                                                               |
-|                         | `model`               | instead of `/dcim/devices/?model=<uuid>`, use `device_type=<uuid>`                            |
-|                         | `pass_through_ports`  | instead of `/dcim/devices/?pass_through_ports=<bool>`, use `has_front_ports`/`has_rear_ports` |
-|                         | `platform_id`         |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `role_id`             |                                                                                               |
-|                         | `secrets_group_id`    |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-| DeviceBay               | `device_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| DeviceType              | `manufacturer_id`     |                                                                                               |
-| DeviceRedundancyGroup   | `slug`                |                                                                                               |
-| DynamicGroup            | `slug`                |                                                                                               |
-| FrontPort               | `device_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| GraphQLQuery            | `slug`                |                                                                                               |
-| Interface               | `bridge_id`           |                                                                                               |
-|                         | `device_id`           |                                                                                               |
-|                         | `lag_id`              |                                                                                               |
-|                         | `parent_interface_id` |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| InventoryItem           | `device_id`           |                                                                                               |
-|                         | `manufacturer_id`     |                                                                                               |
-|                         | `parent_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| IPAddress               | `tenant_group_id`     |                                                                                               |
-| JobHook                 | `slug`                |                                                                                               |
-| Location                | `tenant_group_id`     |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| Manufacturer            | `slug`                |                                                                                               |
-| ObjectPermission        | `user_id`             | instead of `/users/permissions/?user_id=<uuid>`, use `users=<uuid>`                           |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| Platform                | `slug`                |                                                                                               |
-| Provider                | `region`              |                                                                                               |
-|                         | `slug`                |                                                                                               |
-| ProviderNetwork         | `provider_id`         |                                                                                               |
-| Platform                | `manufacturer_id`     |                                                                                               |
-| PowerOutlet             | `device_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| PowerFeed               | `power_panel_id`      |                                                                                               |
-|                         | `rack_id`             |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| PowerPanel              | `rack_group_id`       |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| PowerPort               | `device_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| Prefix                  | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-| Rack                    | `group_id`            |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `role_id`             |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-| RackGroup               | `parent_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| RackReservation         | `group_id`            |                                                                                               |
-|                         | `rack_id`             |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-|                         | `user_id`             |                                                                                               |
-| RearPort                | `device_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| Region                  | `parent_id`           |                                                                                               |
-| RelationshipAssociation | `slug`                |                                                                                               |
-| RIR                     | `slug`                |                                                                                               |
-| RouteTarget             | `slug`                |                                                                                               |
-| RouteTarget             | `tenant_group_id`     |                                                                                               |
-| Role                    | `slug`                |                                                                                               |
-| Secret                  | `slug`                |                                                                                               |
-| SecretsGroup            | `slug`                |                                                                                               |
-| SecretsGroupAssociation | `group_id`            | instead of `/extras/secrets-groups-associations/?group_id=<uuid>`, use `secrets_group=<uuid>` |
-|                         | `slug`                |                                                                                               |
-| Status                  | `slug`                |                                                                                               |
-| Site                    | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-| Tenant                  | `aggregates`          |                                                                                               |
-|                         | `group_id`            |                                                                                               |
-|                         | `has_aggregates`      |                                                                                               |
-|                         | `has_sites`           |                                                                                               |
-|                         | `sites`               |                                                                                               |
-|                         | `slug`                |                                                                                               |
-| TenantGroup             | `parent_id`           |                                                                                               |
-|                         | `slug`                |                                                                                               |
-| VirtualChassis          | `master_id`           |                                                                                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_id`           |                                                                                               |
-| VirtualMachine          | `tenant_group_id`     |                                                                                               |
-| VLANGroup               | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-| VLAN                    | `group_id`            |                                                                                               |
-|                         | `group`               | instead of `/ipam/vlans/?group=<slug>`, use `vlan_group=<slug>`                               |
-|                         | `region`              |                                                                                               |
-|                         | `region_id`           |                                                                                               |
-|                         | `site`                |                                                                                               |
-|                         | `site_id`             |                                                                                               |
-|                         | `tenant_group_id`     |                                                                                               |
-| VMInterface             | `bridge_id`           |                                                                                               |
-|                         | `parent_interface_id` |                                                                                               |
-| VRF                     | `tenant_group_id`     |                                                                                               |
-| Webhook                 | `slug`                |                                                                                               |
+Most removed database fields in Nautobot 2.0 fall into the following general categories:
+
+1. Removal of `*_id=<uuid>` filters as they have have been merged into filters that support both uuid and name/slug (for example, instead of `/api/circuits/circuits/?provider_id=<UUID>`, use `/api/circuits/circuits/?provider=<uuid>`).
+2. Removal of filtering on removed models such as `Region` and `Site`. (Use `location` filters instead.)
+3. Removal of `slug` filters from models that no longer have a `slug` field.
+
+??? info "Full table of removed filter fields"
+    {data-table installation/tables/v2-filters-removed-fields.yaml}
 
 ## Python Code Location Changes
 
-The below is mostly relevant only to authors of Jobs and Nautobot Apps. End users should not be impacted by the changes in this section.
-
-| Old Module                           | Class/Function(s)                                           | New Module                             |
-|--------------------------------------|-------------------------------------------------------------|----------------------------------------|
-| `nautobot.core.api.utils`            | `TreeModelSerializerMixin`                                  | `nautobot.core.api.serializers`        |
-| `nautobot.core.fields`               | `*`                                                         | `nautobot.core.models.fields`          |
-| `nautobot.core.forms`                | `SearchForm`                                                | `nautobot.core.forms.search`           |
-| `nautobot.core.utilities`            | `*`                                                         | `nautobot.core.views.utils`            |
-| `nautobot.dcim.fields`               | `MACAddressCharField`                                       | `nautobot.core.models.fields`          |
-| `nautobot.dcim.forms`                | `MACAddressField`                                           | `nautobot.core.forms`                  |
-| `nautobot.utilities.api`             | `*`                                                         | `nautobot.core.api.utils`              |
-| `nautobot.utilities.apps`            | `*`                                                         | `nautobot.core.apps`                   |
-| `nautobot.utilities.checks`          | `*`                                                         | `nautobot.core.checks`                 |
-| `nautobot.utilities.choices`         | `*`                                                         | `nautobot.core.choices`                |
-| `nautobot.utilities.config`          | `*`                                                         | `nautobot.core.utils.config`           |
-| `nautobot.utilities.constants`       | `*`                                                         | `nautobot.core.constants`              |
-| `nautobot.utilities.deprecation`     | `*`                                                         | `nautobot.core.utils.deprecation`      |
-| `nautobot.utilities.error_handlers`  | `*`                                                         | `nautobot.core.views.utils`            |
-| `nautobot.utilities.exceptions`      | `*`                                                         | `nautobot.core.exceptions`             |
-| `nautobot.utilities.factory`         | `*`                                                         | `nautobot.core.factory`                |
-| `nautobot.utilities.fields`          | `*`                                                         | `nautobot.core.models.fields`          |
-| `nautobot.utilities.filters`         | `*`                                                         | `nautobot.core.filters`                |
-| `nautobot.utilities.forms`           | `*`                                                         | `nautobot.core.forms`                  |
-| `nautobot.utilities.git`             | `*`                                                         | `nautobot.core.utils.git`              |
-| `nautobot.utilities.logging`         | `*`                                                         | `nautobot.core.utils.logging`          |
-| `nautobot.utilities.management`      | `*`                                                         | `nautobot.core.management`             |
-| `nautobot.utilities.ordering`        | `*`                                                         | `nautobot.core.utils.ordering`         |
-| `nautobot.utilities.paginator`       | `*`                                                         | `nautobot.core.views.paginator`        |
-| `nautobot.utilities.permissions`     | `*`                                                         | `nautobot.core.utils.permissions`      |
-| `nautobot.utilities.query_functions` | `*`                                                         | `nautobot.core.models.query_functions` |
-| `nautobot.utilities.querysets`       | `*`                                                         | `nautobot.core.models.querysets`       |
-| `nautobot.utilities.tables`          | `*`                                                         | `nautobot.core.tables`                 |
-| `nautobot.utilities.tasks`           | `*`                                                         | `nautobot.core.tasks`                  |
-| `nautobot.utilities.templatetags`    | `*`                                                         | `nautobot.core.templatetags`           |
-| `nautobot.utilities.testing`         | `*`                                                         | `nautobot.core.testing`                |
-| `nautobot.utilities.tree_queries`    | `*`                                                         | `nautobot.core.models.tree_queries`    |
-| `nautobot.utilities.utils`           | `array_to_string`                                           | `nautobot.core.models.utils`           |
-|                                      | `convert_querydict_to_factory_formset_acceptable_querydict` | `nautobot.core.utils.requests`         |
-|                                      | `copy_safe_request`                                         | `nautobot.core.utils.requests`         |
-|                                      | `count_related`                                             | `nautobot.core.models.querysets`       |
-|                                      | `csv_format`                                                | `nautobot.core.views.utils`            |
-|                                      | `deepmerge`                                                 | `nautobot.core.utils.data`             |
-|                                      | `dict_to_filter_params`                                     | `nautobot.core.api.utils`              |
-|                                      | `dynamic_import`                                            | `nautobot.core.api.utils`              |
-|                                      | `ensure_content_type_and_field_name_inquery_params`         | `nautobot.core.utils.requests`         |
-|                                      | `flatten_dict`                                              | `nautobot.core.utils.data`             |
-|                                      | `flatten_iterable`                                          | `nautobot.core.utils.data`             |
-|                                      | `foreground_color`                                          | `nautobot.core.utils.color`            |
-|                                      | `get_all_lookup_expr_for_field`                             | `nautobot.core.utils.filtering`        |
-|                                      | `get_api_version_serializer`                                | `nautobot.core.api.utils`              |
-|                                      | `get_changes_for_model`                                     | `nautobot.core.utils.lookup`           |
-|                                      | `get_filterset_field`                                       | `nautobot.core.utils.filtering`        |
-|                                      | `get_filterset_for_model`                                   | `nautobot.core.utils.lookup`           |
-|                                      | `get_filterable_params_from_filter_params`                  | `nautobot.core.utils.requests`         |
-|                                      | `get_form_for_model`                                        | `nautobot.core.utils.lookup`           |
-|                                      | `get_model_from_name`                                       | `nautobot.core.utils.lookup`           |
-|                                      | `get_related_class_for_model`                               | `nautobot.core.utils.lookup`           |
-|                                      | `get_route_for_model`                                       | `nautobot.core.utils.lookup`           |
-|                                      | `get_table_for_model`                                       | `nautobot.core.utils.lookup`           |
-|                                      | `hex_to_rgb`                                                | `nautobot.core.utils.color`            |
-|                                      | `is_taggable`                                               | `nautobot.core.models.utils`           |
-|                                      | `is_uuid`                                                   | `nautobot.core.utils.data`             |
-|                                      | `lighten_color`                                             | `nautobot.core.utils.color`            |
-|                                      | `normalize_querydict`                                       | `nautobot.core.utils.requests`         |
-|                                      | `prepare_cloned_fields`                                     | `nautobot.core.views.utils`            |
-|                                      | `pretty_print_query`                                        | `nautobot.core.models.utils`           |
-|                                      | `render_jinja2`                                             | `nautobot.core.utils.data`             |
-|                                      | `rgb_to_hex`                                                | `nautobot.core.utils.color`            |
-|                                      | `SerializerForAPIVersions`                                  | `nautobot.core.api.utils`              |
-|                                      | `serialize_object`                                          | `nautobot.core.models.utils`           |
-|                                      | `serialize_object_v2`                                       | `nautobot.core.models.utils`           |
-|                                      | `shallow_compare_dict`                                      | `nautobot.core.utils.data`             |
-|                                      | `slugify_dots_to_dashes`                                    | `nautobot.core.models.fields`          |
-|                                      | `slugify_dashes_to_underscores`                             | `nautobot.core.models.fields`          |
-|                                      | `to_meters`                                                 | `nautobot.core.utils.data`             |
-|                                      | `UtilizationData`                                           | `nautobot.core.utils.data`             |
-|                                      | `versioned_serializer_selector`                             | `nautobot.core.api.utils`              |
-| `nautobot.utilities.validators`      | `*`                                                         | `nautobot.core.models.validators`      |
-| `nautobot.utilities.views`           | `*`                                                         | `nautobot.core.views.mixins`           |
+The below is mostly relevant only to authors of Jobs and Nautobot Apps. End users should not be impacted by the changes in this section. Most changes in code location arise from the merging of the `nautobot.utilities` module into the `nautobot.core` module.
+
+??? info "Full table of code location changes"
+    {data-table installation/tables/v2-code-location-changes.yaml}
+
+## Removed Python Code
+
+- Because of the replacement of the `?brief` REST API query parameter with `?depth` and the removal of all `Nested*Serializers`, some of the classes and mixins are removed because they are no longer needed.
+- In the redesigned UI of Nautobot 2.0, menu items may no longer contain buttons, and so the `NavMenuButton` class and its subclasses have been removed as they are no longer needed/supported.
+- With the reimplementation of CSV import and export, `CSVForm` classes are generally no longer needed, and so a number of mixins have been removed.
+
+??? info "Full table of code removals"
+    {data-table installation/tables/v2-code-removals.yaml}
 
 ## Git Data Source Changes
 
 The Configuration Contexts Metadata key `schema` has been replaced with `config_context_schema`. This means that any `schema` references in your git repository's data must be updated to reflect this change.
 
+`GitRepository` sync operations are now Jobs. As a result, when creating a new `GitRepository` it **is not automatically synchronized**. A `GitRepository.sync()` method has been implemented that will execute the sync job on a worker and return the `JobResult` for the operation. This method takes `dry_run` and `user` arguments. The `dry_run` argument defaults to `False`; if set to `True` will cause the sync to dry-run. The `user` argument is required if a sync is performed.
+
+Additionally, the `GitRepository.save()` method no longer takes a `trigger_resync=<True|False>` argument as it is no longer required. The act of creating a new `GitRepository` no longer has side effects.
+
+Below is a table documenting changes in names for Git-related Jobs. There should NOT be a need to ever manually execute the jobs due to the addition of `GitRepository.sync()`, but this is being provided for clarity.
+
+| Old Job Location                                                       | New Job Location                         |
+|------------------------------------------------------------------------|------------------------------------------|
+| `nautobot.extras.datasources.git.pull_git_repository_and_refresh_data` | `nautobot.core.jobs.GitRepositorySync`   |
+| `nautobot.extras.datasources.git.git_repository_diff_origin_and_local` | `nautobot.core.jobs.GitRepositoryDryRun` |
+
 ## Logging Changes
 
-Where applicable, `logging.getLogger("module_name")` is replaced with `logging.getLogger(__name__)` or `logging.getLogger(__name__ + ".MyFeature")`.
+Where applicable, `logging.getLogger("some_arbitrary_name")` is replaced with `logging.getLogger(__name__)` or `logging.getLogger(__name__ + ".SpecificFeature")`.
 
 Below is a table documenting changes in logger names that could potentially affect existing deployments with expectations around specific logger names used for specific purposes.
 
-| Old Logger Name                          | New Logger Name                                       |
-|------------------------------------------|-------------------------------------------------------|
-| `nautobot.authentication`                | `nautobot.core.authentication`                        |
-| `nautobot.datasources.git`               | `nautobot.extras.datasources.git`                     |
-| `nautobot.datasources.utils`             | `nautobot.extras.datasources.utils`                   |
-| `nautobot.dcim.cable`                    | `nautobot.dcim.signals.cable`                         |
-| `nautobot.graphql.generators`            | `nautobot.core.graphql.generators`                    |
-| `nautobot.graphql.schema`                | `nautobot.core.graphql.schema`                        |
-| `nautobot.jobs`                          | `nautobot.extras.jobs`                                |
-| `nautobot.jobs.*`                        | `nautobot.extras.jobs.*`                              |
-| `nautobot.releases`                      | `nautobot.core.releases`                              |
-| `nautobot.releases`                      | `nautobot.utilities.tasks`                            |
-| `nautobot.plugins`                       | `nautobot.extras.templatetags.plugins`                |
-| `nautobot.plugins`                       | `nautobot.extras.plugins.utils`                       |
-| `nautobot.views.ObjectEditView`          | `nautobot.core.views.generic.ObjectEditView`          |
-| `nautobot.views.ObjectDeleteView`        | `nautobot.core.views.generic.ObjectDeleteView`        |
-| `nautobot.views.BulkCreateView`          | `nautobot.core.views.generic.BulkCreateView`          |
-| `nautobot.views.ObjectImportView`        | `nautobot.core.views.generic.ObjectImportView`        |
-| `nautobot.views.BulkImportView`          | `nautobot.core.views.generic.BulkImportView`          |
-| `nautobot.views.BulkEditView`            | `nautobot.core.views.generic.BulkEditView`            |
-| `nautobot.views.BulkRenameView`          | `nautobot.core.views.generic.BulkRenameView`          |
-| `nautobot.views.BulkDeleteView`          | `nautobot.core.views.generic.BulkDeleteView`          |
-| `nautobot.views.ComponentCreateView`     | `nautobot.core.views.generic.ComponentCreateView`     |
-| `nautobot.views.BulkComponentCreateView` | `nautobot.core.views.generic.BulkComponentCreateView` |
+??? info "Full table of logger name changes"
+    {data-table installation/tables/v2-logging-renamed-loggers.yaml}
 
 ## Job Database Model Changes
 
@@ -893,7 +257,66 @@ The Job `name` field has been changed to a unique field and the `name` + `groupi
 
     These jobs would be named `Sample job` and `Sample job (2)`
 
-The Job `slug` has been updated to be derived from the `name` field instead of a combination of `job_source`, `git_repository`, and `job_class`.
+The Job `slug`, `source` and `git_repository` fields have been removed. The Job `module_name` field will automatically be updated, for Jobs derived from a Git repository, from `<submodule_name>` to `<git_repository_slug>.jobs.<submodule_name>`. This also changes the secondary uniqueness constraint for Jobs to simply `[module_name, job_class_name]`.
+
+The Job `class_path` attribute has been simplified correspondingly, to simply `<module>.<ClassName>` instead of the former `<source>/<module>/<ClassName>`. For example, the Nautobot Golden Config backup job's `class_path` will change from `plugins/nautobot_golden_config.jobs/BackupJob` to `nautobot_golden_config.jobs.BackupJob`.
+
+The Job `commit_default` field has been renamed to `dryrun_default` and the default value has been changed from `True` to `False`. This change is a result of the fundamental job changes mentioned in the [Job Changes](#job-changes) section below.
+
+## JobResult Database Model Changes
+
+The `JobResult` objects for which results from Job executions are stored are now automatically managed. Therefore job authors must never manipulate or `save()` these objects as they are now used internally for all state transitions and saving the objects yourself could interfere with and cause Job execution to fail or cause data loss.
+
+Therefore all code that is calling `JobResult.set_status()` (which has been removed) or `JobResult.save()` must be removed.
+
+## Job Changes
+
+### Fundamental Changes
+
+The `BaseJob` class is now a subclass of Celery's `Task` class. Some fundamental changes to the job's methods and signatures were required to support this change:
+
+- The `test_*` and `post_run` methods for backwards compatibility to NetBox scripts and reports were removed. Celery implements `before_start`, `on_success`, `on_retry`, `on_failure`, and `after_return` methods that can be used by job authors to perform similar functions.
+
+!!! important
+    Be sure to call the `super()` method when overloading any of the job's `before_start`, `on_success`, `on_retry`, `on_failure`, or `after_return` methods
+
+- The run method signature is now customizable by the job author. This means that the `data` and `commit` arguments are no longer passed to the job by default and the job's run method signature should match the the job's input variables.
 
 !!! example
-    The Nautobot Golden Config backup job's slug will change from `plugins-nautobot_golden_config-jobs-backupjob` to `backup-configurations`.
+    ```py
+    class ExampleJob(Job):
+        var1 = StringVar()
+        var2 = IntegerVar(required=True)
+        var3 = BooleanVar()
+        var4 = ObjectVar(model=Role)
+
+        def run(self, var1, var2, var3, var4):
+            ...
+    ```
+
+### Database Transactions
+
+Nautobot no longer wraps the job `run` method in an atomic database transaction. As a result, jobs that need to roll back database changes will have to decorate the run method with `@transaction.atomic` or use the `with transaction.atomic()` context manager in the job code.
+
+With the removal of the atomic transaction, the `commit` flag has been removed. The ability to bypass job approval on dryrun can be achieved by using an optional `dryrun` argument. Job authors who wish to allow users to bypass approval when the `dryrun` flag is set should set a `dryrun` attribute with a value of `DryRunVar()` on their job class. `DryRunVar` can be imported from `nautobot.extras.jobs`.
+
+!!! example
+    ```py
+    from nautobot.extras.jobs import DryRunVar, Job
+
+    class ExampleJob(Job):
+        dryrun = DryRunVar()
+
+        def run(self, dryrun):
+            ...
+    ```
+
+A new `supports_dryrun` field has been added to the `Job` model and `Job` class that returns true if the `Job` class implements the `dryrun = DryRunVar()` attribute. This is used to determine if jobs that require approval can be dry run without prior approval.
+
+The `commit_default` job field has been renamed to `dryrun_default` and the default value has been changed from `True` to `False`.
+
+!!! important
+    The `read_only` job field no longer changes the behavior of Nautobot core and is left to the job author to decide whether their job is read only.
+
+!!! important
+    Nautobot no longer enforces any job behavior when dryrun is set. It is now the job author's responsibility to define and enforce the execution of a "dry run".