Issue 9926: document style and use of headings (corba-e-ftf) Source: Lockheed Martin (Dr. Ben A. Calloni, ben.a.calloni@lmco.com) Nature: Uncategorized Issue Severity: Summary: In each of 2.4.1 thru 2.4.4 the document titles have paragraphs below them and if necessary then sub headings. In 2.4.5 there is the title and then a sub heading. I'd recommend deleting the heading of 2.4.5.1 and make 2.4.5 the Quality of Service Abstract Model (or Quality of Service Model to match 2.4.1 - 2.4.4 and put the rest of the text under it As reads: 2.4.5Quality of Service 2.4.5.1 QoS Abstract Model The abstract model describes the Quality of Service (QoS) components and their relationships. The specification defines a framework within which current QoS levels are queried and overridden. This framework is intended to be of use for CORBAServices specifiers, as well as for future revisions of CORBA. To read: 2.4.5Quality of Service (Abstract) Model The abstract model describes the Quality of Service (QoS) components and their relationships. The specification defines a framework within which current QoS levels are queried and overridden. This framework is intended to be of use for CORBAServices specifiers, as well as for future revisions of CORBA. Resolution: Change as suggested Revised Text: Eliminate the heading 4.9.1 (page 21). Change the heading of 4.9 to “Quality of Service Abstract Model”. Renumber following subsections Actions taken: July 18, 2006: received issue July 18, 2008: closed issue Discussion: End of Annotations:===== eply-To: From: "Victor Giddings" To: "'Calloni, Ben A'" , "'Juergen Boldt'" Cc: Subject: RE: CORBA/e comment Date: Tue, 18 Jul 2006 17:27:38 -0400 Organization: Objective Interface System X-Mailer: Microsoft Office Outlook, Build 11.0.6353 thread-index: Acaqrno6fGhwt66lSa2hykFdHZAYCQAAk9Tw Ben, Thanks for the comment. (I will need to file as a formal issue to provide traceability). Juergen, Please file as an issue against the CORBA/e FTF. Victor Giddings mailto:victor.giddings@mail.ois.com Senior Scientist +1 703 295 6520 Objective Interface Systems Fax: +1 703 295 6501 -------------------------------------------------------------------------------- From: Calloni, Ben A [mailto:ben.a.calloni@lmco.com] Sent: Tuesday, July 18, 2006 5:16 PM To: victor.giddings@ois.com Subject: CORBA/e comment Vic, If the FTF for CORBA/e has not completed, I have a comment based on document style and use of headings from a tech document writing POV. In each of 2.4.1 thru 2.4.4 the document titles have paragraphs below them and if necessary then sub headings. In 2.4.5 there is the title and then a sub heading. I'd recommend deleting the heading of 2.4.5.1 and make 2.4.5 the Quality of Service Abstract Model (or Quality of Service Model to match 2.4.1 - 2.4.4 and put the rest of the text under it As reads: 2.4.5Quality of Service 2.4.5.1 QoS Abstract Model The abstract model describes the Quality of Service (QoS) components and their relationships. The specification defines a framework within which current QoS levels are queried and overridden. This framework is intended to be of use for CORBAServices specifiers, as well as for future revisions of CORBA. To read: 2.4.5Quality of Service (Abstract) Model The abstract model describes the Quality of Service (QoS) components and their relationships. The specification defines a framework within which current QoS levels are queried and overridden. This framework is intended to be of use for CORBAServices specifiers, as well as for future revisions of CORBA. Ben A. Calloni, Ph.D., P.E. Research Program Manager Advanced Development Programs Technology Development & Integration Mission Systems Avionics & Software Lockheed Martin Aeronautics Company PO Box 748, MZ 8604 Fort Worth, TX 76101 (817) 935-4482 (877) 402-3445 (Pager) (817) 777-6348 (Alternate Working Area) FAX (817) 762-6784 X-Mailer: QUALCOMM Windows Eudora Version 7.0.1.0 Date: Tue, 18 Jul 2006 17:29:46 -0400 To: issues@omg.org, corba-e-ftf@omg.org From: Juergen Boldt Subject: issue 9926 -- CORBA/e FTF issue This is issue # 9926 From: Calloni, Ben A [ mailto:ben.a.calloni@lmco.com] document style and use of headings In each of 2.4.1 thru 2.4.4 the document titles have paragraphs below them and if necessary then sub headings. In 2.4.5 there is the title and then a sub heading. I'd recommend deleting the heading of 2.4.5.1 and make 2.4.5 the Quality of Service Abstract Model (or Quality of Service Model to match 2.4.1 - 2.4.4 and put the rest of the text under it As reads: 2.4.5Quality of Service 2.4.5.1 QoS Abstract Model The abstract model describes the Quality of Service (QoS) components and their relationships. The specification defines a framework within which current QoS levels are queried and overridden. This framework is intended to be of use for CORBAServices specifiers, as well as for future revisions of CORBA. To read: 2.4.5Quality of Service (Abstract) Model The abstract model describes the Quality of Service (QoS) components and their relationships. The specification defines a framework within which current QoS levels are queried and overridden. This framework is intended to be of use for CORBAServices specifiers, as well as for future revisions of CORBA. Juergen Boldt Director, Member Services Object Management Group 140 Kendrick St Building A Suite 300 Needham, MA 02494 USA tel: +1 781 444 0404 x 132 fax: +1 781 444 0320 email: juergen@omg.org www.omg.org smime.p7s