[FUGSPBR] Documentacao.

[Mauricio Vieira]

Ola,

boa ideia a divisao em 3 tarefas principais:
 o Traducao
 o Escrita
 o Revisao

mas acho que a etapa de traducao e escrita podem ser feitas ao mesmo tempo, pois
o que teremos serao textos em sgml em ingles e a traducao pode ser direto no
sgml. depois da etapa de traducao, os _organizadores_ (chamei de cabecas no meu e-mail anterior sobre isto. cabecas = cabecas_de_chave), dividiriam em equipes 
de revisores. nao precisa nem saber muito docbook para traduzir.

ja tive a experiencia de ajudar a revisar uns sgml do projeto debian-br. 

nao conheco nenhuma ferramenta que faca o inverso, mas nao tenho certeza de que
nao existe. a ideia de escrever em sgml (ou xml) é que  a padronizacao
que foi feita para a especificacao destes formatos nao tenha sido em vao (eles
fizeram um bom trabalho, o resultado é o uso amplo hoje).

acredito que aprender docbook seja realmente necessario apenas para colocar os
howto escrito por este pessoal (que estava na mesa-redonda sobre padronizacao e
que eu acho que deveriam ser os organizadores principais: Edson Brandi, Gamk, 
Vinis e outros [foi mal, só lembro o nome destes 3] ) no formato padrao de
documentacao. assim, os howto/mini-howto made-in-br entrariam nas distribuicoes
como documentacao oficial tbm (alem da traducao da documentacao atual). 

Alguem sabe maiores informacoes sobre como incluir documentacao adicional na
release?

Estou disposto a dedicar 2 a 4 horas por semana (uma manha/tarde de 
sabado/domingo ou dividindo todos os dias em casa) neste projeto, mas assumo que
nao tenho capacidades para encabecar algo assim.

On Thu, Aug 23, 2001 at 12:55:02PM -0300, Patrick Tracanelli wrote:
> Ola a todos.
> Tambem estou disposto a contribuir de forma efetiva com a doc brasileira do
> sistema... como alguns sabem eu tenho alguma coisa em andamento ja... acho
> mesmo que uma lista especifica eh o primeiro passo, ja que ninguem que nao
> for participar da documentacao eh obrigado a receber emails sobre isso ;)
> 
> http://www.FreeBSD.org/tutorials/docproj-primer/index.html
> 
> Acho que vale a pena dar uma olhadinha na URL ai em cima...
> Acho que deveriamos ja comecar a organizar isso... primeiro, quem tem alguma
> experiencia aqui com sgml ou DocBook? Pelo que da pra ver DocBook eh cheio de
> Tags, eh mais chatinho que o usual criar documentos no modelo, entao eu tava
> pensando em dividir o trabalho efetivo da documentacao e traducao, e algumas
> pessoas pra revizarem o formato, ou mesmo exportarem de algum formato pra
> docbook...
> 
> http://www.FreeBSD.org/tutorials/docproj-primer/examples.html#AEN3276
> 
> Ai tem um pequeno exemplo do formato DocBook...
> O Jade exporta de DocBook pra outros formatos, sera que ninguem sabe de
> alguma ferramenta que faz o oposto, importa de TeX, PDF ou HTML pra DocBook?
> 
> Vinicius wrote:
> 
> > ONDE PEGAR
> >
> > O QUE VAMOS COMECAR A TRADUZIR
> 
> Eh outra questao que eu tambem quero saber o que ja se tem em mente. Vamos
> 'traduzir' a documentacao ja existente, ou documentar os mesmos assuntos de
> forma propria??? Ou ambos???
> 
> >
> >
> > Carlos, tu que eh o cabeca mano aparece aih pra dar uma luz
> >
> > On Thu, 23 Aug 2001 10:42:39 -0300 (BRT)
> > Diego Linke - GAMK <linke em calnet.com.br> wrote:
> >
> > > Ola
> > >
> > > Opa apoio a ideia de uma lista de discursao a parte :-)
> > > Eh claro que eu estou no projeto de documentacao do FreeBSD :D apesar de
> > > meu ingles ser fraco farei o possivel... :D
> > >
> 
> --
> +---------------------------------------------------------------+---------+
> |              Patrick Leandro Tracanelli do Carmo              | (   )   |
> |             RPGw/IRC Nick -- Eksffa Shyranui Kapwam           | (O_O)   |
> |        Eeviac host FreeBSD 5.0-CURRENT Dual SMP @444Mhz       | \`-'/  w|
> | 4o Ciclo (Fatorial) - Faculdade de Tecnologia de Taquaritinga | (   )__||
> |===============================================================| /m`m\   |
> |       eksffa em fatectq.com.br  -  Fone: (0xx55) 9972-9465       | FreeBSD |
> +---------------------------------------------------------------+---------+
> |Administrador de Redes e Sistemas | BSD Unix, System V & Open Source Syst|
> +---------------------------------------------------------------+---------+
> Long live Hanin Elias, Kim Deal!!!
> ~

-- 
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Mauricio Vieira - <mauricio em unimetro.com.br>
%%
%% Estudante de Ciencia da Computacao - UFBA
%% 
%% FreeBSD 4.3
%% 
%% Estagiario - Equipe de Informatica
%% Unimed Metropolitana - Salvador
%% http://www.unimetro.com.br
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
----
Para sair da lista envie um e-mail para majordomo em fugspbr.org
com as palavras "unsubscribe fugspbr" no corpo da mensagem.