Skip to content

Commit b618578

Browse files
authored
Merge pull request #498 from ritza-co/software-improvements
1231: Grammar cleanup: software and related infrastructure management pages (Week 8, 2026)
2 parents 188a509 + 550009e commit b618578

10 files changed

Lines changed: 179 additions & 202 deletions

docs/infrastructure-management/assets.mdx

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@ sidebar_position: 5.5
66
import ThemedImage from "@theme/ThemedImage";
77
import useBaseUrl from "@docusaurus/useBaseUrl";
88

9-
Assets are useful for tracking items that may not be directly discoverable. Like devices in Device42, assets can support lifecycle events, be racked, and be assigned parts. However, assets do not consume licenses.
9+
Assets are useful for tracking items that may not be directly discoverable. Like devices in Device42, assets support lifecycle events, can be racked, and can be assigned parts. Unlike devices, assets do not consume licenses.
1010

11-
You can search, view, add, and edit assets from the list page under **Resources > All Assets**.
11+
Navigate to **Resources > All Assets** to search, view, add, and edit assets.
1212

13-
## Adding Assets
13+
## Add an Asset
1414

15-
From the Assets list page, click the **Create** button to create a new asset.
15+
On the Assets list page, click **Create**.
1616

1717
<ThemedImage
1818
alt="Assets list page"
@@ -24,17 +24,17 @@ From the Assets list page, click the **Create** button to create a new asset.
2424

2525
### Asset Types
2626

27-
Choose an asset **Type** from the dropdown menu or create a custom asset type by clicking **+** to the right. Different options in the Add Asset form will be available depending on the asset type you select.
27+
Choose an asset **Type** from the dropdown menu, or click the **plus icon** to create a custom asset type. The options available in the Add Asset form depend on the asset type you select.
2828

2929
<ThemedImage
30-
alt="Assets Types menu"
30+
alt="Asset Types menu"
3131
sources={{
3232
light: useBaseUrl("/assets/images/assets-page/asset-type-list-light.png"),
3333
dark: useBaseUrl("/assets/images/assets-page/asset-type-list-dark.png"),
3434
}}
3535
/>
3636

37-
Name your custom asset type. If you want to associate assets of this new type with devices, check the **Asset Device Relation** checkbox. Designate the types of locations (**Storage Room**, **Server Room**, **Building**, and **Rack**) that assets of this type will be assigned to.
37+
Name your custom asset type. To associate assets of this type with devices, check the **Asset Device Relation** checkbox. Then designate the location types (**Storage Room**, **Server Room**, **Building**, and **Rack**) that assets of this type will be assigned to.
3838

3939
<ThemedImage
4040
alt="Create a custom asset type"
@@ -70,17 +70,16 @@ Show the **Rack Info** section by choosing **ACL** from the **Type** dropdown (o
7070

7171
### Object Category Field
7272

73-
In v19.06, the **Object Category** field on individual asset view pages is displayed only when **Role-Based Access Control** (RBAC) is enabled globally.
73+
The **Object Category** field appears on asset view pages only when **Role-Based Access Control** (RBAC) is enabled globally.
7474

75-
A workaround on view pages is to use the **Legacy View** button to see the **Object Category** field.
75+
As a workaround, click **Legacy View** to see the **Object Category** field.
7676

7777
Turn on **Role-Based Access Control** under **Tools > Settings > Global Settings**.
7878

7979
## Asset Actions
8080

81-
The action menu has options for deleting, exporting, and updating assets. You can also **Generate QR/Barcodes for selected Items** for asset management.
81+
Select one or more assets from the list, then choose an action from the **Actions** dropdown:
8282

83-
Select one or several assets from the table, and select an action from the menu:
8483
- Delete with Detailed Confirmation
8584
- Fast Background Delete
8685
- Export Selected Items
@@ -99,4 +98,4 @@ Select one or several assets from the table, and select an action from the menu:
9998
light: useBaseUrl("/assets/images/assets-page/assets-actions-menu-light.png"),
10099
dark: useBaseUrl("/assets/images/assets-page/assets-actions-menu-dark.png"),
101100
}}
102-
/>
101+
/>

docs/infrastructure-management/certificate-management.mdx

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,22 @@ sidebar_position: 5
66
import ThemedImage from "@theme/ThemedImage";
77
import useBaseUrl from "@docusaurus/useBaseUrl";
88

9-
This page is about managing SSL certificates in Device42, including viewing discovered certificates and importing certificates from files. For details on creating a certificate autodiscovery job, visit [Certificate Autodiscovery](/auto-discovery/certificate-auto-discovery.mdx).
9+
Device42 tracks SSL certificates discovered across your infrastructure and lets you view validity details, associate certificates with devices and FQDNs, and run expiry reports. For details on creating a certificate discovery job, see [Certificate Discovery](/auto-discovery/certificate-auto-discovery.mdx).
1010

1111
## Certificate List Page
1212

13-
The list page for certificates, under **Applications > Certificates**, will show you all certificates discovered in Device42 along with their validity details.
13+
The certificate list page, under **Applications > Certificates**, shows all certificates discovered in Device42 along with their validity details.
1414

15-
The fields include:
15+
Each certificate entry displays the following fields:
1616

1717
- Serial Number
18-
- Is Key Encipherment
19-
- Is Key CERT Sign
18+
- Key Encipherment
19+
- Key CERT Sign
2020
- Subject Alternative Name
2121
- First Detected date and time
2222
- Encryption method
2323

24-
You can export certificates by selecting them from the list and choosing the **Export Selected items as CSV** option from the **Actions** dropdown menu.
24+
You can export certificates by selecting them from the list and choosing **Export Selected items as CSV** from the **Actions** dropdown.
2525

2626
<ThemedImage
2727
alt="Certificate list page"
@@ -37,9 +37,9 @@ You can export certificates by selecting them from the list and choosing the **E
3737

3838
### View Certificates
3939

40-
Click on the name of a certificate from the list page, under **Applications > Certificates**, to view it.
40+
Click the name of a certificate to view it.
4141

42-
When viewing a certificate that has been imported, you can now associate FQDN, multiple devices, IPs, and different validity dates with your certificates. This allows you to have a wildcard certificate and easily see the different FQDNs or subdomains associated with it.
42+
You can associate an FQDN, multiple devices, IPs, and different validity dates with a certificate. This is useful for wildcard certificates, where you can see all the FQDNs or subdomains associated with a single certificate.
4343

4444
<ThemedImage
4545
alt="View certificate"
@@ -63,20 +63,20 @@ Device42 supports certificate uploads in the following formats:
6363

6464
## Certificate Instances
6565

66-
In addition to seeing all certificates, you can now see certificate instances - allowing you to see device/IP address relationships for individual certificates. Locate certificate instances under **Applications > Certificate Instances**. Filter certificate instances based on device building, service level, and customer.
66+
Certificate instances show the device and IP address relationships for individual certificates. Navigate to **Applications > Certificate Instances** to view them. You can filter by device building, service level, and customer.
6767

6868
Certificate instances are also displayed in the device details view.
6969

70-
<ThemedImage
71-
alt="Certificate Instances"
72-
sources={{
73-
light: useBaseUrl('/assets/images/device-add-edit/certificate-instances-light.png'),
74-
dark: useBaseUrl('/assets/images/device-add-edit/certificate-instances-dark.png'),
75-
}}
76-
/>
70+
<ThemedImage
71+
alt="Certificate instances in the device details view"
72+
sources={{
73+
light: useBaseUrl('/assets/images/device-add-edit/certificate-instances-light.png'),
74+
dark: useBaseUrl('/assets/images/device-add-edit/certificate-instances-dark.png'),
75+
}}
76+
/>
7777

7878
## Certificate Reports
7979

80-
Though you can have multiple valid-to dates associated with a single certificate, Device42 reports still know to alert you based on the oldest date stored for a given certificate.
80+
When a certificate has multiple valid-to dates, Device42 reports alert based on the oldest date stored for that certificate.
8181

82-
This allows you to run reports to see which devices you still need their certificates updated, allowing you to see your update progressing — which can prove especially useful with very large deployments.
82+
You can run reports to see which devices still need their certificates updated. This is especially useful in large deployments where you want to track update progress.

docs/infrastructure-management/operating-systems.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ sidebar_position: 4
66
import ThemedImage from '@theme/ThemedImage'
77
import useBaseUrl from '@docusaurus/useBaseUrl'
88

9-
Device42 tracks which devices are running which Operating Systems (OS). This module also ties into Software License Management so that you can see how many copies you are licensed for and how many you are actually using.
9+
Device42 tracks which operating systems (OS) are running on which devices, and integrates with Software License Management so you can compare licensed counts against actual usage.
1010

11-
Navigate to **Resources > Operating Systems > All Operating Systems** to locate the Operating Systems list.
11+
Navigate to **Resources > Operating Systems > All Operating Systems** to view the Operating Systems list.
1212

1313
<ThemedImage
1414
alt="Operating Systems list with Enriched Data icons"
@@ -18,24 +18,24 @@ Navigate to **Resources > Operating Systems > All Operating Systems** to locate
1818
}}
1919
/>
2020

21-
If the OS is standardized and enriched by the data Normalization and Enrichment Service, an **AI icon** will be displayed to the right of its name.
21+
If the OS is standardized and enriched by the data Normalization and Enrichment Service, an **AI icon** appears to the right of its name.
2222

23-
The Operating Systems list page shows all of your operating systems and includes the **Total Count** of devices running the OS, the **Discovered Licensed Count**, and the number of OSs that are not licensed (named **Discovered Non-Licensed Count**). If you click on one of the listed operating systems, you will see details including which machines are running the OS.
23+
The list shows all operating systems with the **Total Count** of devices running each OS, the **Discovered Licensed Count**, and the **Discovered Non-Licensed Count**. Click an operating system to see details, including which machines are running it.
2424

2525
## Enriched Data Operating System Fields
2626

27-
If the OS record has been enriched, key maintenance dates may be displayed in the **Enriched Data** section along with other OS details.
27+
When an OS record has been enriched, key maintenance dates and other OS details appear in the **Enriched Data** section of the record.
2828

2929
<ThemedImage
30-
alt="Windows device Enriched Data example"
30+
alt="AI icon hover over on the Operating Systems list"
3131
sources={{
3232
light: useBaseUrl('/assets/images/operating-systems/ai-hover-over-light.png'),
3333
dark: useBaseUrl('/assets/images/operating-systems/ai-hover-over-dark.png'),
3434
}}
3535
/>
3636

3737
<ThemedImage
38-
alt="Windows device Enriched Data example"
38+
alt="Enriched Data section on a Windows OS record"
3939
sources={{
4040
light: useBaseUrl('/assets/images/operating-systems/enriched-data-details-light.png'),
4141
dark: useBaseUrl('/assets/images/operating-systems/enriched-data-details-dark.png'),
@@ -47,12 +47,12 @@ See the [Operating System Attributes](auto-discovery/enriched-data/index.mdx#ope
4747
Note that data will only be populated by the data Normalization and Enrichment Service if it's used by the OS vendor and if the data is available.
4848

4949
:::info
50-
Operating System fields that contain Enriched Data cannot be edited or changed.
50+
Operating System fields that contain Enriched Data cannot be edited or changed.
5151
:::
5252

5353
### Disable OS Changes via API, Discovery, or EnrichAI
5454

55-
You can prevent non-manual changes being made to OS data. On the OS view, click the **Edit** button and turn on the **Don't change via API/Discovery/EnrichAI** option for device OSs.
55+
Use this option to protect OS data from being overwritten by automated processes. On the OS record, click **Edit** and enable the **Don't change via API/Discovery/EnrichAI** option.
5656

5757
<ThemedImage
5858
alt="Don't change via API/Discovery/EnrichAI option"
@@ -62,6 +62,6 @@ You can prevent non-manual changes being made to OS data. On the OS view, click
6262
}}
6363
/>
6464

65-
## OS Update Logic for Devices
65+
## OS Update Logic
6666

67-
Each discovery job in Device42 assigns an accuracy score to the OS it detects. Device42 will only update a device's OS information for newly discovered OS on the same device if the accuracy score is equal to or greater than the prior OS accuracy score.
67+
Each discovery job assigns an accuracy score to the OS it detects. Device42 only updates a device's OS information if the newly discovered OS has an accuracy score equal to or greater than the previously recorded score.

docs/infrastructure-management/software/index.mdx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@ title: "Software"
55
import ThemedImage from '@theme/ThemedImage'
66
import useBaseUrl from '@docusaurus/useBaseUrl'
77

8-
The Software License Management (SLM) module allows you to create and maintain a comprehensive, accurate profile of software deployed across all Windows and Linux machine instances within your IT infrastructure.
8+
The Software License Management (SLM) module helps you build and maintain an accurate profile of software deployed across Windows and Linux machines in your IT infrastructure. Use it to track installed software, manage license models, and monitor end-of-life status.
99

10-
Navigate to **Resources > Software Components** and select the relevant page for viewing or managing your software:
10+
Navigate to **Resources > Software Components** and choose the section you need:
1111

1212
* [All Software Components](software-components.mdx)
1313
* [Software License Models](software-license-management.mdx)
1414
* [Software in Use](software-in-use.mdx)
15-
* [EOL / EOS](software-eol-eos.mdx)
15+
* [Software End-of-Life or End-of-Support](software-eol-eos.mdx)
1616

1717
<ThemedImage
1818
alt="The Software Components section in the Resources menu"
@@ -22,9 +22,11 @@ Navigate to **Resources > Software Components** and select the relevant page fo
2222
}}
2323
/>
2424

25+
The image above shows the four sections available under **Resources > Software Components**.
26+
2527
## Discover Software
2628

27-
When creating a discovery job, select the **Discover Software** option under **Software and Applications** to ensure that all software information is found.
29+
The **Discover Software** option under **Software and Applications** is enabled by default when you create a discovery job. Confirm it is checked to ensure software data is collected.
2830

2931
<ThemedImage
3032
alt="Discover Software option"

docs/infrastructure-management/software/merge-and-assign-software-components.mdx

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,13 @@ sidebar_position: 4
66
import ThemedImage from '@theme/ThemedImage'
77
import useBaseUrl from '@docusaurus/useBaseUrl'
88

9-
You can merge software components and assign them to a component suite as follows:
9+
Software suites let you group related software components together for easier license tracking and reporting. This page covers how to assign components to a suite and how to handle components that share the same name before merging.
1010

11-
- Navigate to **Resources > Software Components > All Software Components** to view the **Software Components** list page.
12-
- Select the components you want to merge, choose **Assign Software to Suite** from the **Actions** dropdown, and confirm to run the action.
11+
## Assign Software to a Suite
12+
13+
1. Navigate to **Resources > Software Components > All Software Components**.
14+
2. Select the components you want to merge and choose **Assign Software to Suite** from the **Actions** dropdown.
15+
3. Confirm to run the action.
1316

1417
<ThemedImage
1518
alt="Assign software to suite"
@@ -19,13 +22,13 @@ You can merge software components and assign them to a component suite as follow
1922
}}
2023
/>
2124

22-
- In the **Assign Software to Suite** dialog, click **Select Software Suite** and search for an existing software component to create the suite that the selected components will be assigned to, then click **Assign** to confirm.
25+
4. In the **Assign Software to Suite** dialog, click **Select Software Suite** and search for the existing software component that will become the suite. Click **Assign** to confirm.
2326

2427
<ThemedImage
2528
alt="Assign software component"
2629
sources={{
2730
light: useBaseUrl('/assets/images/merge-assign-software-components/merge-add-component-light.png'),
28-
dark: useBaseUrl('/assets/images/merge-assign-software-components//merge-add-component-dark.png'),
31+
dark: useBaseUrl('/assets/images/merge-assign-software-components/merge-add-component-dark.png'),
2932
}}
3033
/>
3134

@@ -37,19 +40,18 @@ To view the software components in a suite, select the suite **Name** from the *
3740
alt="Software components in suite box"
3841
sources={{
3942
light: useBaseUrl('/assets/images/merge-assign-software-components/software-components-in-suite-light.png'),
40-
dark: useBaseUrl('/assets/images/merge-assign-software-components//software-components-in-suite-dark.png'),
43+
dark: useBaseUrl('/assets/images/merge-assign-software-components/software-components-in-suite-dark.png'),
4144
}}
4245
/>
4346

4447
## Merge Software Components with the Same Name
4548

46-
To merge software components with the same name into a suite, you must first merge them together, then merge them into a suite. A new component suite cannot have the same **name + vendor** combination as an existing software component; it must have a unique **name + vendor** combination.
47-
49+
To merge software components with the same name into a suite, you must first merge them, then add them to a suite. A new component suite must have a unique **name + vendor** combination — it cannot match an existing software component.
4850

49-
For example, if you had:
51+
For example, given these three components:
5052

51-
1. A software component `ABC`, with the vendor `Cisco`.
52-
2. A software component `ABC`, with the vendor `MS`.
53-
3. A software component `ABC-Suite`, with the vendor `None`.
53+
1. `ABC`vendor `Cisco`
54+
2. `ABC`vendor `MS`
55+
3. `ABC-Suite`vendor `None`
5456

55-
You could merge either `1.` **or** `2.` into `3.` without problem. However, if you tried to merge `1.` **and** `2.` into `3.`, you would receive a validation error prompting you to merge `1.` with `2.` before trying to merge them into `3.`.
57+
You can merge either component 1 or component 2 into component 3 without issue. However, merging both 1 and 2 into 3 at the same time will produce a validation error. In that case, merge 1 and 2 together first, then merge the result into 3.

0 commit comments

Comments
 (0)