aziontech / docs Goto Github PK

Oi gente! Queria começar uma discussão com vcs (sinto falta delas hehe) sobre nosso padrão do uso das badges nas docs.

Uma coisa importante que o França trouxe é que não queremos poluir muito a UI com componentes desnecessários. Exemplo disso: Run Function hoje tem 4 badges e eu já estou achando demais.

Outra coisa importante é diferenciar o que é "Required" de habilitar algo na plataforma do "Required" que é necessário para seguir os passos descritos como eles estão.

Segue o comentário detalhando my train of thought:

Pra mim não faz muito sentido usar o badge nesse caso porque o módulo não habilita um behavior ou uma variável, apenas te habilita a fazer uma ação que pode ser feita fora do RTM. Expliquei no outro comentário pra Hannah mas existem jeitos diferentes de fazer a mesma coisa. O jeito descrito requer o módulo, mas não a coisa.

Então a badge pra mim faz mais sentido pra algo que é desabilitado dentro do RTM (um campo, uma seção) e não uma ação/atividade.

Outro exemplo pode ser a aba edge functions de edge app. Só é habilitada quando o módulo tá ligado. Aí sim eu usaria a badge!

Originally posted by @bru-andrade in #134 (comment)