InnerSourceCommons / InnerSourceCommons/InnerSourcePatterns

[Pattern Draft] The Outreach Sandwich - Keeping contributions moving

Aberta
#537 1 comentário 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

:book: Type - Content Work 1-initial
Linguagem predominante
HTML
Estrelas
853
Forks
206
Merge médio
1d 23h
PRs com merge (30d)
2

Descrição

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.

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece pelo Google Doc vinculado e pelo WIP Patlet nesta issue; compare as notas das entrevistas e o rascunho existente com o fluxo do Outreach Sandwich. Considera-se concluído quando houver um rascunho de pattern revisado e autocontido, com o processo, os limites de outreach e o diagrama esclarecidos, incluindo uma solução para leitores que não conseguem acessar o documento.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Domínio
documentation
Tipo de issue
Documentação
Dificuldade
5/5
Tempo estimado
Mais de uma semana
Status de atividade
Estagnada
Clareza
Precisa de esclarecimento
Facilidade para iniciantes
25/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.