[Minor Issue] Inconsistent capitalization of "Image", "Director", and "Target" repositories #116
Milestone
Comments
|
I agree. I actually did a pass sometime back and capitalized these terms
throughout (as they really are proper nouns). But I'm assuming as new
additions were made that the consistency was lost.
I think they should be capitalized, but if it reads like overkill, we can
change them. The key as you state is to be consistent. I can take care of
this once I know the will of the group.
Lois
…On Wed, Jun 19, 2019 at 12:12 PM Philip Lapczynski ***@***.***> wrote:
It seems to be about 50/50 that we capitalize "Image" "Director", and
"Target" when talking about the repositories. We should make a decision one
way or another and make the document consistent.
—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub
<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_uptane_uptane-2Dstandard_issues_116-3Femail-5Fsource-3Dnotifications-26email-5Ftoken-3DADPGUX2GWDK6NA6QE3LYR43P3JLFLA5CNFSM4HZLHDC2YY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4G2ODFNQ&d=DwMCaQ&c=slrrB7dE8n7gBJbeO0g-IQ&r=hgBKIqNYIOwzXeBjPUaKRw&m=_fT1MYahIULTCX59lsY6S-da5gorspo4Q7Uk-2G_lYI&s=5ebYubeRdGjkohO2-PBwd65hfHY0UC_aT993FJVC9eg&e=>,
or mute the thread
<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_notifications_unsubscribe-2Dauth_ADPGUXZQAIA5YVF7Q5QHLL3P3JLFLANCNFSM4HZLHDCQ&d=DwMCaQ&c=slrrB7dE8n7gBJbeO0g-IQ&r=hgBKIqNYIOwzXeBjPUaKRw&m=_fT1MYahIULTCX59lsY6S-da5gorspo4Q7Uk-2G_lYI&s=4ibfStrGfX4SUS5pCBWexYVTFbXD-Oc5p6uSt14i_SU&e=>
.
|
|
Hi Phil and Lois,
I strongly agree that these always be capitalized. They're fundamental
entities in any Uptane implementation. I also strong feel that Primary
and Secondary should always be capitalized.
Cheers,
- Ira
Ira McDonald (Musician / Software Architect)
Co-Chair - TCG Trusted Mobility Solutions WG
Co-Chair - TCG Metadata Access Protocol SG
Chair - Linux Foundation Open Printing WG
Secretary - IEEE-ISTO Printer Working Group
Co-Chair - IEEE-ISTO PWG Internet Printing Protocol WG
IETF Designated Expert - IPP & Printer MIB
Blue Roof Music / High North Inc
http://sites.google.com/site/blueroofmusic
http://sites.google.com/site/highnorthinc
mailto: blueroofmusic@gmail.com
PO Box 221 Grand Marais, MI 49839 906-494-2434
On Wed, Jun 19, 2019 at 12:18 PM Lois Anne DeLong <notifications@github.com>
wrote:
… I agree. I actually did a pass sometime back and capitalized these terms
throughout (as they really are proper nouns). But I'm assuming as new
additions were made that the consistency was lost.
I think they should be capitalized, but if it reads like overkill, we can
change them. The key as you state is to be consistent. I can take care of
this once I know the will of the group.
Lois
On Wed, Jun 19, 2019 at 12:12 PM Philip Lapczynski <
***@***.***>
wrote:
> It seems to be about 50/50 that we capitalize "Image" "Director", and
> "Target" when talking about the repositories. We should make a decision
one
> way or another and make the document consistent.
>
> —
> You are receiving this because you are subscribed to this thread.
> Reply to this email directly, view it on GitHub
> <
https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_uptane_uptane-2Dstandard_issues_116-3Femail-5Fsource-3Dnotifications-26email-5Ftoken-3DADPGUX2GWDK6NA6QE3LYR43P3JLFLA5CNFSM4HZLHDC2YY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4G2ODFNQ&d=DwMCaQ&c=slrrB7dE8n7gBJbeO0g-IQ&r=hgBKIqNYIOwzXeBjPUaKRw&m=_fT1MYahIULTCX59lsY6S-da5gorspo4Q7Uk-2G_lYI&s=5ebYubeRdGjkohO2-PBwd65hfHY0UC_aT993FJVC9eg&e=
>,
> or mute the thread
> <
https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_notifications_unsubscribe-2Dauth_ADPGUXZQAIA5YVF7Q5QHLL3P3JLFLANCNFSM4HZLHDCQ&d=DwMCaQ&c=slrrB7dE8n7gBJbeO0g-IQ&r=hgBKIqNYIOwzXeBjPUaKRw&m=_fT1MYahIULTCX59lsY6S-da5gorspo4Q7Uk-2G_lYI&s=4ibfStrGfX4SUS5pCBWexYVTFbXD-Oc5p6uSt14i_SU&e=
>
> .
>
—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub
<#116?email_source=notifications&email_token=AE33UO6RXF5UQZM5CWTBZPLP3JL3VA5CNFSM4HZLHDC2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODYCMQWY#issuecomment-503629915>,
or mute the thread
<https://github.com/notifications/unsubscribe-auth/AE33UO3NGGGJHYXYMLZ2SELP3JL3VANCNFSM4HZLHDCQ>
.
|
|
If we are agreed that Image, Target and Director should always be capitalized, I can probably do a pass early this week and correct all these. Should I change Primary and Secondary as well, as per Ira's suggestion? |
|
Hi,
Rationale: Primary and Secondary are the client ends (Secondary indirectly
via Primary) of all transactions with the Director and Image Repository (who
are the server ends). Therefore they should be titlecase (first letter
capped).
Cheers,
- Ira
Ira McDonald (Musician / Software Architect)
Co-Chair - TCG Trusted Mobility Solutions WG
Co-Chair - TCG Metadata Access Protocol SG
Chair - Linux Foundation Open Printing WG
Secretary - IEEE-ISTO Printer Working Group
Co-Chair - IEEE-ISTO PWG Internet Printing Protocol WG
IETF Designated Expert - IPP & Printer MIB
Blue Roof Music / High North Inc
http://sites.google.com/site/blueroofmusic
http://sites.google.com/site/highnorthinc
mailto: blueroofmusic@gmail.com
PO Box 221 Grand Marais, MI 49839 906-494-2434
…On Mon, Jun 24, 2019 at 11:38 AM Lois Anne DeLong ***@***.***> wrote:
If we are agreed that Image, Target and Director should always be
capitalized, I can probably do a pass early this week and correct all
these. Should I change Primary and Secondary as well, as per Ira's
suggestion?
—
You are receiving this because you commented.
Reply to this email directly, view it on GitHub
<#116?email_source=notifications&email_token=AE33UO5UXJWGT27USD2FRR3P4DS7DA5CNFSM4HZLHDC2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODYNKYAA#issuecomment-505064448>,
or mute the thread
<https://github.com/notifications/unsubscribe-auth/AE33UOZWWAU3MDP3TSSDJDDP4DS7DANCNFSM4HZLHDCQ>
.
|
|
Fine. I'll take care of this. Lois |
jhdalek55
added a commit
to jhdalek55/uptane-standard
that referenced
this issue
Jul 2, 2019
I've now gone through and have made sure instances of proper names for roles, ECUs, and metadata are capitalized. I also fixed some inconsistent capitalization in headings and subheads. Now only the first word in headings is capitalized, except where proper nouns appear. This addresses Issue uptane#116. I also addressed the one element in Issue uptane#119. That is I've included the missing definition of "metadata." For this, I followed Ira's suggestion and included both the NIST definition and the version proposed by @mcvand in discussion on the issue. I also added definitions for three acronyms used in the document that were never defined. Lastly I fixed a handful of sentences that to my eye had structural. I was going to add the citations to our definitions at the beginning of the document, per @iramcdonald. But I don't know how to set up the citations in Markdown using this particular format. If someone can let me know how, I can take care of that, but probably not until early next week. If another team member could step in and do this, I would likely be faster.
|
PR#125 takes care of this concern. |
tkfu
pushed a commit
that referenced
this issue
Jul 3, 2019
* Addressing Issue #116 and one item in issue #119 I've now gone through and have made sure instances of proper names for roles, ECUs, and metadata are capitalized. I also fixed some inconsistent capitalization in headings and subheads. Now only the first word in headings is capitalized, except where proper nouns appear. This addresses Issue #116. I also addressed the one element in Issue #119. That is I've included the missing definition of "metadata." For this, I followed Ira's suggestion and included both the NIST definition and the version proposed by @mcvand in discussion on the issue. I also added definitions for three acronyms used in the document that were never defined. Lastly I fixed a handful of sentences that to my eye had structural. I was going to add the citations to our definitions at the beginning of the document, per @iramcdonald. But I don't know how to set up the citations in Markdown using this particular format. If someone can let me know how, I can take care of that, but probably not until early next week. If another team member could step in and do this, I would likely be faster. * Addition changes per Jon Oster's comments Hopefully this meets the request changes.
|
This issue can now be closed via PR#125. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
It seems to be about 50/50 that we capitalize "Image" "Director", and "Target" when talking about the repositories. We should make a decision one way or another and make the document consistent.
The text was updated successfully, but these errors were encountered: