InnerSourceCommons / InnerSourceCommons/InnerSourcePatterns

[Pattern Draft] The Outreach Sandwich - Keeping contributions moving

Abierto
#537 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

:book: Type - Content Work 1-initial
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

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. 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

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.