Skip to content

Commit 5bcf14f

Browse files
authored
Merge pull request #179 from spier/InnerSource-spelling
Explanation of the InnerSource spelling
2 parents 9b8b141 + a6c26f6 commit 5bcf14f

File tree

2 files changed

+45
-0
lines changed

2 files changed

+45
-0
lines changed

meta/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,3 +11,5 @@ The topics below cover information about how we define, operate, and upkeep this
1111
* [Contributing](../CONTRIBUTING.md) - How to interact with our group, create your own patterns, or take part in our review-process; Github / Web centric instructions
1212
* [Alternate Command-line steps](./technical-git-howto.md) - If you want to contribute a pattern using `git` from the command-line, this is your document
1313
* [Meetings](./meetings.md) - Become involved with the people and communications of the Inner Source Patterns group
14+
* **(incomplete) Writing Guidelines** - To make the writing for our patterns more consistent, we provide some guidelines to help the various authors to keep a consistent voice.
15+
* [InnerSource Spelling](./innersource-spelling.md) - Clarifies the mystery around how to spell this. Spoiler: It is **InnerSource**.

meta/innersource-spelling.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# InnerSource Spelling
2+
3+
We recommend the spelling **InnerSource**.
4+
5+
We encourage you to use the word as a proper noun (like “We use InnerSource in that repo”) wherever possible. We discourage the use of verb forms of the word (like “We’re inner-sourcing that repo”).
6+
7+
## Full story - Why we care about the spelling
8+
9+
**InnerSource** is an artificial term that does necessarily have a spelling that would naturally be correct. Therefore you will find various spellings when you search for the term online.
10+
11+
We favor the spelling **InnerSource**, for the following reasons:
12+
13+
1. That’s the way Tim O’Reilly [spelled it in 2000][opengl_1200] (he was into Perl and camel-case was a thing). Also see the [Foreword of the Adopting InnerSource book](foreword_AdoptingInnerSource) for more of Tim O’Reilly's own words on the topic.
14+
2. If you set up side-by-side Google searches for “Inner Source” and “InnerSource” you will find that you get more hits on the former term, by only 1% of them have anything to do with what we call InnerSource. The latter term will be 100% cogent to your inquiry.
15+
3. The OSI was [denied trademark on the term “open source”][no-open-source-trademark] because it was made up of two common and unrelated terms. “InnerSource” on the other hand is a new word.
16+
17+
## But the spelling isn't even consistent in the InnerSource Patterns repo!
18+
19+
You are right, it isn't consistent. Not yet! But we are getting there. :)
20+
21+
The reason you see multiple spellings in our documentation is that it was built over a period of years during which our thinking on the spelling crystallized.
22+
23+
For new patterns we stick to the spelling **InnerSource**. Old patterns will be reworked over time to use this spelling as well.
24+
25+
## It can be hard to use the term "InnerSource" in a sentence
26+
27+
Some people have had a hard time with the camel-case term **InnerSource** because they’re not sure how to use it in a sentence grammatically.
28+
29+
We recommend not to turn the term into a verb, but rather using it as a noun our adjective.
30+
31+
Recommended use:
32+
33+
“We use InnerSource in that repo”
34+
or
35+
“We use InnerSource methods in that repo”
36+
37+
Not so good:
38+
39+
“We’re InnerSourcing that repo”
40+
41+
[opengl_1200]: https://web.archive.org/web/20180411080939/http://archive.oreilly.com/pub/a/oreilly/ask_tim/2000/opengl_1200.html
42+
[foreword_AdoptingInnerSource]: https://innersourcecommons.org/assets/files/AdoptingInnerSource.pdf
43+
[no-open-source-trademark]: https://opensource.org/pressreleases/certified-open-source.php

0 commit comments

Comments
 (0)