Comments on: Documentação e sucesso

By: Ronaldo

Ronaldo — Tue, 04 Mar 2008 20:40:44 +0000

Sim, claro. Existem ferramentas que eu ainda uso e que não tenho a menor intenção de contribuir porque a comunidade é fechada de mais, cheia de cliques. E outras que eu nem quero ver mais porque não há estímulo. Infelizmente, tem muita gente que começa dizendo que é código aberto mas não sabe compatilhar.

By: Rafael Ferreira Silva

Rafael Ferreira Silva — Tue, 04 Mar 2008 17:02:40 +0000

É, no meu caso, até o momento não tenho intenção de voltar à essas ferramentas.

Também concordo que todo usuário é responsável pela documentação de projetos open source, o problema é quando você já desacreditou na comunidade :-/

Abraço

By: Ronaldo

Ronaldo — Tue, 04 Mar 2008 16:37:11 +0000

É isso mesmo. Eu acho que a falta de documentação gera um atrito que, dependendo da tecnologia, é muito difícil de superar.

Tome o caso do Castle Monorail, com o qual eu estou mexendo agora. A documentação até existe no site mas é extremamente fragmentada e não tem algo que eu acho fundamental: problemas comuns e suas soluções. Isso gera uma ladeira que, dependendo da questão, é muito difícil de superar.

Obviamente, como o projeto é aberto, parte da responsabilidade é minha. Eu posso–e pretendo–investir mais no assunto e contribuir.

By: Rafael Ferreira Silva

Rafael Ferreira Silva — Mon, 03 Mar 2008 12:45:47 +0000

Trabalhei por dois anos com Zope/Plone e posso dizer que foi a pior experiência da minha vida, no que tange a Open Source.
O Zope, até pouco tempo, tinha uma quantidade razoável de documentação, mas para o desenvolvedor avançado, necas.
O Plone tem a pior documentação da face da terra: desatualizada e pouco informativa.

O contraste é o Drupal. Trabalho com ele desde 2002 e nunca faltou documentação decente.

Quando procurei alguma coisa sobre Rails, realmente não faltou documentação, só não segui adiante porque faltou projetos :-p