Skip to content

Commit a0db38a

Browse files
kschuethsspier
authored andcommitted
Create COMMUNICATION-template.md (InnerSourceCommons#557)
Create COMMUNICATION-template.md - Creating template so I have link to add to the base documentation pattern when I add the template to it. --------- Co-authored-by: Sebastian Spier <github@spier.hu>
1 parent 03e3366 commit a0db38a

File tree

1 file changed

+73
-0
lines changed

1 file changed

+73
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# COMMUNICATION.md
2+
3+
***
4+
Put an individual COMMUNICATION.md file tailored to the project in each repo. If project repo ownership is transferred to a different team in the future, they need to be able to access and edit documentation related to the project. This includes documentation that outlines the communication processes that users should use to contact the team.
5+
6+
**Delete top paragraph when this section is filled out.**
7+
8+
## Team Communication
9+
10+
Team Slack channel:
11+
12+
Special Slack Channels: (topic specific and accessible to anyone who would be an external contributor)
13+
14+
Team Email:
15+
16+
## How to Contact Us
17+
18+
The following types of actions can be moved to the appropriate section and more added.
19+
20+
| Action | (General team contact) |
21+
|--------------------------------|--------------------------|
22+
| Contact Method | (email or slack channel) |
23+
| Bug report | |
24+
| Feature request | |
25+
| Contribution process questions | |
26+
| Merge Requests after submission | |
27+
| Add more here… | |
28+
29+
| Special Situations: | Direct point of contact (Role) |
30+
|---------------------|--------------------------------|
31+
| Status updates | |
32+
| other | |
33+
| other | |
34+
| Add more here... | |
35+
36+
## Roles and Responsibilities
37+
38+
Managers or roles and specific situations they should be contacted for outside the team channel.
39+
40+
(this is set up this way so that the document can easily be changed if there are new members on the team)
41+
42+
| Role | Name | Preferred contact method |
43+
|------|------|--------------------------|
44+
| | | |
45+
| | | |
46+
| | | |
47+
48+
## Outbound Communication
49+
50+
| Scenarios | When users will receive communication | Stakeholders who will receive | Action - how to receive these communications |
51+
|-----------------------------------------------------------------------------------|--------|----------------|----------|
52+
| Breaking changes (for e.g. any changes to our API or messaging contracts) | | | |
53+
| Extended/planned outages (service downtime for maintenance related activities) | | | |
54+
| Unexpected Outages | | | |
55+
| Traffic specific changes (e.g. team to team, etc.) | | | |
56+
| New Feature rollout | | | |
57+
| As per product guidelines | | | |
58+
| Month end and company wide code freeze | | | |
59+
| Internal team and any other teams who contribute to team project repos | | | |
60+
| Add more… | | | |
61+
62+
## Documentation Contacts
63+
64+
Tell how to find the owner, responsible party, or group people should contact if they have questions about documentation in the repo.
65+
66+
Describe this communication process.
67+
68+
For example:
69+
70+
* If you have questions on a specific piece of documentation, you can find the team member responsible for the information by looking here:
71+
* You can contact the responsible party by sending a message in the xyz channel, send them a direct message in chat, email, etc. The individual who last certified the documentation is the responsible party.
72+
73+
***

0 commit comments

Comments
 (0)