Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Detalhar o formato do documento #5

Open
josenaves opened this issue Dec 7, 2017 · 3 comments
Open

Detalhar o formato do documento #5

josenaves opened this issue Dec 7, 2017 · 3 comments

Comments

@josenaves
Copy link
Member

Como será organizado o documento?

Quais seções teremos - Introdução, Ambiente de desenvolvimento, React Core, Styles, etc...

Usar um grande arquivo ou quebrar cada issue num arquivo separado ?

Definir estilo de formatação do documento.

@rafaellincoln
Copy link
Member

Acho que seria legal usar o README.md como index e criar um sistema de pastas para as seções, e fazendo link entre as documentações, para evitar duplicar informações e evitar contradições.

Quanto as seções podemos ir criando de acordo com a necessidade, mas começar com uma estrutura padrão parecida com:

  • Introdução
    • Instalação
      • Windowns.md
      • Linux.md
      • Mac.md
    • Dicas
  • Styles
  • Bridge
  • Redux

Quanto ao estilo de formatação, podemos seguir a documentação do JavaScript Style da Airbnb.

@josenaves
Copy link
Member Author

@rafaellincoln Só uma coisa - sobre estilo de formatação - estava me referindo ao documento em si (seções, h1, h2, etc)... e não a formatação de código (estilo).

@rafaellincoln
Copy link
Member

@josenaves Sim, eu me referi a isso, a gente seguir o padrão (h1, h2, etc..) que eles utilizam na documentação, e não o javascript em si.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants