You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@tomwhite suggested at dask/dask#8750 (comment) that we should capitalize RFC 2119 words like "SHOULD" in the spec to make it clearer that we are following the RFC.
Another option might be to bold the words instead of capitalizing them.
I think the option of using bold text should suffice. While all-caps is a common convention, it does add a fair amount of visual noise. I think encoding RFC terms using bold text is something we can address in the current draft specification and then continue to enforce moving forward. For prior revisions, we can leave as is.
Activity
kgryte commentedon Apr 4, 2024
I think the option of using bold text should suffice. While all-caps is a common convention, it does add a fair amount of visual noise. I think encoding RFC terms using bold text is something we can address in the current draft specification and then continue to enforce moving forward. For prior revisions, we can leave as is.
rgommers commentedon Apr 4, 2024
That seems like a reasonable option. I'd prefer to avoid capitalized words yell at me:)
asmeurer commentedon Apr 4, 2024
An idea to automatically bold those words (I haven't tested it). https://chat.openai.com/share/7467ec88-0d8f-4352-9a5b-5b43fe6b8f02
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
5 remaining items
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: highlight RFC 2119 keywords in data type functions
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: move notes below the fold and highlight RFC 2119 keywords
docs: highlight RFC 2119 keywords in data type functions