InnerSourceCommons / InnerSourceCommons/InnerSourcePatterns
[Pattern Draft] The Outreach Sandwich - Keeping contributions moving
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- HTML
- Estrellas
- 853
- Forks
- 206
- Merge medio
- 1 d 23 h
- PR fusionados (30 d)
- 2
Descripción
In a conversation @MaineC mentioned that @rrrutledge “has a way to follow up at just the right time, to remind me that I need to do something on my PR (contribution)”. Well, it turns out that this happens at the right time because there is a strict regimen behind this that Russ follows :)
I interviewed Russ about this, and captured some notes. [^1]
Now we are looking to turn these notes into a pattern. The first draft of that is already in the doc above.
WIP Patlet:
The communication on some external contributions threads to an InnerSource project are going stale, even though the contributor was motivated when starting the process. By using the outreach sandwich, a structured way to do the follow-up on all open contribution threads, the project maintainers manage to nurture more contributions to completion.
A little sketch that may help to understand the idea behind this pattern.
Don't mind the styling, GitHub does not allow all styling options for mermaid diagrams:
flowchart TD
subgraph checks [" "]
X(Start checks on regular cadence) --> A
A(Take next item from board) --> B
B("`**Progress Check**: Any updates on the contribution?`") -->|yes| A
B --> |no| C
C("`**Time Check**: Enough time since last outreach?`") --> |no| A
C --> |yes| D
D("`**History Check**: How many previous outreaches?`") --> |"0/1/2"| send_outreach
D --> |"3"| stop_outreach
end
subgraph send_outreach [Send Outreach]
OR1("`**Template**: Pick appropriate outreach approach`") --> OR2
OR2("`**Communication Method**: How to effectively reach the contributor?`") --> OR3
OR3("`**Send Outreach**`")
end
send_outreach --> A
subgraph stop_outreach ["Stop Outreach"]
ST1(Inform Contributor) --> ST2
ST2(Close issue/item)
end
stop_outreach --> A
style send_outreach fill:#edf6fb,stroke:#0aa8a7,stroke-width:2px
style stop_outreach fill:#edf6fb,stroke:#0aa8a7,stroke-width:2px
[^1]: If anybody reading this cannot access the doc, please let me know in the comments.
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Empieza con el Google Doc enlazado y el WIP Patlet de este issue; compara las notas de las entrevistas y el borrador existente con el flujo de Outreach Sandwich. Se considera terminado cuando haya un borrador de patrón revisado y autosuficiente, con el proceso, los límites de outreach y el diagrama aclarados, incluida una solución para los lectores que no puedan acceder al documento.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Área
- documentation
- Tipo de issue
- Documentación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Estado de actividad
- Estancado
- Claridad
- Necesita aclaración
- Aptitud para principiantes
- 25/100