Apresentando Mudanças Futuras, um sistema para gerenciar novos recursos e alterações em funcionalidades existentes em sua comunidade

[lindsey (Lindsey Fogle)]

À medida que continuamos a melhorar o Discourse, criamos uma nova página de configuração de Mudanças Futuras para ajudar os administradores a entenderem quais mudanças estão por vir e permitir que gerenciem como essas mudanças são implementadas em suas comunidades. Acreditamos que esse sistema nos ajudará a continuar melhorando o Discourse de forma segura e transparente.

Neste tópico, explicaremos como esse novo sistema funciona e como usá-lo para introduzir com segurança novos recursos e outras mudanças em sua comunidade.

Visão geral de como funcionam as Mudanças Futuras

À medida que trabalhamos em novos recursos ou outras mudanças, os adicionaremos à página de configuração de Mudanças Futuras em /admin/config/upcoming-changes. Cada mudança incluirá uma descrição, status, indicador de quais usuários são impactados por ela e para quais usuários (se houver) está habilitada em sua comunidade.

Dependendo do status da mudança, você pode decidir ativá-la ou desativá-la para sua comunidade — pelo menos temporariamente, já que algumas mudanças eventualmente serão ativadas permanentemente.

Desativar temporariamente uma mudança dá a você tempo para resolver quaisquer personalizações do site, processos, etc., afetados, informar sua base de membros sobre a mudança ou designar certos grupos de membros para testes.

Analisando uma Mudança Futura

Vamos analisar uma Mudança Futura e definir as informações que você verá em cada seção.

1 - Nome e descrição

O nome e a descrição fornecem uma breve explicação da mudança e vinculam ao tópico relacionado no Meta para mais informações e um local para coletar feedback.

2 - Status

O status comunica sua posição no ciclo de desenvolvimento. O status impacta diretamente se a mudança é opcional (ou seja, desativada por padrão, mas você pode ativá-la), de saída opcional (ou seja, ativada por padrão, mas você pode desativá-la) ou forçada (ou seja, ativada e você não pode desativá-la).

Usamos os seguintes status nas Mudanças Futuras:

• Experimental: Uma mudança potencial que está em desenvolvimento/testes iniciais e é esperada para evoluir rapidamente, ou pode ser removida completamente se terminarmos o experimento (nesse ponto, passará para o status Inativo; veja abaixo). Você pode optar por participar de mudanças Experimentais para testá-las.
• Alpha: Uma mudança testada que é segura para uso, embora possa haver algumas atualizações menores em seu design ou funcionalidade. Você pode optar por participar de mudanças Alpha para usá-las antecipadamente.
• Beta: Uma mudança testada que é segura para uso e é improvável que mude muito antes de passar para o status Estável ou possivelmente Permanente.
  • Para a maioria dos sites em nossa hospedagem e para sites auto-hospedados, as mudanças Beta são automaticamente ativadas para todos (se você não as tiver habilitado anteriormente), mas ainda poderá optar por sair.
• Estável: Uma mudança concluída^[1], mas ainda é de saída opcional (ou seja, os administradores podem desativá-la). Os administradores serão avisados em seu painel quando optarem por sair de uma mudança Estável.
• Permanente: Uma mudança que concluiu os testes e está forçada (ou seja, os administradores não podem desativá-la). Mudanças permanentes não aparecerão mais na lista de mudanças futuras; em vez disso, serão exibidas na página /admin/whats-new.
• Inativo: Um experimento abandonado. Você não pode optar por participar.

Às vezes, as mudanças passarão linearmente por esses status (ou seja, começarão em Experimental e terminarão em Permanente), mas nem sempre. Algumas mudanças podem ser introduzidas com status Alpha ou Beta, e algumas terminarão com status Estável. Mudanças do tipo “valor padrão da configuração do site” não serão movidas para Permanente, pois apenas alteram o valor padrão de uma configuração existente.

Não há um tempo definido para quanto tempo levará para uma mudança específica progredir de um status para outro, mas os administradores serão notificados quando:

• Uma nova mudança estiver disponível para teste
  • Essas são enviadas no máximo uma vez por semana para evitar fadiga de notificações. Se você preferir não receber essas notificações, pode desativá-las em /my/preferences/notifications
• Uma mudança foi habilitada automaticamente
• Quando você desativou uma mudança que em breve será forçada
  • Isso será exibido como um aviso no painel do administrador

3 - Usuários impactados

A tag de usuários impactados descreve quais usuários em sua comunidade podem ver ou interagir com a mudança de alguma forma. Para simplificar — quem pode notar essa mudança? Existem vários tipos de usuários impactados:

• Administradores: A mudança é visível apenas para administradores.
• Equipe: A mudança é visível apenas para administradores e moderadores.
• Todos os membros: A mudança é visível para todos os membros do seu site.
• Desenvolvedores: Em casos raros, uma mudança será perceptível apenas para aqueles que estão interagindo com código no núcleo, temas ou plugins.

Tipo de impacto

Um subconjunto de usuários impactados, e não exibido na lista, é o tipo de impacto. O tipo de impacto descreve como a mudança afetará sua comunidade em um sentido amplo:

• Recurso: A mudança introduz um novo recurso ou funcionalidade à sua comunidade, ou modifica a funcionalidade existente.
• Valor padrão da configuração do site: A mudança modifica o valor padrão de uma configuração de site existente. Administradores que já alteraram a configuração de seu antigo padrão não serão afetados. Nenhum aviso no painel do administrador será exibido para essa mudança quando ela atingir o status Estável.
• Outro: Qualquer outra mudança que não se encaixe nas categorias acima.

4 - Habilitado para…

Este menu suspenso é onde você, como administrador do site, pode controlar se e como introduzir essa mudança em sua comunidade, habilitando-a para:

• Ninguém: Desativa a mudança para todos no site.
• Todos: Habilita a mudança para todos no site, incluindo usuários anônimos. Quando a mudança é ativada automaticamente (geralmente no status Beta), será para Todos.
• Apenas equipe: Habilita a mudança para a equipe do site (ou seja, administradores e moderadores).
• Grupos específicos: Habilita a mudança para o(s) grupo(s) selecionado(s).

Algumas mudanças futuras podem ter opções de “Habilitar para” restritas. As opções disponíveis no menu suspenso “Habilitado para” são determinadas pela configuração da mudança. Por exemplo, certas mudanças podem permitir apenas as opções Todos e Ninguém, já que testes limitados de grupos seriam inviáveis para a mudança.

---

Por enquanto, movemos a maioria das mudanças Experimentais de /admin/config/experimental para Mudanças Futuras, e você começará a ver novas atualizações aqui em breve. Estamos ansiosos para ouvir sobre o impacto que isso causa em sua comunidade e recebemos qualquer dúvida ou feedback!

---

1. Na medida em que qualquer software seja concluído! ↩︎

[NateDhaliwal]

Estou curioso - como ele controla como a alteração é implementada? Pode ser alterado depois que o recurso for introduzido? Obrigado.

[merefield (Robert)]

Native Feature Flags! Muito bom

Seria ótimo ter uma API para plugins.

[Canapin (Coin-coin le Canapin)]

Esse é um recurso muito aguardado! Obrigado!

[darkpixlz (Pyx)]

Isto é ótimo, ter a capacidade de mudar as flags assim é incrível para pessoas na vanguarda como eu, especialmente ao desenvolver um tema.

No entanto, “alterações futuras” (upcoming changes) é realmente o melhor nome para isso? Por exemplo, o HomeAssistant usa “laboratórios” (labs) e muitas outras pessoas usam coisas como “experimentos” (experiments), que soam melhor do que alterações futuras.

[lindsey (Lindsey Fogle)]

@NateDhaliwal

Fico curioso - como isso controla a forma como a alteração é implementada?

Você será notificado sobre novos recursos enquanto eles ainda estiverem em um estado em que você pode experimentá-los antecipadamente (opt-in) e desativá-los temporariamente para corrigir quaisquer problemas causados pela alteração (opt-out). Se uma alteração se tornar permanente (o que significa que você não pode desativá-la) e você a tiver desativado atualmente, nós o informaremos.

Esta seção descreve isso com um pouco mais de detalhes:

@lindsey

Às vezes, as alterações se moverão linearmente por esses status (ou seja, começarão em Experimental e terminarão em Permanent), mas nem sempre. Algumas alterações podem ser introduzidas no status Alpha ou Beta, e algumas terminarão no status Stable (se não forem forçadas).

Não há um tempo definido para quanto tempo levará para uma alteração específica progredir de um status para outro, mas os administradores serão notificados quando:

• Uma nova alteração estiver disponível para experimentação
• Uma alteração tiver sido ativada automaticamente
• Quando você desativou uma alteração que em breve será forçada

@darkpixlz

“Alterações futuras” é realmente o melhor nome para isso, no entanto?

No momento, você está vendo apenas alterações experimentais porque migramos essas do painel de configurações para Alterações Futuras, mas no futuro haverá atualizações não experimentais aqui também. Portanto, “laboratórios” não parece preciso para como estamos usando este sistema.

[martin (Martin Brennan)]

@merefield

Seria ótimo ter uma API para plugins.

Os plugins já podem usar este sistema. O OP não entra nos detalhes técnicos, mas não é necessário muito para adicionar uma alteração futura.

O resumo rápido é:

• Adicionar uma configuração do site com hidden: true e client: true

• Adicionar uma descrição para a configuração em server.en.yml

• Opcionalmente, adicionar uma captura de tela em public/images/upcoming_changes/SETTING_NAME.png

• Adicionar metadados upcoming_change à configuração, que se parece com isto:

# upcoming_change       - Metadados adicionais com as seguintes opções para mostrar na página /admin/config/upcoming-changes:
#                          - status: experimental | alpha | beta | stable
#                          - impact: duas partes separadas por vírgula - feature|other , staff|admins|moderators|all_members|developers
#                          - learn_more_url: uma url para mais informações

No entanto, a ressalva é que não pretendíamos que desenvolvedores de plugins de terceiros usassem este sistema, era principalmente para nossos próprios fins. Talvez com o tempo possamos pensar mais sobre este caso de uso.

[noahl (Noah Lovell)]

Adorei isto! Obrigado

Seria possível ter um link/atalho para a configuração aplicável, se relevante? Por exemplo, a tela de abertura personalizada tem configurações adicionais que precisam ser configuradas para funcionar (fazer o upload do SVG) - mas você precisa ir ativamente procurá-las. Seria útil tê-las ao lado de onde está sendo ativada.

[martin (Martin Brennan)]

Sim, de fato! Estou trabalhando nessa alteração agora, deve estar disponível em um ou dois dias, farei uma anotação para implantar seu site hospedado para que você receba a atualização

Edição: Feito!

[sniper756]

Gostaria de perguntar, como faço para que as “Mudanças Futuras” apareçam no painel de administração de uma instalação própria do Discourse?

@lindsey

[martin (Martin Brennan)]

Ainda temos isso oculto atrás de uma configuração de site global enable_upcoming_changes, que está oculta, então você pode ativá-la no console rails do seu site com rails c. Eventualmente, removeremos isso e você não precisará mais fazê-lo.

[sniper756]

Ok, obrigado, então eu vou esperar um pouco~~~~~~~~~~

[ToddZ]

Não tenho certeza se isso ficou claro: o item de menu para Mudanças Futuras ainda não está ativo, mas …

reformulação:
Se você ainda não tem o item de menu, ainda pode ver a seção Mudanças Futuras acessando [seu_fórum]/admin/config/upcoming-changes

[martin (Martin Brennan)]

Deveria estar, você não vê aqui?

Você está auto-hospedando? Se sim, você também precisará definir enable_upcoming_changes (que é uma configuração oculta) como true. Planejamos remover isso em um futuro não muito distante, assim que tivermos certeza absoluta de que o sistema está estável.

[Moin]

Existe algum motivo pelo qual a maioria das configurações do site para mudanças futuras estão ocultas, mas enable_auto_grid_images não está?

[martin (Martin Brennan)]

@Moin

enable_auto_grid_images

Não, apenas uma supervisão, corrigido aqui:

FIX: Hide enable_auto_grid_images site setting (#38046)

[ToddZ]

Sim, estou auto-hospedando, como sniper756.
“ainda não está ativo” talvez não tenha sido a melhor formulação; vou editar.

[Moin]

Hoje, pensei que seria útil poder ordenar as alterações por status — primeiro beta, depois alpha e, por fim, experimental. Sei que posso filtrar por isso, mas gosto de ver a lista completa; apenas acho as alterações mais ou menos interessantes dependendo do seu status.

[martin (Martin Brennan)]

Sim, faz sentido. Também pensei em adicionar uma opção de classificação baseada em quando a alteração apareceu no seu site… vou adicionar as duas

[khenmu (John Sweeney)]

Adição fantástica!

Obrigado por isso.