comment on

Tradução do artigo Before You Post ....

Algumas vezes, quando Monges buscavam sabedoria, eles eram admoestados por companheiros Monges que desejavam certificar-se de que os FAQs foram lidos, ou pior, diziam a eles RTFM. Entretanto, novos monges são muitas vezes intimidados ou confundidos pela informação disponível e esperam por uma explicação mais clara. Além disso, os mais novos dentre os novos muitas vezes não sabem onde encontrar documentação.

Eu estou tentando conseguir absolvição dos companheiros Monges para tais pecados venais. Entretanto, existe um pecado quase mortal: falha em reduzir seu problema a um caso de teste mínimo.

Alguns exemplos são este artigo de vnpandey, este artigo do onipresente Anonymous Monk, e também este node que não é nem mesmo Perl, mas sim o resultado de um make install! Estes artigos contém 250 linhas de código alé do que o necessário.

Agora confronte aqueles nodes com este artigo do kudra. kudra separou algum tempo para reduzir o código a um caso de teste mínimo de forma que nós pudéssemos nos focar no problema e não nos distraíssemos. Todos os Monges deveriam considerar esta possibilidade. Existem alguns benefícios neste comportamento:

Você não molesta os companheiros monges (este link é uma brincadeira. Eu pessoalmente gosto do garoto).
Você não vai parar na Sala da Vergonha.
É mais provável que os Monges lhe ofereçam assistência.
E mais importante: você pode focalizar no problema.

Este último ponto é crítico. Você pode até mesmo esquecer os outros três. Mais de uma vez, tentando isolar um problema, eu tentei reduzí-lo a um caso de teste mínimo. Muitas vezes, removendo a bagunça, o problema acabou fatiado como um bacon. Outras vezes, removendo o código "irrelevante", o problema sumiu e eu descobri que o código irrelevante era o problema.

Então por favor, vamos tentar ter mais consideração e reduzir nosso código tanto quando factível antes de postar para o Monastério. Você aprenderá mais sobre seu código, sobre programação em geral, e terá mais chances de ter respostas relevantes para suas questões.

Saudações!
Ovid

Tradutor: Monsieur Champs.

In reply to Antes que você escreva... by monsieur_champs

Are you posting in the right place? Check out Where do I post X? to know for sure.
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
Want more info? How to link or How to display code and escape characters are good places to start.


"be consistent"
	PerlMonks