Inserting New Objects and Headings...General DOORS entry question...

SystemAdmin - Fri Oct 29 16:10:47 EDT 2010
Generally accepted best practice is to put the Heading in one object and any text objects underneath that. You don't need to put any heading numbers in, DOORS will automatically assign numbers based on the structure of the module.
If you are importing from Word then this all happens for you as long as the Word document is using heading styles with levels and not just bold text.
When entering data direct from the keyboard into DOORS you will notice that every time you create a new object it shows a heading number. If you want to add text only then use one of the many ways to 'Edit Object Text' (CTRL+T is a good one) and the number will disappear.
Don't forget to keep an eye on the structure of the module with the module explorer.

SystemAdmin - Fri Oct 29 16:10:47 EDT 2010
Generally accepted best practice is to put the Heading in one object and any text objects underneath that. You don't need to put any heading numbers in, DOORS will automatically assign numbers based on the structure of the module.
If you are importing from Word then this all happens for you as long as the Word document is using heading styles with levels and not just bold text.
When entering data direct from the keyboard into DOORS you will notice that every time you create a new object it shows a heading number. If you want to add text only then use one of the many ways to 'Edit Object Text' (CTRL+T is a good one) and the number will disappear.
Don't forget to keep an eye on the structure of the module with the module explorer.

llandale - Mon Nov 01 09:50:20 EDT 2010
I enhance this good post.

Yes, almost always separate the Headings from the Text in different objects; certainly 'important' information like "Requirements" or "Test Procecures" should be in their own objects. However 'un-important' information such as "This section describes..." Text could (and I believe "should") be in the same object as the Heading.

Strangely, an empty object is counted as a Heading. Yes, the Paragraph Number disappears from the main column when you add text, but it does not just "disappear", it also changes the number and therefore the number of subsequenty siblings. If you add two empty objects and then edit the text of the 1st, you will notice the displayed paragraph number of the 2nd one will change. "Text" objects (those that don't display Paragraph in the Main Column) have Paragraph Numbers that end in ".0-n" (n is a number); whereas 'Heading' objects lack the "0-" part. So paragraph number "3.2.1.0-3" means this is the 3rd text object under 3.2.1.

When dealing with module structure it should be routine to display the 'Object Level' and the 'Object Number' columns. This includes whenever you figure to move, copy, paste, insert, remove, add text or other such chores.

• Louie

kierant - Mon Nov 01 10:40:18 EDT 2010
Hi - Just to add to above contributions, which I agree with. One mistaken approach I've seen people adopt here is to treat the heading like a title for a reqmt. This is incorrect, as heading should be to trigger a whole new section in the doc, with each reqmt a separate object below it. If those reqmts need some kind of titles then 'Object Short Text' is probably the way to achieve this, but not headings.
Kieran

llandale - Mon Nov 01 09:50:20 EDT 2010
I enhance this good post.

Yes, almost always separate the Headings from the Text in different objects; certainly 'important' information like "Requirements" or "Test Procecures" should be in their own objects. However 'un-important' information such as "This section describes..." Text could (and I believe "should") be in the same object as the Heading.

Strangely, an empty object is counted as a Heading. Yes, the Paragraph Number disappears from the main column when you add text, but it does not just "disappear", it also changes the number and therefore the number of subsequenty siblings. If you add two empty objects and then edit the text of the 1st, you will notice the displayed paragraph number of the 2nd one will change. "Text" objects (those that don't display Paragraph in the Main Column) have Paragraph Numbers that end in ".0-n" (n is a number); whereas 'Heading' objects lack the "0-" part. So paragraph number "3.2.1.0-3" means this is the 3rd text object under 3.2.1.

When dealing with module structure it should be routine to display the 'Object Level' and the 'Object Number' columns. This includes whenever you figure to move, copy, paste, insert, remove, add text or other such chores.

• Louie