�ndices

  1. Papel dos manuais na programa��o de software
  2. Debunking o mito de XP do c�digo � documenta��o
  3. Valor adicional da boa documenta��o
  4. Papel de escritores t�cnicos no projeto de XP
  5. Sum�rio


Papel dos manuais na programa��o de software
Eu lia um artigo interessante de Ron Jeffries na introdu��o dos manuais. Eu discordo com suas suposi��es em diversos aspectos. Neste artigo n�s olharemos o papel dos manuais na programa��o de software. Mas deixa primeiramente para ver o que tem que dizer neste t�pico:

  • Todos que f�z produtos de software sabe que quase ningu�m l� o manual. N�s sabemos este das perguntas que do suporte laboral n�s come�. N�s sabemo-lo porque a maioria de n�s n�o l�em os manuais tampouco.
  • Os apps da correia fotorreceptora n�o v�m com manuais, e est�o retrocedendo a extremidade. Alguns deles t�m um par p�ginas da ajuda. Muitos n�o t�m nada mas as instru��es na p�gina e o fluxo das teclas.
  • O software � entregado cada vez mais hoje em um CD, e o �nico manual que voc� come� � o tamanho da caixa CD. Parece trabalh�-la muito bem - a ci�ncia encontrou que mais povos l�em aqueles livros pequenos - pensou que est�o procurando os poemas l�ricos.
  • E hey: Os projetos de XP constroem o software com o valor de neg�cio o mais elevado primeiramente. O material na extremidade n�o importa tanto quanto o material no in�cio!

Os manuais n�o s�o definitivamente necess�rios para um tipo simplista aplica��o web do carro de compra, nem s�o necess�rios para muitas outras tais aplica��es simplistas. Entretanto dizer que quase ningu�m l� o manual � o mais distante da verdade porque pode ser. Para toda a empresa moderada complexa classifique as aplica��es (Siebel, Oracle, SalesForce, relat�rio da despesa de Extensity e gazillion outro) que exigem a intera��o significativa do usu�rio e expressam a l�gica de neg�cio complexa, lendo o manual � obrigat�rio se voc� n�o quer sujar acima na maneira principal.

N�o todas as aplica��es podem ser feitas t�o simples a respeito de n�o exigir um manual. A l�gica de neg�cio subjacente determina o grau de complexidade da aplica��o. Seu artigo parece centrado sobre aplica��es simplistas pequenas somente.

Diversas aplica��es web que eu trabalhei com e tornado vem com jogo cheio dos manuais. Tente criar as aplica��es de uma bioinform�tica do complexo (n�o apenas uma busca simples como NCBI) sem um manual.

O descanso dos argumentos de encontro a um manual aceit�vel � pol�tico-discurso-tipo sem muita l�gica. Assim eu n�o passaria o tempo refute ponto por ponto os exceto final.

> e hey: Os projetos de XP constroem o software com o valor de neg�cio o mais elevado primeiramente. O material na extremidade n�o importa tanto quanto o material no in�cio!

O valor de neg�cio o mais elevado bom para a maioria de aplica��es da empresa inclui a factura do software compreens�vel a tudo em termos simples desobstru�dos e aquele exige uma boa documenta��o desobstru�da.

A realidade � terra � que os bons manuais s�o uma exig�ncia forte para a maioria de aplica��es da empresa.

Debunking o mito de XP do c�digo � documenta��o
O c�digo � a documenta��o (mantra de XP) n�o a corta no mundo real. Os clientes infelizmente n�o podem ler esta parte fina de c�digo chamado documenta��o. Os colaboradores dos peda�os mesmo n�o podem ler alguma tal documenta��o facilmente.

Deixe-nos olhar este problema de um �ngulo diferente. Podemos n�s fazer o c�digo somos documenta��o uma realidade apenas para os colaboradores eles mesmos?

P�ginas: 1 2