Salve queridos irmaos,hoje eu queria apresentar mais uma ferramenta que facilita e muito avida de um desenvolvedor e falar um pouco sobre documentacao desoftware.1.0 Introducao aDocumentacao.Pra comecar sei que edo conhecimento de todos o tamanho da importancia de se documentarseus codigos, quanto mais quando se trata de grandes projetos, e naoe algo que tome muito do seu tempo pois e feito junto ao codigo eajuda em dores de cabeca futuras.A documentacao dosoftware nada mais e do que uma descricao de cada parte docodigo-fonte, um metodo, uma classe, um atributo ou um trecho.Podemos dizer que a documentacao e um conjunto de manuais gerais etecnicos que podem ser organizados na forma de textos e comentarios,e permite a criacao de diagramas, fluxogramas, graficos, etc...2.0 phpDocumentor.Bem pra facilitar nossavida tempos uma ferramenta chamada phpDocumentor, que faz adocumentacao do seu codigo identificando os comentarios de suaaplicacao PHP.Aqui vai um pequenoexemplo, mas vou deixar no fim do post alguns links que podem ajudara fazer a documentacao da sua aplicacao:/** * Breve exemplo metodo. * * @name Soma * @param int $a Oprimeiro parametro e sua descricao * @param int $b Osegundo parametro e sua descricao * @access public * @return Soma dosparametros. */ public functions Soma( $a, $b){ return $a + $b; }Na documentacao ophpDocmentor identifica o intervalo entre /** ate */e descreve os parametros e outras informacoes a partir dosidentificadores @param, @name dentre outros.2.1 Download eInstalacaoBem galera essa parte ebem simples, nao tem segredo.Em primeiro lugar faca o download pelo site : http://www.phpdoc.org/ .Descompacte o arquivo na pasta do seu servidor. Ex: /var/www/ ou /xampp/htdocs/De permissoes as pastas se necessario.Abra com o navegador o phpdoc.Na parte inferior voce vai ver um diretorio apontando pra pasta do phpdoc, troque pela pasta da sua aplicacao.Na aba Files em Files parse e Directory to parse aponte para pasta de sua aplicacao.Ainda na aba Files em Files to ignore indique os arquivos que deseja que nao sejam documentados. Na aba Output em Target aponte o diretorio em que seseja salvar a documentacao.Em Output Format selecione o formato que deseja gerar a documetacao.Em opcoes adicione um titulo para sua documentacao, indique o @package padrao do projeto e a categoria e click em Create ou Create ( new windows ). Epronto, a documentacao esta comcluida.3.0Dicas:Acessem: http://trac.expressolivre.org/wiki/WF/PHPDoc http://blog.intermol.com.br/2008/03/23/como-documentar-seu-php-phpdocumentor/ http://www.ricardo-vargas.com/pt/podcasts/documentation/Bemgalera por enquanto isso e tudo, qualquer dica sugestao faca seucomentario, e muito importante pra manter a qualidade no conteudo,se gostou divulgue e ajude a espalhar a palavra. Ate Breve. (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-60627751-1', 'auto'); ga('send', 'pageview');Boa tarde, vim falar sobre a ultima saga que li, na verdadeainda estou lendo. A serie Maze Runner!Devo confessar que de inicio nao estava la muito interessadopelos livros tinha decidido ler apenas o primeiro pra ver se era mesmo bom masacabei viciado.Logo no comeco o leitor e jogado nesse mundo insano juntocom Thomas, que acorda dentro de uma caixa escura sem lembrar de absolutamentenada de sua vida a nao ser seu proprio nome, essa caixa na verdade e uma especiede elevador, quando esta se abre ele e recepcionado por varios outros garotosestranhos que estao em um espaco