From fc5ba81e035f5c1d8b037201a6d8fed7cbdf1e99 Mon Sep 17 00:00:00 2001 From: Guilherme Dellagustin Date: Wed, 29 Nov 2023 22:52:00 +0100 Subject: [PATCH] Increment to the initial pattern: All Roads Lead to InnerSource --- ...roads-lead-to-innersource-contributions.md | 24 +++++++++++++------ 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/patterns/1-initial/all-roads-lead-to-innersource-contributions.md b/patterns/1-initial/all-roads-lead-to-innersource-contributions.md index d6a549b8e..88a059788 100644 --- a/patterns/1-initial/all-roads-lead-to-innersource-contributions.md +++ b/patterns/1-initial/all-roads-lead-to-innersource-contributions.md @@ -11,7 +11,7 @@ From http://wiki.c2.com/?PatLet ## Problem -Projects are adopting InnerSource, but struggling to convert users, consumers or stakeholders into contributors, or forming a community. +Projects are adopting InnerSource, but struggling to convert users, consumers or stakeholders into contributors, or community members. In this context, the InnerSource Program is considered also an InnerSource Project. @@ -24,13 +24,15 @@ Sometimes there is a story that helps people understand the pattern better. Users of a service, library or application (software), as well as consumers of any kind of InnerSource content (e.g. documentation), are unaware of the InnerSource project behind the software or content, or even unaware of the InnerSource concept (i.e. they don't know they can contribute). -Potential contributors have their first contact with the project through content that was not designed as a landing page for new comers, e.g. by finding pieces of the backlog, documents, repositories, presentations, etc... through intranet search engines. +Potential community members and/or contributors have their first contact with the project through content that was not initially designed as a landing page for new comers, e.g. by finding pieces of the backlog, documents, repositories, presentations, etc... (touch points). These touch points can be reached, for instance, through an intranet corporate search. + +InnerSource projects do not reach their full potential due to the lack of conversion of consumers into community members and/or contributors. ## Forces -Project maintainers do not see the conversion of users, consumers and interested parties into contributors as a user experience challenge that they need to solve. +Project maintainers do not see conversion of users, consumers and interested parties into contributors as a user experience/marketing challenge that they need to solve. -Project maintainers are unaware that they potential contributors may not be familiar with InnerSource. +Project maintainers are unaware that their potential contributors may not be familiar with InnerSource. ## Sketch (optional) @@ -39,8 +41,16 @@ visual illustration ## Solutions -TODO -Verified resolutions and possible resolutions to the problem. +Maintainers shall look at the journey from consumer to community member to contributor as a design problem. + +In essence, that means putting themselves in the shoes of their consumers, and ensuring that there is a path to becoming a community member and/or contributor, starting at the most commons touch points. + +Examples of commons consumer touch points: + +* Documentation for consumers of InnerSource projects + * should link to an InnerSource beginner's guide + * should clearly indicate the possibility of contributing and becoming part of the project's community +* User facing tools should have a path for becoming part of the project's community and for contributing, directly in the tool's user interface ## Resulting Context @@ -85,4 +95,4 @@ Though optional, most patterns should list who helped in their creation. TODO If this pattern is also known under a different name than what is listed unter **Title**, please list those alternative titles here. -e.g. if the pattern is named after the problem it solves, a helpful alias might be one that describes the solution that is applied. \ No newline at end of file +e.g. if the pattern is named after the problem it solves, a helpful alias might be one that describes the solution that is applied.