search

rbms-bsc / DCRMR

Other
12 stars 5 forks source link

Inconsistencies in "Make a note on ..." instructions #185

Open rbms-bsc opened 1 year ago

rbms-bsc commented 1 year ago

Instructions with "make a note on ..." should be reviewed for consistency. Some instructions use "justify," others "give the basis." These should be more normalized.

Note: This issue was originally posted by @elizhobart on 7 June 2021 as a comment on issue #36, which was created as a catch-all for issues related to future development. For ease of tracking, the comments have been moved to their own individual issues and tagged as "future work."

rbms-bsc commented 1 year ago

Need to further investigate phrasing of note, particularly around constructions where we give instructions on information contained in a note (such as "explanatory note" or "to give the basis of"). This phrasing varies.

Note: This comment was originally posted by @elizhobart on 8 June 2021 as a comment on issue #36, which was created as a catch-all for issues related to future development. For ease of tracking, the comments have been moved to their own individual issues and tagged as "future work."

rbms-bsc commented 1 year ago

Phrasing is inconsistent in instructions to make a note. As a BSC reviewer commented: "while "Note on extent ..." already specifies note in its name, it seems inconsistent to not use similar language in this section-- something like "record in a note on Details of illustrative content" -- conversely, you could use "note" in both instances with the appropriate "(see Element, Rule number)" throughout the document."

Note: This comment was originally posted by @elizhobart on 24 June 2021 as a comment on issue #36, which was created as a catch-all for issues related to future development. For ease of tracking, the comments have been moved to their own individual issues and tagged as "future work."