Files
UA-.NETStandard/samples/Di/PumpDeviceIntegrationServer/Model/Opc.Ua.Machinery.NodeSet2.csv
5899354441 Clarify documentation, migration guidance, and SDK selection (#4823)
# Description

Remove stock phrasing and correct misleading or inconsistent technical
documentation. The initial two passes covered 367 Markdown files,
followed by an interactive review of 169 editorial flags. The U5
interpretation originally deferred in that review has since received the
upstream Mantis answer recorded by #4843; remaining server/spec
follow-ups stay explicit in the CTT log.

- Correct package responsibilities, migration steps, API names,
ownership, protocol descriptions and links. Keep bundled migration
guides synchronized. Preserve historical conclusions as historical
records with separate re-check notes.
- Provide at least two rendered TOC levels throughout `docs/`. Convert
appropriate architecture figures to Mermaid without changing code
examples, transcripts or historical quotations.
- Address the October 19 feedback with concrete setup/migration
instructions, corrected certificate paths and PubSub names, shorter
repeated caveats, consistent XML comments, and a full review of the
Concepts guide. Retain #4839's API corrections.
- Integrate #4841's runtime/performance guidance and review
incoming/recent prose. Preserve dated measurements rather than claiming
new benchmark runs; clarify allocation ratios, startup-only processor
settings, JIT warm-up and the benchmark commit's scope. Missing raw
measurement artifacts and repeat ranges remain tracked by #4842.
- Merge master through `e8c5d800a` in `32c6394b7`. Resolve the CTT log
conflict using the updated Mantis states and OPC answers, retaining
historical framing and re-checks for C28/C32/C43.
- Address the latest naming/index feedback in `adb5bf693`: rename the
guides to `docs/WotCon.md` and `docs/WotNodeSetConversion.md`; move the
provider and DataType-declaration contracts into the conversion guide
and remove `docs/WoT.md`. Rename `samples/DI` to `samples/Di` and
`samples/Isa95` to `samples/ISA95`. Add content-index READMEs to Di,
FluentApi, ISA95, Lds and PubSub; update solution entries, project
references, Docker/CI paths, test fixture paths and documentation links
with exact casing.

**WoT guide scope.** This branch retains the detailed conversion guide
that #4758 had replaced with an anchor stub. Conversion limits, verified
document sets, preservation rules and provider ownership now live
together in `WotNodeSetConversion.md`; binding/runtime guidance remains
in `WotBindings.md` and `WotCon.md`. The design-rationale/test-ledger
prose was shortened, the oversized argument-table cell moved into its
section, and existing anchors preserved.

**SDK policy is a separate, explicit user-directed change.**
`global.json` sets a stable minimum of `10.0.400`, `rollForward:
latestMajor`, and `allowPrerelease: false`. Newer major SDKs are
permitted; CI's explicit SDK pins are unchanged. README, GettingStarted,
DeveloperGuide and Recycling instructions reflect the possible analyzer
differences. The image-contract regression fix accepts compatible stable
SDK images instead of requiring exact equality with the floor.

The latest four rename/index threads are resolved after publication.
Three older threads remain open: universal obsolete-removal timing,
unconditional nonce-strength wording, and a blanket Vision NativeAOT
claim. Existing implementation/evidence constraints are explained in
their inline replies. The two-level TOCs remain as requested.

## Validation

- `git diff --check` and staged diff checks: passed. The untouched
upstream AutoID NodeSet retains its provenance bytes, including two
existing license-header trailing spaces.
- `.\.azurepipelines\validate-migration-plugin.ps1`: passed; 15 bundled
migration documents and manifests synchronized.
- Documentation/path validation: **101** documents retain two rendered
TOC levels (**2,228** entries), with idempotent formatting. **52** new
relative links and their anchors passed exact-case checks. No tracked
references to the old guide/sample paths remain. Both relocated
provider-contract sections are preserved in the destination.
- `dotnet sln UA.slnx list`: passed; shows the renamed Di/ISA95 projects
and the existing FluentApi/Lds/PubSub projects. Updated solution and
pump ProjectReference paths also passed exact-case existence checks.
- Latest focused commands, run from the repository root:

```powershell
# Passed: 61 channel send-order and reconnect tests.
dotnet test tests\Opc.Ua.Core.Tests\Opc.Ua.Core.Tests.csproj -p:CustomTestTarget=net10.0 --filter 'FullyQualifiedName~UaSCBinaryChannelSendOrderTests|FullyQualifiedName~TcpReconnectKeyAgreementTests' --verbosity minimal

# Passed: 5 pump datasheet tests; builds the renamed pump sample.
dotnet test tests\Opc.Ua.Di.Tests\Opc.Ua.Di.Tests.csproj -p:CustomTestTarget=net10.0 --filter 'FullyQualifiedName~PumpDatasheetConformanceTests' --verbosity minimal

# Passed: 4 repository NodeSet path/round-trip tests, including the moved pump models.
dotnet test tests\Opc.Ua.Types.Tests\Opc.Ua.Types.Tests.csproj -p:CustomTestTarget=net10.0 --filter 'FullyQualifiedName~RepositorySourceSurvivesSerializedLinkedPartitionsAsync' --verbosity minimal

# Passed: build, zero warnings/errors.
dotnet build samples\ISA95\MinimalIsa95Server\MinimalIsa95Server.csproj -p:CustomTestTarget=net10.0 -f net10.0 --verbosity minimal

# Passed: dependent sample-test project build, zero warnings/errors.
dotnet build tests\Opc.Ua.WotCon.Samples.Tests\Opc.Ua.WotCon.Samples.Tests.csproj -p:CustomTestTarget=net10.0 -f net10.0 --verbosity minimal
```

Earlier focused integration checks passed 2,620 tests across AutoID,
event queues/scheduling, source generation, MCP/package profiles and
WoT. Both reviewed Mermaid diagrams rendered locally without network
access. These checks are not a full solution run.

The full solution has **not** been rerun for this review. Earlier
`dotnet test UA.slnx -p:CustomTestTarget=net10.0 --verbosity quiet` did
not pass: three AOT projects rejected VSTest and 20 Vision tests failed
during graphics initialization with `OutOfMemoryException`. Remaining
long-running tests were stopped at the user's request. A focused Vision
rerun passed 558 tests and reproduced those 20 failures. The earlier
`dotnet test UA.slnx -p:CustomTestTarget=net48 --verbosity quiet` was
blocked by the former SDK pin and was not retried after the policy
change. The user approved proceeding with those limitations documented;
current remote CI is not claimed green.

## Related Issues

- Follow-up #4842 tracks the requested 2.0.2+ benchmark/tuning and
diagnostic-tool documentation refresh. #4841 supplies documentation and
earlier results, not all newly requested measurements.
- #4758 explains the conversion guide's earlier consolidation; the
current provider contracts are now consolidated into
`WotNodeSetConversion.md`.
- #4839 supplies the reviewed API corrections; #4843 supplies the
updated CTT issue record.
- The original prose cleanup and SDK policy were user-requested without
a source issue. No new runtime architecture is introduced by these
documentation edits.

## Checklist

_Put an `x` in the boxes that apply. You can complete these step by step
after opening the PR._

- [ ] I have signed the
[CLA](https://opcfoundation.org/license/cla/ContributorLicenseAgreementv1.0.pdf)
and read the
[CONTRIBUTING](https://github.com/OPCFoundation/UA-.NETStandard/blob/master/CONTRIBUTING.md)
doc.
- [ ] I have added tests that prove my fix is effective or that my
feature works and increased code coverage.
- [x] I have added all necessary documentation.
- [ ] I have verified that my changes do not introduce (new) build or
analyzer warnings.
- [ ] I ran **all** tests locally using the **UA.slnx** solution against
at least .net **framework** and .net **10**, and all passed.
- [ ] I fixed **all** failing and flaky tests in the CI pipelines and
**all** CodeQL warnings.
- [ ] I have addressed **all** PR feedback received.

---------

Co-authored-by: Roman Ettlinger <romanett98@gmail.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 10:10:55 +02:00

12 KiB

1Machines1001Object
2MachineryItemState_StateMachineType1002ObjectType
3IMachineryItemVendorNameplateType1003ObjectType
4MachineryItemIdentificationType1004ObjectType
5MachineryComponentIdentificationType1005ObjectType
6MachineComponentsType1006ObjectType
7IMachineryEquipmentType1007ObjectType
8MachineryOperationModeStateMachineType1008ObjectType
9MachineryOperationCounterType1009ObjectType
10IMachineVendorNameplateType1010ObjectType
11IMachineTagNameplateType1011ObjectType
12MachineIdentificationType1012ObjectType
13MachineryEquipmentFolderType1013ObjectType
14MonitoringType1014ObjectType
15MachineryLifetimeCounterType1015ObjectType
16NotificationsType1017ObjectType
17Server_Namespaces_http___opcfoundation_org_UA_Machinery_5001Object
18MachineComponentsType_Component5002Object
19MachineComponentsType_Component_Identification5003Object
20MachineryItemState_StateMachineType_OutOfService5004Object
21MachineryItemState_StateMachineType_NotAvailable5005Object
22MachineryItemState_StateMachineType_Executing5006Object
23MachineryItemState_StateMachineType_NotExecuting5007Object
24MachineryItemState_StateMachineType_FromNotAvailableToOutOfService5008Object
25MachineryItemState_StateMachineType_FromNotAvailableToNotExecuting5009Object
26MachineryItemState_StateMachineType_FromNotAvailableToExecuting5010Object
27MachineryItemState_StateMachineType_FromNotAvailableToNotAvailable5011Object
28MachineryItemState_StateMachineType_FromOutOfServiceToNotAvailable5012Object
29MachineryItemState_StateMachineType_FromOutOfServiceToNotExecuting5013Object
30MachineryItemState_StateMachineType_FromOutOfServiceToExecuting5014Object
31MachineryItemState_StateMachineType_FromOutOfServiceToOutOfService5015Object
32MachineryItemState_StateMachineType_FromNotExecutingToNotAvailable5016Object
33MachineryItemState_StateMachineType_FromNotExecutingToOutOfService5017Object
34MachineryItemState_StateMachineType_FromNotExecutingToExecuting5018Object
35MachineryItemState_StateMachineType_FromNotExecutingToNotExecuting5019Object
36MachineryItemState_StateMachineType_FromExecutingToNotAvailable5020Object
37MachineryItemState_StateMachineType_FromExecutingToOutOfService5021Object
38MachineryItemState_StateMachineType_FromExecutingToNotExecuting5022Object
39MachineryItemState_StateMachineType_FromExecutingToExecuting5023Object
40MachineryOperationModeStateMachineType_None5024Object
41MachineryOperationModeStateMachineType_Maintenance5025Object
42MachineryOperationModeStateMachineType_Processing5026Object
43MachineryOperationModeStateMachineType_Setup5027Object
44MachineryOperationModeStateMachineType_FromNoneToMaintenance5028Object
45MachineryOperationModeStateMachineType_FromNoneToSetup5029Object
46MachineryOperationModeStateMachineType_FromNoneToProcessing5030Object
47MachineryOperationModeStateMachineType_FromNoneToNone5031Object
48MachineryOperationModeStateMachineType_FromMaintenanceToNone5032Object
49MachineryOperationModeStateMachineType_FromMaintenanceToSetup5033Object
50MachineryOperationModeStateMachineType_FromMaintenanceToProcessing5034Object
51MachineryOperationModeStateMachineType_FromMaintenanceToMaintenance5035Object
52MachineryOperationModeStateMachineType_FromSetupToNone5036Object
53MachineryOperationModeStateMachineType_FromSetupToMaintenance5037Object
54MachineryOperationModeStateMachineType_FromSetupToProcessing5038Object
55MachineryOperationModeStateMachineType_FromSetupToSetup5039Object
56MachineryOperationModeStateMachineType_FromProcessingToNone5040Object
57MachineryOperationModeStateMachineType_FromProcessingToMaintenance5041Object
58MachineryOperationModeStateMachineType_FromProcessingToSetup5042Object
59MachineryOperationModeStateMachineType_FromProcessingToProcessing5043Object
60MonitoringType_Status5044Object
61MonitoringType_Health5045Object
62MonitoringType_Process5046Object
63MonitoringType_Consumption5047Object
64MonitoringType_Status_MachineryItemState5048Object
65MonitoringType_Status_MachineryOperationMode5049Object
66MonitoringType_Status_Stacklight5050Object
67MonitoringType_Health_DeviceHealthAlarms5051Object
68MachineryEquipmentFolderType_MachineryEquipment5052Object
69MachineryItemIdentificationType_ProductInstanceUri6001Variable
70MachineryItemIdentificationType_Manufacturer6002Variable
71MachineryItemIdentificationType_SerialNumber6003Variable
72MachineryItemIdentificationType_YearOfConstruction6004Variable
73MachineryItemIdentificationType_MonthOfConstruction6005Variable
74MachineryItemIdentificationType_InitialOperationDate6006Variable
75MachineryItemIdentificationType_ManufacturerUri6007Variable
76MachineryItemIdentificationType_Model6008Variable
77MachineryItemIdentificationType_ProductCode6009Variable
78MachineryItemIdentificationType_HardwareRevision6010Variable
79MachineryItemIdentificationType_SoftwareRevision6011Variable
80MachineryItemIdentificationType_DeviceClass6012Variable
81MachineryItemIdentificationType_AssetId6013Variable
82MachineryItemIdentificationType_ComponentName6014Variable
83MachineIdentificationType_ProductInstanceUri6015Variable
84MachineryComponentIdentificationType_DefaultInstanceBrowseName6016Variable
85MachineryComponentIdentificationType_DeviceRevision6017Variable
86MachineComponentsType_DefaultInstanceBrowseName6018Variable
87MachineComponentsType_Component_Identification_Manufacturer6019Variable
88MachineComponentsType_Component_Identification_SerialNumber6020Variable
89MachineryItemState_StateMachineType_DefaultInstanceBrowseName6021Variable
90IMachineryItemVendorNameplateType_Manufacturer6022Variable
91IMachineVendorNameplateType_ProductInstanceUri6023Variable
92IMachineryItemVendorNameplateType_SerialNumber6024Variable
93IMachineryItemVendorNameplateType_YearOfConstruction6025Variable
94IMachineryItemVendorNameplateType_MonthOfConstruction6026Variable
95IMachineryItemVendorNameplateType_InitialOperationDate6027Variable
96IMachineTagNameplateType_Location6028Variable
97MachineIdentificationType_Location6029Variable
98MachineIdentificationType_DefaultInstanceBrowseName6030Variable
99Server_Namespaces_http___opcfoundation_org_UA_Machinery__IsNamespaceSubset6031Variable
100Server_Namespaces_http___opcfoundation_org_UA_Machinery__NamespacePublicationDate6032Variable
101Server_Namespaces_http___opcfoundation_org_UA_Machinery__NamespaceUri6033Variable
102Server_Namespaces_http___opcfoundation_org_UA_Machinery__NamespaceVersion6034Variable
103Server_Namespaces_http___opcfoundation_org_UA_Machinery__StaticNodeIdTypes6035Variable
104Server_Namespaces_http___opcfoundation_org_UA_Machinery__StaticNumericNodeIdRange6036Variable
105Server_Namespaces_http___opcfoundation_org_UA_Machinery__StaticStringNodeIdPattern6037Variable
106MachineryItemState_StateMachineType_OutOfService_StateNumber6038Variable
107MachineryItemState_StateMachineType_NotAvailable_StateNumber6039Variable
108MachineryItemState_StateMachineType_Executing_StateNumber6040Variable
109MachineryItemState_StateMachineType_NotExecuting_StateNumber6041Variable
110MachineryItemState_StateMachineType_FromNotAvailableToOutOfService_TransitionNumber6042Variable
111MachineryItemState_StateMachineType_FromNotAvailableToNotExecuting_TransitionNumber6043Variable
112MachineryItemState_StateMachineType_FromNotAvailableToExecuting_TransitionNumber6044Variable
113MachineryItemState_StateMachineType_FromNotAvailableToNotAvailable_TransitionNumber6045Variable
114MachineryItemState_StateMachineType_FromOutOfServiceToNotAvailable_TransitionNumber6046Variable
115MachineryItemState_StateMachineType_FromOutOfServiceToNotExecuting_TransitionNumber6047Variable
116MachineryItemState_StateMachineType_FromOutOfServiceToExecuting_TransitionNumber6048Variable
117MachineryItemState_StateMachineType_FromOutOfServiceToOutOfService_TransitionNumber6049Variable
118MachineryItemState_StateMachineType_FromNotExecutingToNotAvailable_TransitionNumber6050Variable
119MachineryItemState_StateMachineType_FromNotExecutingToOutOfService_TransitionNumber6051Variable
120MachineryItemState_StateMachineType_FromNotExecutingToExecuting_TransitionNumber6052Variable
121MachineryItemState_StateMachineType_FromNotExecutingToNotExecuting_TransitionNumber6053Variable
122MachineryItemState_StateMachineType_FromExecutingToNotAvailable_TransitionNumber6054Variable
123MachineryItemState_StateMachineType_FromExecutingToOutOfService_TransitionNumber6055Variable
124MachineryItemState_StateMachineType_FromExecutingToNotExecuting_TransitionNumber6056Variable
125MachineryItemState_StateMachineType_FromExecutingToExecuting_TransitionNumber6057Variable
126MachineryOperationModeStateMachineType_DefaultInstanceBrowseName6058Variable
127MachineryOperationModeStateMachineType_None_StateNumber6059Variable
128MachineryOperationModeStateMachineType_Maintenance_StateNumber6060Variable
129MachineryOperationModeStateMachineType_Processing_StateNumber6061Variable
130MachineryOperationModeStateMachineType_Setup_StateNumber6062Variable
131MachineryOperationModeStateMachineType_FromNoneToMaintenance_TransitionNumber6063Variable
132MachineryOperationModeStateMachineType_FromNoneToSetup_TransitionNumber6064Variable
133MachineryOperationModeStateMachineType_FromNoneToProcessing_TransitionNumber6065Variable
134MachineryOperationModeStateMachineType_FromNoneToNone_TransitionNumber6066Variable
135MachineryOperationModeStateMachineType_FromMaintenanceToNone_TransitionNumber6067Variable
136MachineryOperationModeStateMachineType_FromMaintenanceToSetup_TransitionNumber6068Variable
137MachineryOperationModeStateMachineType_FromMaintenanceToProcessing_TransitionNumber6069Variable
138MachineryOperationModeStateMachineType_FromMaintenanceToMaintenance_TransitionNumber6070Variable
139MachineryOperationModeStateMachineType_FromSetupToNone_TransitionNumber6071Variable
140MachineryOperationModeStateMachineType_FromSetupToMaintenance_TransitionNumber6072Variable
141MachineryOperationModeStateMachineType_FromSetupToProcessing_TransitionNumber6073Variable
142MachineryOperationModeStateMachineType_FromSetupToSetup_TransitionNumber6074Variable
143MachineryOperationModeStateMachineType_FromProcessingToNone_TransitionNumber6075Variable
144MachineryOperationModeStateMachineType_FromProcessingToMaintenance_TransitionNumber6076Variable
145MachineryOperationModeStateMachineType_FromProcessingToSetup_TransitionNumber6077Variable
146MachineryOperationModeStateMachineType_FromProcessingToProcessing_TransitionNumber6078Variable
147MachineryOperationCounterType_PowerOnDuration6079Variable
148MachineryOperationCounterType_OperationDuration6080Variable
149MachineryOperationCounterType_OperationCycleCounter6081Variable
150MachineryOperationCounterType_DefaultInstanceBrowseName6082Variable
151MachineryLifetimeCounterType_LifetimeVariable6083Variable
152MachineryLifetimeCounterType_LifetimeVariable_LimitValue6084Variable
153MachineryLifetimeCounterType_LifetimeVariable_StartValue6085Variable
154MachineryLifetimeCounterType_LifetimeVariable_EngineeringUnits6086Variable
155MachineryLifetimeCounterType_DefaultInstanceBrowseName6087Variable
156MachineryItemIdentificationType_DefaultInstanceBrowseName6088Variable
157MonitoringType_DefaultInstanceBrowseName6089Variable
158MonitoringType_Status_MachineryItemState_CurrentState6090Variable
159MonitoringType_Status_MachineryItemState_CurrentState_Id6091Variable
160MonitoringType_Status_MachineryOperationMode_CurrentState6092Variable
161MonitoringType_Status_MachineryOperationMode_CurrentState_Id6093Variable
162MonitoringType_Status_Stacklight_StacklightMode6094Variable
163MonitoringType_Health_DeviceHealth6095Variable
164MachineryEquipmentFolderType_MachineryEquipment_AssetId6096Variable
165MachineryEquipmentFolderType_MachineryEquipment_ComponentName6097Variable
166MachineryEquipmentFolderType_MachineryEquipment_Description6098Variable
167MachineryEquipmentFolderType_MachineryEquipment_DeviceClass6099Variable
168MachineryEquipmentFolderType_MachineryEquipment_Location6100Variable
169MachineryEquipmentFolderType_MachineryEquipment_MachineryEquipmentTypeId6101Variable
170MachineryEquipmentFolderType_MachineryEquipment_ManufacturerUri6102Variable
171MachineryEquipmentFolderType_MachineryEquipment_Model6103Variable
172MachineryEquipmentFolderType_MachineryEquipment_SerialNumber6104Variable
173MachineryEquipmentFolderType_DefaultInstanceBrowseName6105Variable
174NotificationsType_DefaultInstanceBrowseName6106Variable
175IMachineryEquipmentType_Description6107Variable
176IMachineryEquipmentType_MachineryEquipmentTypeId6108Variable
177IMachineryEquipmentType_EquipmentLife6109Variable
178IMachineryEquipmentType_EquipmentLife_LimitValue6110Variable
179IMachineryEquipmentType_EquipmentLife_StartValue6111Variable
180IMachineryEquipmentType_EquipmentLife_EngineeringUnits6112Variable