-
Notifications
You must be signed in to change notification settings - Fork 169
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
open source - no dash #508
Comments
When a two-word phrase forms an adjective, both AP and Chicago recommend hyphenating. Thus, "an open-source product" vs. "the product is open source". |
I have always followed what @creachadair said. Is there some reason why you prefer "open source", @aileenrose? My primary argument for hyphenating multi-word phrases when used as adjectives is to make it easier for non-native readers of English (https://about.sourcegraph.com/handbook/communication/style_guide#clarity) to parse the phrase boundaries in our sentences. Also, if we standardize on "open source" (no hyphens), then we would need to change a lot of other things, right? Such as (from some of our recent blog posts):
In all of those cases above, we use hyphens. I believe hyphens improve clarity in all these cases, and the fact that we've use hyphens in cases like these suggests it will be difficult to (re)train everyone to not use hyphens. |
I think the key point is adopting a style. Since we use serial commas, should we respect Chicago style? Here's a table of hyphen usage: In other web discussions, I also found that there is a 'popular' adoption of non-hyphen open source. But if we really want to respect the OSI, then there's no hyphen. cc @adamfrankl2015 @vanesa @ryan-blunden wdyt? |
Adopting a style makes sense. The only caution I would advise is against trying to mix styles: Each org tends to have its own pattern of style conventions and exceptions that deviate from the base style. Combining them almost always introduces inconsistencies. I think the most important role of style is to promote clarity for the reader, and we should choose rules based on that. Second to that, style should be reasonably self-consistent. Being consistent with other style guides (outside whatever we use as our base) is not that valuable (IMO) unless there is a preponderance of consensus. To ensure we stick to our own rules, I find it's helpful if the rules we choose are fairly intuitive to remember as well. (I am not the decider here; these are only my opinions as someone who cares a lot about language) |
I prefer data
<https://trends.google.com/trends/explore?geo=US&q=%22open%20source%22,open-source>
.
adam
…On Tue, Feb 18, 2020 at 11:25 AM M. J. Fromberger ***@***.***> wrote:
Adopting a style makes sense. The only caution I would advise is against
trying to mix styles: Each org tends to have its own pattern of style
conventions and exceptions that deviate from the base style. Combining them
almost always introduces inconsistencies.
I think the most important role of style is to promote clarity for the
reader, and we should choose rules based on that. Second to that, style
should be reasonably self-consistent. Being consistent with *other* style
guides (outside whatever we use as our base) is *not* that valuable (IMO)
unless there is a preponderance of consensus.
To ensure we stick to our own rules, I find it's helpful if the rules we
choose are fairly intuitive to remember as well.
(I am not the decider here; these are only my opinions as someone who
cares a lot about language)
—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
<#508?email_source=notifications&email_token=AC4DVI5MSVM4LALGUSA33YLRDQY25A5CNFSM4KH3PHB2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEMDZ5LA#issuecomment-587701932>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AC4DVI7I4TN3EMKJDM5Y3CDRDQY25ANCNFSM4KH3PHBQ>
.
--
Adam Frankl <http://www.linkedin.com/in/adamfrankl>
Schedule a call: calendly.com/adam-frankl
|
Thanks for the Trend data. Putting aside the style, I vote for aligning with the stewards of open source, this includes the Linux Foundation. |
It really seems like "open source" is an exception to the general rule, which is strange. For example, from https://www.linuxfoundation.org/about/: But it does seem that's most common, so that's fine with me (I mean, it will be painful, but I will get used to it 😄). Separately, do you agree all the bullet examples in #508 (comment) should have hyphens? Anyway, just document what the rule is in our style guide (and if "open source" is an exception to the general rule). |
This rule has been documented in #584. |
No description provided.
The text was updated successfully, but these errors were encountered: