Discussões Gerais & Esclarecimento de Dúvidas

[ednilsonamaral]

Olá pessoal, tudo blz?!

Tomei a liberdade de criar essa issue para centralizarmos todas as dúvidas e discussões em relação a tradução da documentação da v2 do ionic, como estrutura, como fazer X ou Y, etc.

Assim podemos trabalhar tudo em uma issue só e tirarmos as dúvidas e esclarecimentos a todos.

Se for proibido essa issue, só fechar!

Vaaleu! :)

[ednilsonamaral]

A estrutura a ser cirada nesse repositório seguirá a mesma da documentação oficial?

Uma sugestão de árvore de diretórios:

ionic-2-docs
--| chapters
----| 01-get started
------| 01a-welcome-to-ionic.md
------| 01b-installation.md
------| (...) e assim por diante
----| 02-components
------| 02a-overview.md
------| 02b-actions-sheeds
------| (...) e assim por diante
----| 03 (...) e assim por diante
--| img
-- README.md -> com o sumário, um texto de como contribuir, algumas informações importantes, licença dos códigos, etc..

Definindo a árvore, já podemos criar toda a estrutura, quem for traduzindo os conteúdos, já vai nomeando os arquivos da forma correta e colocando no local indicado, pra já irmos mantendo organizado e tudo no lugar desde o começo..

O que vocês acham?

[reiwolf]

Salve, Ednilson !

Eu achei interessante ter um padrão para trabalhar, assim tbm fica mais
fácil encontrar o material.

Parabéns pela iniciativa.
Em 16/02/2016 17:26, "Ednilson Amaral" notifications@github.com escreveu:

A estrutura que você vai criar nesse repositório seguirá a mesma da
documentação oficial? Quem vai delegando X ou Y será quem?

Uma sugestão de árvore de diretórios:

ionic-2-docs
--| chapters
----| 01-get started
------| 01a-welcome-to-ionic.md
------| 01b-installation.md
------| (...) e assim por diante
----| 02-components
------| 02a-overview.md
------| 02b-actions-sheeds
------| (...) e assim por diante
----| 03 (...) e assim por diante
--| img
-- README.md -> com o sumário, um texto de como contribuir, algumas
informações importantes, etc..

Definindo a árvore, já podemos criar toda a estrutura, quem for traduzindo
os conteúdos, já vai nomeando os arquivos da forma correta e colocando no
local indicado, pra já irmos mantendo organizado e tudo no lugar desde o
começo..

O que vocês acham?

—
Reply to this email directly or view it on GitHub
#9 (comment)
.

[ednilsonamaral]

Opa, vaaleu @reiwolf !! Eu acompanho a tradução do eloquent javascript e é possível notar que o conteúdo é fácil de encontrar tudo e tal.. pensei que poderiamos fazer algo do tipo aqui, pra que fique de fácil entendimento para qualquer pessoa que queira aprender ionic!!

[gabrielclima]

Boa ideia @ednilsonamaral

Uma outra coisa que pensei, por que a gente não usa o serviço de página do GitHub? Aí gente iria alterar por aqui e refletir diretamente no site.

Eu acho, que como vai ser uma coisa pra um público inteiro, a gente ficaria meio limitado aqui no GitHub. Em questão da pessoa ter que entrar aqui pra ler, entender como ficou a organização, além de ser mais chatinho também, no sentido de ficar mudando de pasta em pasta, arquivo por aquivo para poder ler algo. Outra questão também é que nós não ficaríamos limitados ao Markdown do GitHub para escrever nossa tradução. Teríamos a liberdade de ter nossa própria página.

Eu não acho difícil de fazer não, se vocês toparem, eu posso até criar o modelo da página e subir, criar um exemplo também das sections da tradução. E depois todo mundo ir seguindo.

Se você não souber o que eu tô falando, ou se estou me expressando de forma meio embolada haha, eu posso explicar melhor.

=)

[reiwolf]

Apoio a idéia de padronização, afinal, estamos falando de rede mundial e
quanto mais padronizado, mais fácil para os vários tipos de usuários.
Em 16/02/2016 19:11, "Gabriel Lima" notifications@github.com escreveu:

Boa ideia @ednilsonamaral https://github.com/ednilsonamaral

Uma outra coisa que pensei, por que a gente não usa o serviço de página do
GitHub? Aí gente iria alterar por aqui e refletir diretamente no site.

Eu acho, que como vai ser uma coisa pra um público inteiro, a gente
ficaria meio limitado aqui no GitHub. Em questão da pessoa ter que entrar
aqui pra ler, entender como ficou a organização, além de ser mais chatinho
também, no sentido de ficar mudando de pasta em pasta, arquivo por aquivo
para poder ler algo. Outra questão também é que nós não ficaríamos
limitados ao Markdown do GitHub para escrever nossa tradução. Teríamos a
liberdade de ter nossa própria página.

Eu não acho difícil de fazer não, se vocês toparem, eu posso até criar o
modelo da página e subir, criar um exemplo também das sections da tradução.
E depois todo mundo ir seguindo.

Se você não souber o que eu tô falando, ou se estou me expressando de
forma meio embolada haha, eu posso explicar melhor.

=)

—
Reply to this email directly or view it on GitHub
#9 (comment)
.

[gabrielclima]

Olhem, eu comecie a testar. Seria mais ou menos isso:

Aqui fica o site: gabrielclima.github.io
Aqui fica o código: github.com/gabrielclima/gabrielclima.github.io

Assim que a gente edita, ele atualiza lá.
Eu penso até em fazer mais do que só a parte da documentação, penso em deixar essa página, com se fosse nossa página da comunidade Ionic Brazil mesmo. E aquelas caixinhas embaixo como se fossem nossos projetos.

Mas pra isso, eu tenho que saber do @juarezpaf se ele autoriza. Se ele autorizar, eu faço.

[lazaromenezes]

Concordo com o @gabrielclima na ideia de que a tradução fique em uma página do próprio github.

[ednilsonamaral]

@gabrielclima boa ideia cara. O GitHub Pages eu já conheço, é bom sim.. tem também a Wiki do GitHub e o GitBook. Esse último eu acho mais adequado ao nosso propósito. Um exemplo de gitbook é o workflow front-end do tapmorales, que tem o repositório e o gitbook..

[gabrielclima]

@ednilsonamaral obrigado!

Olha esse SendGrid Docs.
Achei até mais parecido com o site da documentação original. E esse nem é tão estático.

[dersonsena]

Galera, bom dia! Estou acompanhando aqui a discussão mas estou com alguns projetos aqui e estou um pouco apertado, mas, o que for decidido estou dentro. Abraços a todos e obrigado pelo convite de participar!

[ednilsonamaral]

@gabrielclima legal esse SendGrid cara. Realmente fica bem parecido com a documentação oficial. Ele aceita arquivos em markdown?

Acho que desenvolvermos a tradução já em markdown, fica mais fácil e mais rápida, fica visível tanto no github como em um gitbook, por exemplo..

O que vocês acham?

[gabrielclima]

Galera, primeiramente peço imensamente desculpas a todos aqui e principalmente ao @juarezpaf por ter todo tomado decições sem realmente tudo ficar alinhado.

Eu criei a página, como se fosse um portal pro nosso repositório, ela está aqui ionicbrazil.github.io e ela se encontra num repositório que fiz aqui dentro da nossa organização que é esse github.com/IonicBrazil/ionicbrazil.github.io.

Aí criei também a branch gh-pages nesse repositório mesmo (github.com/IonicBrazil/ionic-2-docs/tree/gh-pages), ele contém o código que faz a página da documentação, que está aqui ionicbrazil.github.io/ionic-2-docs/.

Essa seria a ideia completa =) subi esse outro, diferente do SendGrid, pq me pareceu mais leve, como eu ia dar só o exemplo mesmo.

Peço desculpas a todos novamente pela atitude precipitada.

=)

[ednilsonamaral]

Tuas ideias foram ótimas @gabrielclima !! Não sei qual o padrão aqui, se cria um repositório aqui mesmo pra mostrar a ideia ou cria no nosso user e linkamos na issue, não sei como é aqui. Legal seria fazermos uma pequena enquete para definirmos qual o tipo que iremos desenvolver a tradução, assim, com o resultado, é "pau na máquina" e fazer essa tradução.. :D