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
This is a list of frequently asked questions about InnerSource Patterns
1
+
# InnerSource Patterns FAQ
2
+
3
+
This is a list of frequently asked questions about InnerSource Patterns.
2
4
3
5
## What are the different parts of a pattern? What do they mean?
4
6
5
-
* See the [pattern template](pattern-template.md) (in the *meta* subdirectory)
7
+
* See the [pattern template](pattern-template.md)
6
8
7
9
## Why use a patterns approach to InnerSource?
8
10
@@ -13,6 +15,7 @@ This is a list of frequently asked questions about InnerSource Patterns
13
15
* 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.
14
16
* Patterns can also be used as a short-hand when discussing InnerSource programs across organizational boundaries.
15
17
16
-
## I'd like to consult with the IS Patterns community; do I need to have participating members sign NDAs?
18
+
## I'd like to consult with the InnerSource Patterns community; do I need to have participating members sign NDAs?
17
19
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.
20
+
* The vast majority of InnerSource Patterns meetings and all conversations in the InnerSource Commons [Slack](https://isc-inviter.herokuapp.com/) are held under the [Chatham House Rule](https://www.chathamhouse.org/chatham-house-rule) that should provide sufficient protection to enable a productive discussion.
21
+
* To answer the question directly: No, you don't have to get NDAs signed :)
Copy file name to clipboardExpand all lines: meta/README.md
+8-5Lines changed: 8 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,13 +2,16 @@
2
2
3
3
The topics below cover information about how we define, operate, and upkeep this collection of patterns.
4
4
5
-
*[Pattern Template](./pattern-template.md) - Start a new pattern with a copy of this
5
+
*[Contributing](../CONTRIBUTING.md) - How to interact with our group, create your own patterns, or take part in our review-process; GitHub / Web centric instructions
6
+
*[Alternate Command-line steps](./technical-git-howto.md) - Contribute a pattern using `git` from the command-line
6
7
*[Contributor Handbook](./contributor-handbook.md) - Lays out a basic guideline of how to write and contribute a new pattern, including the 3 maturity levels for patterns.
7
-
***(draft)**[Pattern System](./pattern-system.md) - For a human reader it is not easy to digest a long list of patterns. We are working on labeling and classifying the patterns further.
8
+
*[Pattern Template](./pattern-template.md) - Start a new pattern with a copy of this
9
+
*[FAQ](./FAQ.md) - Frequently asked questions about InnerSource Patterns
8
10
*[Trusted Committers](../TRUSTED-COMMITTERS.md) - Who these people are, what elevated rights they get, and how you can become one
9
11
*[Markdown Info](./markdown-info.md) - Markdown is the ascii text format our patterns are written in; this document briefly defines how we use it
10
-
*[Contributing](../CONTRIBUTING.md) - How to interact with our group, create your own patterns, or take part in our review-process; Github / Web centric instructions
11
-
*[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
12
+
13
+
## Unfinished documentation
14
+
12
15
***(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.
13
16
*[InnerSource Spelling](./innersource-spelling.md) - Clarifies the mystery around how to spell this. Spoiler: It is **InnerSource**.
14
-
*[FAQ](./FAQ.md) - Frequently asked questions about InnerSource Patterns
17
+
***(draft)**[Pattern System](./pattern-system.md) - For a human reader it is not easy to digest a long list of patterns. We are working on labeling and classifying the patterns further.
Copy file name to clipboardExpand all lines: meta/technical-git-howto.md
+18-11Lines changed: 18 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,16 +1,19 @@
1
1
# Command-line git steps for creating a new Pattern
2
2
3
-
If you want to contribute a new pattern, the workflow is done through Branches and Pull Requests (PR's). You can see the available branches on [the branches URL](https://github.com/InnerSourceCommons/InnerSourcePatterns/branches/all) and existing PR's on the [Pull Request page](https://github.com/InnerSourceCommons/InnerSourcePatterns/pulls). Branches are meant to separate content, so that multiple people can work all at once. Pull Requests (PR's) are used to bring discussion/review about a specific inner source pattern.
3
+
If you want to contribute a new pattern, the workflow is support by these important concepts:
4
4
5
-
There are indeed multiple ways to start a discussion:
5
+
*[Branches](https://github.com/InnerSourceCommons/InnerSourcePatterns/branches/all) are meant to separate content, so that multiple people can work all at once.
6
+
*[Pull Requests](https://github.com/InnerSourceCommons/InnerSourcePatterns/pulls) (PR's) are used for discussion/review of a specific InnerSource pattern.
6
7
7
-
* Send a Pull Request for your branch and the maintainers will receive a notification.
8
-
* Create an Issue and ask for comments from some of the maintainers. You can mention them using the '@' symbol prior to their github nickname.
9
-
* Add reviewers to the Pull Request on the website - this sends requests to review your work
8
+
There are multiple ways to start a discussion:
10
9
11
-
New patterns should use, as their base, the [pattern template file](pattern-template.md).
10
+
* Fork the repo, create a branch, and then send a Pull Request for your branch. The maintainers will receive a notification about this automatically.
11
+
* Create an [Issue](https://github.com/InnerSourceCommons/InnerSourcePatterns/issues) and ask for comments from some of the [Trusted Committers](../TRUSTED-COMMITTERS.md). You can mention them using the '@' symbol prior to their GitHub username.
12
+
* Add reviewers to your Pull Request in GitHub - this sends requests to review your work
12
13
13
-
Please, when starting a new pattern, make sure that it does not already exist. Take a look at some of the [existing patterns in this repository](/README.md#reviewed-patterns-proven-and-reviewed).
14
+
New patterns should use the [pattern template file](pattern-template.md) as their starting point.
15
+
16
+
When starting a new pattern, make sure that it does not already exist. Take a look at the [existing patterns in this repository](/README.md#list-of-patterns).
14
17
15
18
## Overview of steps
16
19
@@ -20,10 +23,14 @@ The basic steps below can be thought of as *branch*, *commit*, *pull request*, a
20
23
21
24
## How do you create a branch?
22
25
23
-
First you need to create a branch (no need to ask for permission!). For this, let's clone the repository:
26
+
First you need to create a branch (no need to ask for permission!).
27
+
28
+
For this, [create a fork](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo#fork-an-example-repository) of this repository.
29
+
30
+
Then create a [local clone of your fork](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo#step-2-create-a-local-clone-of-your-fork).
0 commit comments