1
- # Title
1
+ ## Title
2
2
3
3
Communication tooling
4
4
5
- # Patlet
5
+ ## Patlet
6
6
7
7
An InnerSource project is being used outside the original development team but
8
8
users are having trouble getting help and getting in touch with the project
9
9
team. The idea is to setup and document standard communication tooling that
10
10
allows for discussions to become visible, archived and searchable.
11
11
12
- # Context
12
+ ## Context
13
13
14
14
A team depends on another team's component. It would like to make contributions
15
15
to that component. Even when it happens in writing, communication happens in a
16
16
1-on-1 fashion.
17
17
18
- # Problem
18
+ ## Problem
19
19
20
20
A team is open to receiving contributions from downstream users of their
21
21
component. Coordination and communication happens in an ad-hoc fashion though
22
22
leading to incoherent information being shared, delays in answers received,
23
23
contributors pinging multiple host team members before receiving a definitive
24
24
answer.
25
25
26
- # Forces
26
+ ## Forces
27
27
28
28
- The host team is interested in receiving contributions and willing to mentor
29
29
contributors.
@@ -32,7 +32,7 @@ answer.
32
32
- Communication channels may be aligned with specific groups that should be
33
33
reached but not by communication purpose.
34
34
35
- # Solution
35
+ ## Solution
36
36
37
37
The host team needs to be clear on the benefit of providing company-public,
38
38
archived, searchable, linkable communication channels that are free to subscribe
@@ -63,7 +63,7 @@ All communication channels should be documented in the project README.md The
63
63
host team members need to make an effort to direct questions that they receive
64
64
personally back to official communication channels.
65
65
66
- # Resulting Context
66
+ ## Resulting Context
67
67
68
68
Setting up and consistently using official asynchronous communication channels
69
69
helps create a base level of passive documentation that can be referenced again
@@ -88,15 +88,15 @@ users with the same question see (or later on find) the previous answer leading
88
88
to a lower need to repeat explanations.
89
89
90
90
91
- # Known Instances
91
+ ## Known Instances
92
92
93
93
Europace AG, Paypal Inc.
94
94
95
- # Authors
95
+ ## Authors
96
96
97
97
Isabel Drost-Fromm
98
98
99
- # Status
99
+ ## Status
100
100
101
101
Structured.
102
102
0 commit comments