Closed Marius-ASAM closed 1 year ago
The Editorial Guide is currently being developed in a fork. This fork is supposed to be merged in the near future and it contains all currently valid or discussed sets of rules for writing and editing content in standards. I would like to apply those rules (or at least an agreed subset of them) to the Project Guide as well once the Editorial Guide is ready. Until then, I would suggest we leave this issue open.
P.S.: There already is an older version of the Editorial Guide in the Compendium, but it is very much not up-to-date and, therefore, I would refrain from applying its rules just now.
Just the first character of headings and captions is capitalized.
A rule for headings exists: 5.3. Start headings with a capital letter (ASM-2)
The rule for captions contains an example but does currently not define how to apply upper and lower case writing specifically to captions: 10.8. Create a caption for every figure (ASM-58)
The rule for captions is ok. But if "Proposal Phase" is a specific term, then it must also appear with upper case initial letters in a caption. You also wouldn't write your own name lowercase just because it appears in the middle of a caption text. And I would highly recommend that rules that are already known at this moment be applied across all text at the moment of its creation. Reviewing the whole document afterwards for the correct application of the rules is quite a lot of work.
You are right. Proper names should be written as they are. Is "Proposal Phase" a proper name?
This is exactly part of my original question. And I'm adding: who will define the proper names?
I have updated the guide since my comment, so most section titles should now follow these rules (only "most" since my RegEx may not have captured every variant correctly).
I agree that a definition is required for terms that may or may not be considered proper names. This, in particular, covers
My suggestion:
Reasons: In my eyes, this elevates these terms and makes them easier to identify on each page and in graphics. When reading, it should make it easier to quickly scan the page to see if it targets me (my role) or a specific event I am looking for.
The rules look good to me. Who will now decide whether we make them mandatory? (sorry for asking stupid questions)
I do not think this is a stupid question! I would suggest to discuss this shortly in tomorrows Daily and either schedule a short meeting or have the discussion here.
Prerequisites
This is in regards to:
Subject
Capitalization
Section
Figure 1
Description
The capitalization of the Figure's description seems odd
Suggestion
Please define and apply across the whole document consistent rules for capitalization. If "Proposal Phase" is a single term, then write "The Proposal Phase timeline" in the figure caption. If not, the figure caption should read "The proposal phase timeline"