View Issue Details

IDProjectCategoryView StatusLast Update
000639310000-003: Address SpaceApi Changepublic2022-06-20 11:41
ReporterDavid Levine Assigned ToJeff Harding  
PrioritylowSeverityminorReproducibilityalways
Status closedResolutionfixed 
Fixed in Version1.05.02 
Summary0006393: typos and wording in interface definition, in Amendement 7
Description

I was using the online reference for reviewing interfaces and found some very minor issues. The final document needs to be run through a spell checker.

These are all very low priority.

Section 4.9.2
1) "Rules for the defintion of Interfaces:"
"defintion" is mispelled and should be "definition"

2) "If several Interfaces should be applied to the Object, they should be treated as if they where all applied to the ObjectType of the Object at the same time. If this is not possible, the Interfaces cannot be applied to the Object together."
"where" should be "were"

Section 4.9.1 Overview
3) The following sentence is clumsy - it starts with what should not be done instead of what should be done.
"In general, good object-oriented design is accomplished by not over-using inheritance but instead by using composition to aggregate an object providing several functionalities [GH95, FF04]."

Suggest this:
"In general, good object-oriented design is accomplished by using composition to aggregate an object which provides several functionalities instead of over-using inheritance [GH95, FF04]."

4) 7.19 HasInterface ReferenceType
One SourceNode can refer to different Interfaces.

Suggest replacing different with multiple or more than one interface

5) 7.20 HasAddIn ReferenceType
Suggest adding a statement similar to 7.19

"One SourceNode can refer to multiple add-ins."

If this is not valid then the spec should explain why.

6) 8.2.11 InterfaceTypes
"The intention of the “InterfaceTypes” Object is that all Interfaces of the Server are either directly or indirectly accessible browsing HierarchicalReferences starting from this Node."

add the word "by" so that it reads
"The intention of the “InterfaceTypes” Object is that all Interfaces of the Server are either directly or indirectly accessible by browsing HierarchicalReferences starting from this Node."

TagsNo tags attached.
Commit Version
Fix Due Date

Activities

David Levine

2021-01-21 12:00

developer   ~0013595

I mistakenly submitted this as a feature request, it should have been under general UA spec or address space

Jeff Harding

2022-05-10 16:52

developer   ~0016700

Applied all suggestions to 1.05.02 except the 6th comment which is actually a Part 5 comment not Part 3

Jeff Harding

2022-05-10 16:55

developer   ~0016701

Adopted suggested text changes.

Jim Luth

2022-06-20 11:41

administrator   ~0016866

Agreed to changes in F2F meeting.

Issue History

Date Modified Username Field Change
2021-01-21 11:57 David Levine New Issue
2021-01-21 12:00 David Levine Note Added: 0013595
2022-05-10 13:30 Jim Luth Project Feature Requests => 10000-003: Address Space
2022-05-10 13:30 Jim Luth Category Documentation Errata => Api Change
2022-05-10 13:30 Jim Luth Assigned To => Jeff Harding
2022-05-10 13:30 Jim Luth Status new => assigned
2022-05-10 16:52 Jeff Harding Note Added: 0016700
2022-05-10 16:55 Jeff Harding Status assigned => resolved
2022-05-10 16:55 Jeff Harding Resolution open => fixed
2022-05-10 16:55 Jeff Harding Fixed in Version => 1.05.02
2022-05-10 16:55 Jeff Harding Note Added: 0016701
2022-06-20 11:41 Jim Luth Status resolved => closed
2022-06-20 11:41 Jim Luth Note Added: 0016866