From d791a65fcb4ed0c2a44d65b5880b7ff3d3e9cb52 Mon Sep 17 00:00:00 2001 From: Bryan Behrenshausen Date: Mon, 19 Aug 2024 16:42:59 -0400 Subject: [PATCH 1/6] Update Praise Participants pattern --- patterns/2-structured/praise-participants.md | 50 ++++++++++---------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/patterns/2-structured/praise-participants.md b/patterns/2-structured/praise-participants.md index 139473223..c66e1e86e 100644 --- a/patterns/2-structured/praise-participants.md +++ b/patterns/2-structured/praise-participants.md @@ -4,59 +4,60 @@ Praise Participants ## Patlet -After an inner source contribution, it's important to thank the contributor for their time and effort. -This pattern gives guidance that not only effectively acknowledges the contribution but also engenders further engagement from the contributor and others. +When you receive an InnerSource contribution, it's important to thank the contributor for their time and effort. +Extending your gratiutude not only effectively acknowledges the contribution but also engenders further engagement from the contributor and others. +Praising contributors' positive contributions to your InnerSource project motivates those contributors (and their managers) to continue investing in the effort. ## Problem -How can we properly express our gratitude to a contributor for their inner source contribution to a project? -It can be easy to forget to do so or not know the words or medium to use for adequate effect and sincerity. -Praise and thanks are easy, affordable ways to keep contributors and their managers motivated and excited to continue. -A pattern in this area makes it easy to do and ensures that the message comes across clearly and sincerely. +How can we properly express our gratitude to a contributor for their InnerSource contribution to a project? +We may not know precisely which words or communication channels we should use to express ourselves sincerely. +Effective praise for participants follows a pattern, and following this pattern helps ensure that our messages of thanks come across clearly and graciously. +It also makes us less likely to forget to praise our contributors, which is unfortunately too easy to do. ## Context -* You are the [Trusted Committer](./trusted-committer.md) or maintainer on an inner source project. +* You are the [Trusted Committer](./trusted-committer.md) or maintainer on an InnerSource project. * You value the community of contributors and want to maintain and grow it. ## Forces -* You are busy, which makes it easy to forget some soft touches like praise and thanks. +* You are busy, forgetting some soft touches (like praise and thanks) easier. * You may not be someone that is comfortable in social situations or good with words. * Peer recognition is very important to job satisfaction and career development. ## Solutions -It feels good to anyone to be recognized by others. -In a professional setting, increased recognition is also an avenue to increased influence and growth. -Any time someone gives to your inner source project, recognize them with a sincere and qualified "thank you". +Being recognized by others feels good. +And in a professional setting, recognition from peers can also increase your organizational influence and career growth. +Any time someone contributes to your InnerSource project, recognize them with an authentic sincere "thank you." -For non-trivial contributions (all code contributions and significant time contributions), say thank you via the following mechanisms: +For non-trivial contributions (all code contributions and significant time contributions), say "thank you" via the following mechanisms: -(1) Call out the person by name in any chat location (e.g. _Slack_) where you organize your project activity. Let everyone know what they did and thank them publicly. - -Example: +(1) Call out the person by name in any chat location (e.g. _Slack_) where you organize your project activity. +Let everyone know what they did and thank them publicly. +For example: > Everyone @here give a high-five to @andrew.clegg for updating the _rcs-viewer_ to the latest version of the _hebo-client_ (https://github.com/rcs/rcs-viewer/pull/81). -Thanks for helping keep this library up-to-date, Andy! +> Thanks for helping keep this library up-to-date, Andy! -(2) Email them and their manager (cc'd) privately thanking them for the contribution. -For code contributions often-times you can just forward the merge notification mail. +(2) Email them and their manager (cc'd) privately, thanking them for the contribution. +For code contributions, consider forwarding the merge notification mail. Example: > Hi, Andy, I want to thank you again for making this update. -It may have been a small amount of time, but it's attention like this from each person that make the RCS project work for all of us. -Thanks for solving your own problem in a way that also makes the _rcs-viewer_ better for everyone. +> It may have been a small amount of time, but it's attention like this from each person that make the RCS project work for all of us. +> Thanks for solving your own problem in a way that also makes the _rcs-viewer_ better for everyone. ## Resulting Context -Feedback like this leaves the contributor with a fantastic feeling and ready to come back for more. +Feedback like this leaves the contributor with a fantastic feeling and ready to re-engage in the project. Combining **both** forms of thanks gives them recognition in front of their peers (breadth) and in front of their direct manager (depth). There's a subtle encouragement for those peers in chat to consider contributing themselves and for that manager to look for appropriate circumstances to encourage their other direct reports to do the same. -Additionally, awareness of the inner source project spreads to the manager, who may have previously not known of the team's use and involvement with it. +Additionally, awareness of the InnerSource project spreads to the manager, who may have previously not known of the team's use and involvement with it. -One caveat - keep it real. +One caveat: keep it real. Make sure that your words stem from the sincere thanks that you feel inside for what they've done. Keep the level and verbosity of praise appropriate to their level of involvement. Overdoing it may feel insincere and mechanical and defeat your purpose in reaching out. @@ -80,5 +81,4 @@ Overdoing it may feel insincere and mechanical and defeat your purpose in reachi ## Acknowledgments -* [Todd Lisonbee](https://github.com/tlisonbee) for encouraging to "keep it real". -* [Isabel Drost-Fromm](https://github.com/MaineC) for [this extra explanation](https://youtu.be/h3MPewsk5PU?t=357) of a "qualified" thank you. +* [Todd Lisonbee](https://github.com/tlisonbee) for encouraging to "keep it real." From b2617cc76e0e29f61e5676683020526f8adf6e27 Mon Sep 17 00:00:00 2001 From: Bryan Behrenshausen Date: Mon, 19 Aug 2024 16:47:20 -0400 Subject: [PATCH 2/6] Remove superfluous whitespace --- patterns/2-structured/praise-participants.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/2-structured/praise-participants.md b/patterns/2-structured/praise-participants.md index c66e1e86e..1862cae72 100644 --- a/patterns/2-structured/praise-participants.md +++ b/patterns/2-structured/praise-participants.md @@ -6,7 +6,7 @@ Praise Participants When you receive an InnerSource contribution, it's important to thank the contributor for their time and effort. Extending your gratiutude not only effectively acknowledges the contribution but also engenders further engagement from the contributor and others. -Praising contributors' positive contributions to your InnerSource project motivates those contributors (and their managers) to continue investing in the effort. +Praising contributors' positive contributions to your InnerSource project motivates those contributors (and their managers) to continue investing in the effort. ## Problem From db8f58684d044fbb28afef35924a91d5db6983c3 Mon Sep 17 00:00:00 2001 From: Bryan Behrenshausen Date: Mon, 19 Aug 2024 16:49:35 -0400 Subject: [PATCH 3/6] Add missing word --- patterns/2-structured/praise-participants.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/2-structured/praise-participants.md b/patterns/2-structured/praise-participants.md index 1862cae72..52f120948 100644 --- a/patterns/2-structured/praise-participants.md +++ b/patterns/2-structured/praise-participants.md @@ -22,7 +22,7 @@ It also makes us less likely to forget to praise our contributors, which is unfo ## Forces -* You are busy, forgetting some soft touches (like praise and thanks) easier. +* You are busy, which makes forgetting some soft touches (like praise and thanks) easier. * You may not be someone that is comfortable in social situations or good with words. * Peer recognition is very important to job satisfaction and career development. From 2a12c0d0f659535673a8e52a487d3fcd45f99212 Mon Sep 17 00:00:00 2001 From: Bryan Behrenshausen Date: Thu, 22 Aug 2024 15:41:22 -0400 Subject: [PATCH 4/6] Update praise-participants.md Edit two more sentences in response to editorial feedback --- patterns/2-structured/praise-participants.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/patterns/2-structured/praise-participants.md b/patterns/2-structured/praise-participants.md index 52f120948..3013f564a 100644 --- a/patterns/2-structured/praise-participants.md +++ b/patterns/2-structured/praise-participants.md @@ -10,9 +10,10 @@ Praising contributors' positive contributions to your InnerSource project motiva ## Problem -How can we properly express our gratitude to a contributor for their InnerSource contribution to a project? +How can we properly express our gratitude to a contributor for their contribution to an InnerSource project? We may not know precisely which words or communication channels we should use to express ourselves sincerely. -Effective praise for participants follows a pattern, and following this pattern helps ensure that our messages of thanks come across clearly and graciously. +But recognizing and thanking contributors is critical for keeping those contributors (and their managers) engaged in the work. +Luckily, effective praise for participants follows a pattern, and following this pattern helps ensure that our messages of thanks come across clearly and graciously. It also makes us less likely to forget to praise our contributors, which is unfortunately too easy to do. ## Context @@ -30,7 +31,8 @@ It also makes us less likely to forget to praise our contributors, which is unfo Being recognized by others feels good. And in a professional setting, recognition from peers can also increase your organizational influence and career growth. -Any time someone contributes to your InnerSource project, recognize them with an authentic sincere "thank you." +Any time someone contributes to your InnerSource project, recognize them with an authentic, sincere "thank you." +Be sure to highlight specific examples of ways these contributions have impacted the project positively. For non-trivial contributions (all code contributions and significant time contributions), say "thank you" via the following mechanisms: From 59b5f38f50d277d99141077fefce6ff3e75d12a9 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 24 Aug 2024 08:26:19 +0200 Subject: [PATCH 5/6] Adding more explanation to the acknowledgment section. Context: Word "qualified" was removed in the pattern itself. --- patterns/2-structured/praise-participants.md | 1 + 1 file changed, 1 insertion(+) diff --git a/patterns/2-structured/praise-participants.md b/patterns/2-structured/praise-participants.md index 3013f564a..fc9bb8fb0 100644 --- a/patterns/2-structured/praise-participants.md +++ b/patterns/2-structured/praise-participants.md @@ -84,3 +84,4 @@ Overdoing it may feel insincere and mechanical and defeat your purpose in reachi ## Acknowledgments * [Todd Lisonbee](https://github.com/tlisonbee) for encouraging to "keep it real." +* [Isabel Drost-Fromm](https://github.com/MaineC) for [this extra explanation](https://youtu.be/h3MPewsk5PU?t=357) of the importances of providing specific examples of how the contribution has positively impacted the project. From de4f7a5e87a9c64e42a20831db2a1e5cf15f692d Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 24 Aug 2024 20:19:24 +0200 Subject: [PATCH 6/6] Spelling fix --- patterns/2-structured/praise-participants.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/2-structured/praise-participants.md b/patterns/2-structured/praise-participants.md index fc9bb8fb0..263408dbf 100644 --- a/patterns/2-structured/praise-participants.md +++ b/patterns/2-structured/praise-participants.md @@ -84,4 +84,4 @@ Overdoing it may feel insincere and mechanical and defeat your purpose in reachi ## Acknowledgments * [Todd Lisonbee](https://github.com/tlisonbee) for encouraging to "keep it real." -* [Isabel Drost-Fromm](https://github.com/MaineC) for [this extra explanation](https://youtu.be/h3MPewsk5PU?t=357) of the importances of providing specific examples of how the contribution has positively impacted the project. +* [Isabel Drost-Fromm](https://github.com/MaineC) for [this extra explanation](https://youtu.be/h3MPewsk5PU?t=357) of the importance of providing specific examples of how the contribution has positively impacted the project.