andremachado.

org
http://www.andremachado.org/artigos/1096/como-escrever-artigos-e-tutoriais-imparciais-sobre-gnulinux.html#more-1096

Como escrever artigos e tutoriais imparciais sobre GNU/Linux

Andr
Machado

Um dos pontos de meu artigo sobre o Ubuntu que a maioria dos sites ditos especializados sobre Linux da
blogosfera nacional assumem, na maioria das vezes, que o leitor est ou estar usando a distribuio da Canonical
para seguir os passos explicados naquele texto. Esta uma atitude nociva liberdade de software e diversidade
do ecossistema GNU/Linux, pois se algum usurio tiver algum problema ou quiser instalar algum programa em sua
distribuio no-Ubuntu, ele poder se sentir frustrado em no encontrar documentao para seu sistema embora,
teoricamente, tais instrues devessem funcionar em qualquer distribuio e ser psicologicamente coagido a
adotar a escolha da maioria.

Embora muitos digam que isso pode no passar de paranoia e de implicncia, a situao real. Um amigo que usa
Manjaro Linux disse-me precisar ter ido a um frum internacional para obter ajuda de um brasileiro sobre um
problema que ele estava enfrentando. A indisponibilidade de recursos de auxlio para distribuies no-ubuntu em
nosso pas uma situao crtica que prejudica tanto aos usurios quanto as empresas que, de uma forma ou
outra, acabam se prendendo em uma determinada tecnologia.

A fim de reverter esse quadro e preservar a diversidade e a liberdade de escolha a qual nada tem a ver com a
liberdade de software -, elaborei uma lista de recomendaes para os redatores dos sites generalistas sobre
GNU/Linux a fim de evitar a intimidao involuntria do seu leitor que no adotou o Ubuntu como padro. So dicas
simples que voc no obrigado a seguir, mas que, se adotadas, contribuiro para o fomento da liberdade do
software e do usurio.

Instalao de programas

Se o programa estiver presente nos repositrios oficiais das principais distribuies, o autor dever mencionar esse
fato. A parte do tutorial referente explicao sobre como instal-lo dever conter a sintaxe de elo menos um
comando de cada um dos grupos listados a seguir:

Grupo 1: apt-get e aptitude.

Grupo 2: yum, urpmi, zypper, yast

Grupo 3: pacman, portage, prt-get e as ferramentas de instalao de distribuies mais avanadas.

Assim, por exemplo, algum que estivesse escrevendo como instalar o programa xpto poderia explicar como fazer
isso usando-se o apt-get, o yum e o pacman. A razo dessa recomendao que a sintaxe dos comandos e o nome
dos pacotes, bem como suas dependncias, podem variar em cada um desses grupos.

Caso o pacote esteja em um repositrio prprio, o autor dever pesquisar se existem repositrios para diferentes
tipos de distribuies (ex: Ubuntu e Fedora) e explicar como ativ-los em cada um dos seus sistemas. Se o pacote
estiver disponvel nica e exclusivamente em um PPA, o autor dever dar essa informao e alertar que sua
incluso em sistemas Debian poder causar conflitos ou reaes inesperadas.

Se o desenvolvedor fornecer apenas os pacotes para instalao diretamente em seu site, sem repositrios, o autor
dever explicar como instal-lo usando os comandos locais do sistema. Recomenda-se explicar, no mnimo, a
instalao atravs dos comandos dpkg e rpm, se disponveis pelo desenvolvedor nesses formatos, bem como
alertas sobre eventuais problemas de dependncia.
Execuo de comandos

A maioria dos comandos utilizados para automatizar tarefas est disponvel na maioria das distribuies. Dessa
forma, convm que o autor evite se referir a uma distribuio especfica, por exemplo: No Unity, digite terminal para
abrir o console e digite. Ao invs, seria interessante explicar como abrir o terminal no Unity, no KDE, no GNOME,
no XFCE e no Mate e, ento, comear a explicao sobre os comandos. Exceo feita se aquele comando estiver
disponvel apenas para determinada distribuio, fato que dever ser mencionado.

Edio de arquivos de configurao

Se o tutorial ou o artigo envolverem a edio de arquivos de configurao de um determinado programa, seu autor
dever pesquisar a localizao desse arquivo nas principais distribuies mainstream, podendo ser uma que utilize
deb, uma que utilize rpm e uma que utilize outro gerenciador de pacotes. O motivo dessa recomendao que,
muitas vezes, a localizao de tais arquivos pode variar de um sistema para outro e o leitor pode ficar perdido se
no encontr-lo onde o tutorial diz que ele deveria estar.

Programas grficos

Se o artigo ou tutorial possuir capturas de tela de um programa grfico, a decorao da janela dever ser
configurada de forma distinta daquela que seja padro do sistema. Alm disso, a captura dever ser da janela ativa
e no da rea de trabalho completa. O motivo dessa recomendao evitar induzir inconscientemente o usurio a
usar ou a migrar para a distribuio indiretamente identificada pela decorao presente na imagem. A exceo se d
quando o objeto do artigo for uma anlise da distribuio em si ou um programa especfico para ela.

Softwares proprietrios

Se o tutorial cobrir a instalao ou a utilizao de um software proprietrio, o mesmo dever mencionar a existncia
de softwares livres equivalentes a ele, sem prejuzo dos itens anteriores. Por exemplo: se o tutorial cobrir a
instalao do Google Earth, o Marble poder ser mencionado. Tambm desejvel que, posteriormente, seja escrito
um tutorial sobre a instalao do software livre equivalente apontado.

Programas especficos para uma determinada distribuio

Se o artigo ou tutorial cobrir um programa que s exista para uma determinada distribuio, o autor dever
mencionar esse fato e pesquisar outros programas livres que tenham a mesma finalidade e que estejam disponveis
para outros sistemas.

Ao seguir essas recomendaes, acredito que nossa blogosfera especializada se tornar menos dependente de
uma distribuio criada por uma empresa e mais inclusiva em relao aos usurios que encontraram seu caminho
atravs de outros sistemas.