Estrutura e conteúdo do curso.

[lflimeira]

Vamos utilizar essa issue para organizar o conteúdo e estrutura do curso de PHP.

[wilcorrea]

O ideal para ter uma estrutura bem organizada é ter como dividir o curso em pelo menos dois níveis.
Nível [Básico]

• Capítulo [Estruturas de Controle] (módulo, tópico)

[wilcorrea]

Podemos usar branches para o Nível e Pastas para os Capítulos para tentar manter tudo em um repositório só

[lflimeira]

Então a ideia de deixar em branch os capítulos era para facilitar o download, vamos supor que eu queira baixar apenas um capitulo, ai separando em branchs seria possível. E se colocássemos os níveis de complexidade em um sumario no Readme? Exemplo:
No readme ficaria.

PHP Básico:

• capitulo 1
• capitulo 2
  ...

PHP Avançado:

• capitulo 10
• capitulo 11
  ...

O que vc acha @wilcorrea ?

[preetender]

@lflimeira acho que ficaria muito bom seu estilo de organização, seria de fácil entendimento e facilitaria nas buscas.

• PHP Básico
  • Capítulo
    • Parte Teórica
    • Exemplo Prático

[wilcorrea]

@lflimeira a ideia de separar assim é interessante para download se o cabra for baixar através de git. Se for para gerenciar como um livro dá um pouco mais de trabalho. Aqui https://github.com/phpzm/php-like-a-boss eu montei um arcabouço que vira pdf, epub, mobi e/ou git book no ghpages.

É bom a gente pensar no formato de distribuição para não ter que ficar batendo cabeça depois com merge de várias branches para a master para publicar as tretas.

[danilosilvadev]

Uma sugestão pode ser através de projetos.
Ex: tipo: hello world ae tinha os exemplos explicados em php, java, js etc
CRUD: java, php, js etc e assim vai
os conceitos em si podia ter link dos docs e/ou materiais grátis q já dao a teoria, tem teoria demais na net ja e muito curso parecido
Ae podia ter uns exercícios/desafios e o gabarito em algum lugar/fórum de discussão/video aula respondendo sei la vcs q sabem.

[lflimeira]

@preetender, @danilosilvadev e @wilcorrea todas as ideias são boas, acho que seria legal propor as estruturas la na openschoolbr/forum#9 e abrir uma votação. Eu realmente achei que a estrutura do @wilcorrea faz mais sentido para distribuição, a pessoa n precisaria saber git para consumir o curso.

[oliveiraev]

Quando li a proposta de capítulos em branches fiquei meio "wtf?!" mas, com o desenrolar da thread eu entendi a motivação e achei bem bacana.

se entendi direito a preocupação do @wilcorrea, pode-se ou definir uma convenção de nomenclatura ou fazer a "junta" de forma automatizada.

Fiz um fork e adicionei arquivos em branco como exemplo.
https://github.com/oliveiraev/curso-php

Vale lembrar que esse formato não impede em nada que o conteúdo também seja organizado por diretórios.

[lflimeira]

@oliveiraev o @wilcorrea havia dito que essa estrutura prejudicaria a criação do Git books. Ele ficou de demonstrar a estrutura que ele pensou aqui e fazer um vídeo explicando como seria o fluxo, vamos esperar ele fazer aí mostramos para a galera o seu exemplo e o dele para ver qual atende o que precisamos 😄

[khaosdoctor]

Eu acho que se for dividido por branch vai ser legal, mas vamos ter um problema. Se o cara atualizar ou adicionar um novo capítulo, vamos ter que atualizar o Readme de todos os branches. Porque nele vai ter que ter as coisas de todos não é?

[kvnol]

vamos ter que atualizar o Readme de todos os branches

Por isso que é legal o adm do curso já saber quantos capítulos terão os cursos, para que todas as pastas e readme já sejam, previamente, criados.

[lflimeira]

Mas essa ideia de Branch que está em votação na issue de estrutura, meia que foi deixada de lado já, não?

[oliveiraev]

Eu acho que se for dividido por branch vai ser legal, mas vamos ter um problema. Se o cara atualizar ou adicionar um novo capítulo, vamos ter que atualizar o Readme de todos os branches. Porque nele vai ter que ter as coisas de todos não é?

na minha opinião, apenas o branch master deveria ter README.
Se o cara se dá ao trabalho de navegar até o repositório, selecionar da lista de branches o capítulo que ele quer para, só então, fazer o download do conteúdo segmentado, não é a falta do README que vai ser um problema.

O README tem que conter informações relevantes pra quem "cai de pára quedas" no repositório e não sabe onde está, pra que serve, como se orientar, etc.

[khaosdoctor]

na minha opinião, apenas o branch master deveria ter README.
Se o cara se dá ao trabalho de navegar até o repositório, selecionar da lista de branches o capítulo que ele quer para, só então, fazer o download do conteúdo segmentado, não é a falta do README que vai ser um problema.

Não é nem por isso, é mais para o cara navegar de um capítulo até outro quando ele está fora da master...