search

nmradcc / documents

This is a working repository for development of NMRA DCC Standards, Recommended Practices, Technical Notes, and other documents.
Other
2 stars 1 forks source link

S-9.1.1 Sep 3, 2020 Version Review Comments #25

Open bakerstu opened 3 years ago

bakerstu commented 3 years ago

Document Header: Need to replace manual date field with date property field. See #24 for additional commentary. Document Header: Remove "Draft 2020-09-03"

Line 34: S-9.1 reference should be a member of a bullet list. Line 36-38: TN-9.1.1, TI-9.1.1.X should be a member of a bullet list. Line 37: TI-9.1.1.X should be TI-9.1.1 (no X suffix). There is no intent to have separate TI documents for each daughter standard.

Color Code Table: Please reformat to 12pt font for consistency. There was a comment that the 10pt font was intentional so that it would "fit". I don't know what this means. I test formatted it to 12pt font and it looked good to me. It looked like the Document History table may have been pushed onto another page. This can be corrected in one of three ways:

  1. Remove unused table rows.
  2. Place a page break before the Document History section.
  3. Modify the table properties to "repeat first row heading" on page break.

Line 72-75: These should be formatted as footnotes from the table above them.

JuettM commented 3 years ago

I am in agreement and have addressed most of these. The date field not yet but will replace it with date property field. "Draft 2020-09=-03" removed. DRAFT added behind S-9.1.1 until we take it for voting or after approval. The color code table increased to 12 pt and the footnotes fixed. I have addressed issues in lines 34-38