Editar uma wiki é fácil. Mas contribuir efetivamente, isto é, editar de modo que o resultado seja positivo e eficaz para a proposta da Wiki é uma habilidade que se consolida com o tempo. Aprende-se muito com exemplos, e aprende-se muito também fazendo.
Se você nunca contribuiu com uma wiki antes, não se assuste. O convite a se tornar um(a) redator(a) por aqui está feito independente da sua experiência atual. O que essa página mostra é apenas uma lista de características que, caso você não possua hoje, deverá desenvolver enquanto contribui.
O resultado desse processo será positivo para os dois lados: para a Wiki, que terá mais conteúdo de qualidade, e para você, que aprimorará sua redação técnica e ampliará seu conhecimento.
Espera-se que, ao longo da sua trajetória por aqui, você consiga continuamente e gradualmente aprimorar as habilidades a seguir, independentemente da expierência que já tiver.
Não é preciso fazer muito esforço para compreender por que isso é importante. Saber comunicar bem é uma habilidade essencial para redigir conteúdo de qualidade, conteúdo que será compreendido e absorvido com mais facilidade pelos leitores. Esta wiki disponibiliza materiais em português, portanto requer o domínio do idioma, com destaque para correção, concisão, coesão e coerência dos textos.
Uma das melhores maneiras de aprimorar essa habilidade é sendo um(a) ávido(a) leitor(a). A leitura ensina pelos exemplos, isto é, ao ler você gradualmente descobre métodos mais eficazes de se expressar, ampliando seu vocabulário, reforçando seu conhecimento ortográfico e gramatical e observando como pode desenvolver suas ideias por uma linha temporal lógica.
É claro que o material de leitura usado como referência também precisa ser correto e bem editado, caso contrário estará aprendendo com exemplos ruins. Por isso livros, jornais, revistas e demais publicações que obrigatoriamente passem por uma revisão para que possam ser publicados são materiais de referência mais interessante para esse processo.
Para redigir tecnicamente, uma boa fonte de leitura são materiais técnicos. Mas não se restrinja a isso. Você se surpreenderá com o quanto a leitura de materiais de outros domínios (como a literatura) poderão auxiliar a sua escrita técnica.
Escrever bem não é ser pedante ou usar palavras difíceis ou menos conhecidas. Pelo contrário, é importante usar uma linguagem que terá maior chance de ser compreendida por quem vai ler. Isso não quer dizer, por outro lado, que usar uma linguagem simplória ajude. Há um equilíbrio a ser buscado nesse sentido, cujo norte seja o uso de palavras e frases que façam sentido e tenham o significado correto.
É importante que os textos redigidos possuam uma linguagem “limpa”, evitando termos chulos ou potencialmente ofensivos, como palavrões.
Escrever bem tem ainda outra função além de comunicar bem: é uma forma de ajudar a propagar o uso correto das palavras. Note portanto, que há uma responsabilidade sobre quem escreve, pois se alguém vai ler o que você escreveu, esse alguém poderá tomar a sua forma de escrever como exemplo.
Por mais que você saiba comunicar bem, é importante também ter o domínio do assunto sendo abordado. Falar sobre algo que você não compreende é uma atitude temerária, pois não apenas corre o risco de passar para frente uma informação errada (portanto uma irresponsabilidade), como também corre o risco de passar vergonha.
É claro que não podemos saber tudo sobre todos os assuntos, e eventualmente, erros acidentais podem acontecer. Acontece com qualquer pessoa e isso não é nenhuma vergonha. Pode até ser visto como um ato de grandeza reconhecer e reparar os erros cometidos. Mas há uma diferença entre um erro honesto e um erro por negligência, ou seja, um erro grotesco que poderia ter sido evitado.
A diferença entre esses dois tipos de erro basicamente é se você, antes de falar sobre um determinado assunto, consultou referências confiáveis. Quando fica claro que você não buscou se informar sobre um assunto que abordou, isso é um erro negligente.
Para esta wiki, existem diversos materiais que são valiosos para embasar o conteúdo: padrões estabelecidos, publicações acadêmicas (como artigos e simpósios), livros, documentações oficiais e manuais de ferramentas, bibliotecas ou dispositivos, e até mesmo blogs ou páginas pessoais de pessoas envolvidas diretamente no desenvolvimento de projetos ou áras de conhecimento que estejam sendo citados na Wiki.
Citar os materiais consultados é uma boa prática, não apenas para que o leitor possa se aprofundar no assunto, mas também para você se resguardar, mostrando que se baseou em uma fonte de credibilidade para abordar o assunto e evitar que o conteúdo contribuído seja removido no futuro.
Alguns dos materiais tidos por referência podem não estar publicamente disponíveis. Isso não é um grande problema, mas é interessante que sejam citadas fontes que estejam abertas, para que o leitor possa fazer uma checagem mais imediata dos fatos, se assim desejar.
Como você pode imaginar, ninguém nasce sabendo. O embasamento técnico se constrói gradualmente, como peças de um complexo jogo de quebra-cabeça, peças que você obtem pouco a pouco e vai formando uma imagem mental. Mas de onde vem essas peças? Fato é que o conhecimento não vem sozinho até você.
É bem verdade que cursos e videoaulas ajudam a fomentar seu interesse por um assunto e oferecem perspectivas que talvez não tivesse. Mas também existe uma parcela um pouco mais árdua do processo de aprendizado que é a de pesquisar por conta própria sobre aquilo que ainda não entende, e colocar em prática o que aprendeu.
É preciso saber ser autodidata, portanto saber como aprender, como buscar informações e consolidar a sua visão sobre algum assunto. Como ponto de partida, é importante que você tenha um autêntico interesse pelo assunto, ou seja, seu objetivo primário precisa ser aprender aquele assunto. Saber ensinar e documentar serão consequências que virão depois.
Além disso, você deve sempre priorizar as fontes de estudo que sejam mais credíveis (vide seção anterior, de embasamento técnico para ter uma ideia do que poderiam ser essas fontes). Não dê a mesma credibilidade a todos os materiais que encontrar por aí. A efetividade da pesquisa passa justamente por filtrar aquilo que não serve, e absorver apenas o que é conteúdo de qualidade e confiável.
Isso não significa que você deva prontamente rejeitar tudo que não seja considerado uma “fonte oficial” ou que não esteja integralmente correto. Pode-se aprender também com fontes de terceiros que eventualmente tenham um ou outro erro. O importante é saber separar as fontes de estudo quanto à qualidade e confiabilidade.
Na medida que você percebe o desleixo e a falta de referencial técnico nos materiais de estudo que encontrar, deve ter mais ressalvas com o material (e até mesmo evitar a citação desse tipo de material), classificando como de baixa qualidade ou menos confiável. Quando perceber que um material está melhor embasado, então pode classificar como uma fonte de boa qualidade e mais confiável, sendo melhor apta para citação, eventualmente.
Há pouco ou nenhum valor em apenas repetir a mesma informação facilmente encontrada em outros lugares. O grande barato de uma wiki é justamente encontrar informações organizadas de modo que seja inédito, e preferencialmente que seja algo mais fácil de compreender do que nas fontes originais.
Mais do que apenas informação, aliás, uma wiki deve agregar conhecimento, que é uma coleção de informações estruturadas e organizadas de modo que se possa aproveitá-las para algum objetivo.
A síntese consiste em saber consultar várias fontes de informação (aquelas que reforçam o embasamento técnico) e identificar a partir delas quais são as partes que valem a pena serem abordadas. Ou seja, você deve saber filtrar aquilo que é relevante dentro da sua abordagem do tema, e apresentar de modo objetivo.
Materiais como especificações técnicas formais, manuais mais rebuscados, publicações acadêmicas, e outros podem ser importantes para embasar o conhecimento, porém não necessariamente rendem uma leitura suave e portanto tendem a ser inadequados para quem está ainda nos primeiros passos com o assunto.
A Wiki deve justamente ser uma forma de reduzir as barreiras para ter uma compreensão do todo, e pode oferecer textos introdutórios para assuntos abordados com mais profundidade em outros lugares. Isso não quer dizer que o material abordado em uma wiki deva ser raso (e aliás, não deve), mas quer dizer que ela deve ser um bom ponto de partida para os assuntos que abordar.
Portanto você deve saber elencar o que importa para a Wiki e saber apresentar de modo conciso, didático e prático.
O potencial colaborativo é um dos grandes destaques de uma wiki. Para que a colaboração entre usuários diferentes funcione bem, é importante que eles saibam trabalhar em equipe, e para isso entrem em um acordo sobre como a edição deve ser feita.
Para evitar um cenário de caos e bagunça, é importante que haja convenções que reflitam as necessidades da wiki em questão. Inclusive, temos aqui nossas próprias convenções da Wiki. De tempos em tempos uma revisão das páginas pode revelar padrões interessantes que valham a pena ser convencionados, assim como outros podem deixar de existir e fazer sentido. O importante é sempre manter a consistência.
Canais para uma comunicação efetiva entre redatores também devem existir, assim quando dúvidas surgem, elas podem ser debatidas entre as pessoas envolvidas. Nesta wiki, as discussões são conduzidas no Fórum. Novos tópicos podem ser abertos por lá quando houver alguma proposta de mudança que necessite uma discussão prévia ou quando alguma edição passada precisar de uma revisão (especialmente quando a revisão é proposta por uma pessoa diferente daquela que redigiu o texto).
As interações devem ser, tanto quanto for possível, objetivas, harmoniosas e amigáveis, e acima de tudo, devem ser sempre respeitosas.
As habilidades a seguir não são essenciais para colaborar por aqui, mas podem ser úteis.
Se por um lado o domínio de português é necessário para redigir, o domínio de outros idiomas (sobretudo o inglês) é necessário para assimilar o conteúdo de diversos materiais que contribuem para o entendimento do assunto sendo abordado. Buscar apenas referências em português pode ser bastante restritivo, e dependendo do assunto pode ser um luxo que não teremos.
O domínio de outros idiomas nesse caso será importante tanto para ler e compreender manuais, documentações e especificações, quanto para ampliar as pesquisas que você pode fazer.
Apesar da maior parte do conteúdo que nos interessa estar em inglês, saber ainda outros idiomas será útil também pois muitos autores de outros idiomas preferem escrever em seus idiomas nativos, e portanto criam conteúdo de qualidade que não está disponível nem em português e nem em inglês.
Quanto mais idiomas você conhecer, maior será seu horizonte de pesquisa e consulta.
Porém um destaque precisa ser feito aqui: para os efeitos de publicação na Wiki, qualquer conteúdo que tenha sido obtido de outro lugar e apenas traduzido não conta como uma contribuição original, e deve ser evitado. Isso só é justificado se realmente for relevante para a Wiki reproduzir o conteúdo como está (porém em português), e estiver sob uma licença que permita esse tipo de reprodução. Do contrário, é preferível criar um texto novo, apenas citando a fonte.