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
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
-4Lines changed: 0 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,6 @@ The goal of the InnerSource patterns working group is to collect, document, and
4
4
5
5
For this working group to strive, we welcome your contribution - be it small or huge.
6
6
7
-
8
7
## How to Contribute?
9
8
10
9
Please consider contributing in the following ways:
@@ -19,7 +18,6 @@ Please consider contributing in the following ways:
19
18
20
19
5.**Be a patterns advocate.** The patterns will become better and cover more topics the more people contribute their perspective and experience. A colleague told you about a novel InnerSource best practice? Please invite her/him to contribute to this repository!
21
20
22
-
23
21
## How to get in touch?
24
22
25
23
We are happy to support you in contributing to the InnerSource patterns or to just chat with you. You can reach out to us in the following ways:
@@ -28,12 +26,10 @@ We are happy to support you in contributing to the InnerSource patterns or to ju
28
26
29
27
2.**During the patterns office hours.** We established a regular cadence of office hours for you to ask questions. Find the date of the next patterns office hours [in this calendar](https://innersourcecommons.org/patterns-officehours).
30
28
31
-
32
29
## License of Contributions
33
30
34
31
The contents of this repository are licensed under [CC-BY-SA-4.0](LICENSE.txt). By contributing to this repository, you grant us (and everyone else for that matter) the right to use your contribution in accordance with that license.
35
32
36
-
37
33
## Code of Conduct
38
34
39
35
We do not yet have a fully formalized code of conduct yet. We expect all contributors to treat each other respectfully and help us to keep this community free of harassment and discrimination.
This is a list of frequently asked questions about InnerSource Patterns
2
2
3
3
## What are the different parts of a pattern? What do they mean?
4
+
4
5
* See the [pattern template](pattern-template.md) (in the *meta* subdirectory)
5
6
6
7
## Why use a patterns approach to InnerSource?
8
+
7
9
* It abstracts information from known instances of proven solutions so that other people/companies can understand not only what was done by why it worked and how to adapt it to their own situations.
8
10
9
11
## How do you use the pattern?
12
+
10
13
* Each organization has its own history (*context*) and culture (a source of *forces*) and even goals, so using a pattern to solve their problems will generally require adaptation of that pattern. Try to identify things about your situation that are unique and apply those as makes sense to the *Context* and *Forces* identified in the pattern. See if these additional constraints might require changes to the *Solution* to ensure that the pattern will work.
11
14
* Patterns can also be used as a short-hand when discussing InnerSource programs across organizational boundaries.
12
15
13
16
## I'd like to consult with the IS Patterns community; do I need to have participating members sign NDAs?
17
+
14
18
* You could do that, but be aware that the vast majority of IS Patterns meetings are held under the [Chatham House Rule](https://www.chathamhouse.org/chatham-house-rule) that should provide sufficient protection to enable a productive discussion.
Copy file name to clipboardExpand all lines: meta/boardreports/2020-10.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,9 +15,9 @@
15
15
## Project Activity - Describe the overall activity in the project over the past quarter.
16
16
17
17
- New process proposal by @maxcapraro, discussion (@spier@mainec@newmexicokid@lenucksi) and successful adoption (initial, structured, validated, goal: faster first contribution, see contributor handbook)
18
-
- Processing of existing content from wiki and existing PRs into publishable repo content, large scale cleanup, migration and fixing, all ongoing for the foreseeable future.
18
+
- Processing of existing content from wiki and existing PRs into publishable repo content, large scale cleanup, migration and fixing, all ongoing for the foreseeable future.
19
19
- Great work towards content rendering (e.g. website, initial PDFs) in progress @spier@dizquerdo (https://innersourcecommons.gitbook.io/innersource-patterns-staging/v/book/)
20
-
- Conference activity, more, interesting pattern activity on Slack leading to new patterns
20
+
- Conference activity, more, interesting pattern activity on Slack leading to new patterns
21
21
- Patterns office-hours concept try out, some success, dual time-zone meeting concept successfully in use in marketing wg
Copy file name to clipboardExpand all lines: meta/boardreports/2020-11.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@
17
17
18
18
- 1 new contributor in the reporting period (@WillemJiang)
19
19
- Challenges:
20
-
- PRs with minor changes stay open for extended periods. This prevents quick incremental quality improvements. This might also demotivate contributors, as giving them a sense of success would be a way to keep them engaged in the project. Examples: [#213](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/213), [#222](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/222), [#230](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/230), [#232](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/232)
20
+
- PRs with minor changes stay open for extended periods. This prevents quick incremental quality improvements. This might also demotivate contributors, as giving them a sense of success would be a way to keep them engaged in the project. Examples: [#213](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/213), [#222](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/222), [#230](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/230), [#232](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/232)
21
21
- Also the longer a PR stays open, the higher the chances that that PR will go stale i.e. the author does not have time anymore to see the PR through. Examples of said risk are [13 PRs](https://github.com/InnerSourceCommons/InnerSourcePatterns/pulls?q=is%3Apr+is%3Aopen+created%3A%3C2020) that have been created prior to 2020, many even in 2017. Bringing these PRs to a stage where they can either be discontinued (i.e. closed) or approved+merged has proven difficult.
22
22
- Activity and trusted committer diversity is too low to sustain the project in the long run on a high activity level. (Low activity evolution is sustainable.)
Copy file name to clipboardExpand all lines: meta/boardreports/2020-12.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@
17
17
18
18
- 2 new and new-ish contributors in the reporting period ([@WillemJiang](https://github.com/WillemJiang), [@MelindaMalmgren](https://github.com/MelindaMalmgren))
19
19
- Challenges: (same as in the [last report](https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/master/meta/boardreports/2020-11.md#projectcommunity-status-and-health))
20
-
- PRs with minor changes stay open for extended periods. This prevents quick incremental quality improvements. This might also demotivate contributors, as giving them a sense of success would be a way to keep them engaged in the project. Examples: [#213](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/213), [#222](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/222), [#230](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/230), [#232](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/232)
20
+
- PRs with minor changes stay open for extended periods. This prevents quick incremental quality improvements. This might also demotivate contributors, as giving them a sense of success would be a way to keep them engaged in the project. Examples: [#213](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/213), [#222](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/222), [#230](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/230), [#232](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/232)
21
21
- Also the longer a PR stays open, the higher the chances that that PR will go stale i.e. the author does not have time anymore to see the PR through. Examples of said risk are [13 PRs](https://github.com/InnerSourceCommons/InnerSourcePatterns/pulls?q=is%3Apr+is%3Aopen+created%3A%3C2020) that have been created prior to 2020, many even in 2017. Bringing these PRs to a stage where they can either be discontinued (i.e. closed) or approved+merged has proven difficult.
22
22
- Activity and trusted committer diversity is too low to sustain the project in the long run on a high activity level. (Low activity evolution is sustainable.)
Copy file name to clipboardExpand all lines: meta/contributor-handbook.md
+6-9Lines changed: 6 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,39 +14,36 @@ We have defined three maturity levels for patterns: The higher a pattern's matur
14
14
| 2 | Structured | Contains a complete pattern that it is not properly validated yet (e.g. because it only synthesizes an idea or the experiences from one instead of three organizations). | A few days / weeks |
15
15
| 3 | Validated | The pattern is validated (e.g. because three or more instances exists and are synthesized by the pattern) and its writing is of high quality. | A few months |
16
16
17
-
For the first pattern you contribute, you should aim for maturity levels `1: Initial` or `2: Structured`.
17
+
For the first pattern you contribute, you should aim for maturity levels `1: Initial` or `2: Structured`.
18
18
19
19
If you want to help promoting a pattern one maturity level up, we suggest to first create an issue to discuss the matter and see if someone else is working on that already. After that, you can create a pull request with the necessary changes.
20
20
21
21
To achieve a given maturity level a pattern has to satisfy the requirements for that given maturity level and lower levels. The following sections lay out the requirements per maturity level in detail.
22
22
23
-
24
23
### Requirements: Level 1 - Initial
25
24
26
25
Patterns (or other documents) of level 1 are stored in the directory `/patterns/1-initial`.
27
26
28
27
- Validation requirements:
29
28
- N/A
30
-
29
+
31
30
- Content requirements:
32
31
- The document is readible & comprehensible for other parties (not just for the author(s))
33
32
- The author(s) contribute the contents according to the [license](../LICENSE.txt) & are allowed to do so
34
33
- Thoughts and contents by third parties are quoted / referenced explicitly
35
34
36
-
37
35
### Requirements: Level 2 - Structured
38
36
39
37
Patterns of level 2 are stored in the directory `/patterns/2-structured`.
40
38
41
39
- Validation requirements:
42
-
- Is validated by at least one known instance
40
+
- Is validated by at least one known instance
43
41
- Alternatively: key elements of the pattern have been validated in separate contexts and, in consequence, it is justified to believe the full solution will function
44
-
42
+
45
43
- Content requirements:
46
44
- Complies with the [patterns format](pattern-template.md)
47
45
- Complies with *basic style guide*(#) - *Oops! We have not yet developed this*
48
-
49
-
46
+
50
47
### Requirements: Level 3 - Validated
51
48
52
49
Patterns of level 3 are stored in the directory `/patterns/3-validated`.
@@ -55,7 +52,7 @@ Patterns of level 3 are stored in the directory `/patterns/3-validated`.
55
52
- Is validated by at least three known instances
56
53
- Considers all known instances to the best of working group members' knowledge
57
54
- Community agreement (via lazy consensus of trusted committers) on correctness of contents
58
-
55
+
59
56
- Content requirements:
60
57
- Uses & has no conflicts with working group terminology (defined by glossary / implicit usage) - *Oops! We have not yet developed this.*
61
58
- Fits & has no conflicts with existing patterns (of this maturity level or higher)
Copy file name to clipboardExpand all lines: meta/innersource-spelling.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ We encourage you to use the word as a proper noun (like “We use InnerSource in
10
10
11
11
We favor the spelling **InnerSource**, for the following reasons:
12
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.
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
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
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.
0 commit comments