Mismatch report — software-products.md
This is a read-only audit. No edits proposed yet — review before authorizing step 3 (corrections) and step 4 (comment regen).
Summary
The page describes the Licensing Position screen (the per-product list with licensing columns), but the prose calls it "Software Product Catalog" (a name that no longer exists in the product) and the existing robot screenshot recipes navigate to Classify Software Titles instead — a completely different screen showing software titles with classification fields, not products with licensing columns. Result: every existing screenshot in the page would be wrong even after pass 1's mechanical conversion to form-2 recipes, because the recipes themselves point at the wrong menu.
Terms that resolve cleanly
| Term in doc | Catalog match | Notes |
|---|---|---|
Create a new Software Catalog Entry |
✓ IT Asset Management > Software Licensing > Catalog Entries (target: new-record x_menunewasset) |
The menu name is still current. Image 3's recipe is correct. |
Licensing Position (in Related Articles link) |
✓ IT Asset Management > Licensing > Manage Licenses (target: query Software License Management id 10896) |
The actual list of products. This is the screen the page is describing. |
Software Licenses (Related Articles link) |
partial — see "Likely renames" | |
Creating Software Titles Manually (Related Articles link) |
sibling page, not a menu — out of scope | |
Unrecognised Software (Related Articles link) |
sibling page, not a menu — out of scope |
Likely renames
| Term in prose | Best catalog match | Confidence | Suggested replacement |
|---|---|---|---|
| "Software Product Catalogue" (H2 line 11) | No menu by this name exists. Nearest: Licensing Position (the list this page is actually describing). |
High | "Licensing Position" |
| "Software Product Catalog" (line 13, line 35, line 76) | Same as above — no longer a menu name. | High | "Licensing Position" |
| "License menu" (line 13) | Closest top-level: Licensing category in IT Asset Management profile. |
High | "Licensing menu" |
| "Software Product Catalog Menu" (line 35, page-level menu reference) | This refers to the page-action menu on the Licensing Position list. The page-action menu uses the page name as its label. | High | "Licensing Position Menu" |
| "Software Licenses" (line 89, Related Articles link text) | Catalog has Licenses (Manage Licenses subcategory) but no Software Licenses menu. The product appears to have shortened "Software Licenses" → "Licenses" in places. |
Medium — the link target file software-licences.md may also have been renamed. |
"Licenses" (verify the target file name) |
Wrong-target screenshots
These robot comments will produce a screenshot of the wrong screen, even though the recipe is well-formed.
| Image | Current recipe | Problem | Suggested fix |
|---|---|---|---|
| Image 1 (line 16) — "Software Products list view" | ClickMenu "Classify Software Titles" |
Captures the title-classification drag-and-drop screen, not the products list with seats/rights/installed/required columns. The documented column list (Seats, Rights, Installed, Required, Allocated, Assigned, Downgrade Allocated, Outstanding) matches savedselect 10896 (Licensing Position), not 11275 (Classify Software Titles). | ClickMenu "Licensing Position" \| PrintScreen "..." |
| Image 4 (line 55) — "Saved software product detail" | ClickMenu "Classify Software Titles" \| ClickRecord |
Opens a software-title record, not a software-product record. | ClickMenu "Licensing Position" \| ClickRecord \| PrintScreen "..." |
| Image 2 (line 38) — page-action menu open | manual: page-level menu hover state |
Currently parked as manual. Is doable via a JS step that opens the page menu — not blocking pass 1. | Leave as manual for now. |
| Image 3 (line 43) — new product form | ClickMenu "Create a new Software Catalog Entry" |
✓ correct. |
Out-of-catalog terms (button/field/dialog names — flagged for human review)
These don't appear in the menu catalog because they're field-level UI elements (buttons, columns, checkbox labels). Verifying them needs the form/query definition, not the menu list. Listing them here so a reviewer can spot any that look wrong:
Add Existing(button on product editing form, line 57)Edit Link...(button on associated title row, line 69)Defining(checkbox label on Edit Link dialog, line 70)OK(generic save button, lines 46, 61, 74)Load Now(auto-product creation process name, line 80)- Column names: Seats, Rights, Installed, Required, Allocated, Assigned, Downgrade Allocated, Outstanding (lines 22–29)
The column DisplayName values in savedselect 10896 do match (Seats, Rights, Installed, Allocated, Outstanding Requirement (Computers) for Outstanding). The doc uses Required/Assigned/Downgrade Allocated while the actual columns are Rights Required/Allocated as Downgrade — mostly cosmetic prose drift, not a rename.
Suggested next actions (do NOT apply yet)
Step 3 (correct prose):
- Replace "Software Product Catalog"/"Software Product Catalogue" → "Licensing Position" (4 instances).
- Replace "License menu" → "Licensing menu" (1 instance).
- Replace "Software Product Catalog Menu" → "Licensing Position Menu" (1 instance).
- Verify "Software Licenses" link target file exists; if it's now
licences.mdor similar, update both the link text and href.
Step 4 (regenerate comments):
- Image 1: change
ClickMenu "Classify Software Titles"→ClickMenu "Licensing Position". - Image 4: change
ClickMenu "Classify Software Titles" | ClickRecord→ClickMenu "Licensing Position" | ClickRecord. - Image 3 recipe stays as-is —
Create a new Software Catalog Entryis still a real menu. - Image 2 stays manual.
Open question for human review: the page is about software products but the screen it documents is called Licensing Position. The two terms are conflated in the product (the Licensing Position query lists software products). The page heading "Software Products" is correct as a concept, but the navigation prose needs to match what the user actually clicks.