Treinamento obrigatório de integração para formatação de código?

Olá, eu administro o https://discourse.bokeh.org e também frequento o https://discuss.python.org com frequência. Em ambos os lugares, há um problema bastante terrível com novos usuários que não formatam o código em suas primeiras postagens. Geralmente, há várias postagens por dia no principal fórum do Python em que os usuários precisam ser corrigidos. [1] Isso representa um dreno enorme e constante no tempo de muitas pessoas.

Seria possível ter fluxos de integração obrigatórios, antes que um novo usuário possa fazer uma primeira postagem? Estou pensando explicitamente em um fluxo onde o usuário é apresentado a como realizar a formatação de código e, em seguida, é encarregado de reproduzir manualmente 2-3 linhas de código formatado. Eles precisam completar isso com sucesso antes de serem autorizados a postar.


  1. Este é um problema especialmente pernicioso para o Python, pois a indentação é significativa. ↩︎

2 curtidas

Você já viu Unformatted Code Detector? Isso ajudou com o mesmo problema em algumas outras comunidades.

3 curtidas

Sim, eu diria que teve sucesso limitado, na melhor das hipóteses, pelo menos em https://discourse.bokeh.org. Mas, até onde sei, ele foi instalado no fórum Python também (não sou administrador lá).

2 curtidas

Não acho que sim, veja Unformatted Code Detector - #4 by jeanas - Discourse Feedback - Discussions on Python.org para o qual não recebi nenhum aviso.

Uma coisa que um onboarding obrigatório ajudaria seria com capturas de tela com código nelas, embora o OCR possa presumivelmente ser usado para imprimir um aviso em tais postagens, como o plugin existente “Detector de código não formatado”.

Eu não acompanho o Bokeh, então não posso julgar se o plugin está funcionando bem ou não.

1 curtida

Na verdade, o plugin de detecção de código não formatado está ativado no discuss.python.org. Eu olhei a categoria de Usuários desse fórum (não acompanho essa categoria recentemente) e, para ser justo, ela parece muito melhor do que costumava ser, embora ainda existam algumas postagens com código não formatado.

Para que conste, aqui está um exemplo de hoje com um grande bloco de código (que deveria passar em qualquer limite) que o plugin não detectou:

o que então gerou uma discussão paralela sobre exatamente este tópico de integração / formatação de código, do qual o OP pareceu ficar um pouco ofendido.

O plugin está simplesmente quebrado ou precisa de uma atualização? Independentemente disso, ainda acho que um desafio obrigatório de “formatar este código” antes de poder postar é uma adição valiosa à “autodetecção”.

1 curtida

Acabei de verificar o Componente de Tema com seus parâmetros padrão e o código não formatado do exemplo
parece estar funcionando

Definitivamente não impediu as mais de 50 linhas de código não formatado na postagem vinculada, que agora se transformou em mais discórdia neste ponto. :slight_smile:

deveria ser um pouco mais coercitivo? talvez :roll_eyes:
um primeiro passo fácil poderia ser uma pequena alteração no texto do botão, talvez submit pudesse ser CUIDADO !!! ou algo assim…