envoyproxy/envoy

API stability proposal

Open

#3.390 aberto em 15 de mai. de 2018

Ver no GitHub
 (12 comments) (0 reactions) (0 assignees)C++ (5.373 forks)batch import
area/communityhelp wanted

Métricas do repositório

Stars
 (27.997 stars)
Métricas de merge de PR
 (Mesclagem média 8d) (378 fundiu PRs em 30d)

Description

This is an extension of the conversation started in: https://docs.google.com/document/d/1eDQQSxqx2khTXfa2vVm4vqkyRwXYkPzZCcbjxJ2_AvA/edit?ts=5af97a4e

Ultimately, we would like to stabilize the API and have a deprecation period like we do for config changes. Getting there is going to take a bunch of thought and a solid plan. We also need to make sure we don't reduce velocity when the project is still relatively young.

Related to https://github.com/envoyproxy/envoy/issues/827

cc @brian-pane @htuch @alyssawilk @envoyproxy/maintainers

Guia do colaborador

Direção de pesquisa
Leia a proposta do Google Doc vinculada e a issue #827 para entender o contexto da estabilidade da API. Identifique o estado atual da API e proponha etapas para um período de depreciação.
Pilha de tecnologia
cpp
Domain
backendapi
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Principalmente claro
Prerequisites
Understanding of Envoy's API and configuration
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
30