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

Sugestão de estrutura #9

Closed
yuriploc opened this issue Aug 3, 2017 · 46 comments
Closed

Sugestão de estrutura #9

yuriploc opened this issue Aug 3, 2017 · 46 comments

Comments

@yuriploc
Copy link

yuriploc commented Aug 3, 2017

Migrando da #2:

Wrapping up e sugerindo:

Pré-trilhas

  • Matemática divertida {repo}
  • Introdução a Lógica {repo}
  • Introdução a Estrutura de Dados {repo}
  • Introdução a Algoritmos e Complexidade {repo}
  • Paradigmas e abordagens (objetos, funcional) {repo}
  • Git / GitHub

Trilhas

  • Backend (PHP, JS, Ruby, Python [, Java, Scala])
    - BD SQL (PostgreSQL, MySQL, MariaDB) {repo}
    - BD NoSQL (MongoDB, Cassandra) {repo}
    - DevOps {repo}
    - Servidor {daqui pra baixo pode-se usar um repo para cada linguagem}
    - Frameworks
    - Testes
    - Design Patterns
    - Server-side Rendering (templates)

  • Frontend
    - HTML5 / CSS3 / Pré-processadores {repo}
    - UX {repo}
    - Design Patterns {repo, pode ter um repo por linguagem}
    - Melhores Práticas (do momento/atuais/atemporais) {daqui para baixo pode ser um repo por linguagem}
    - Linguagens e seus ecosistemas/frameworks (JS [, TypeScript, Elm, PureScript])
    - Testes

Como organizar

Sugestão de #5 (comment)

  • Cada curso de cada trilha (ex: backend-php ou frontend-elm) tem um repositório próprio
  • Cada tópico do curso tem um branch
  • Um branch que agrupe todos os outros (merged) para quem quiser baixar tudo de uma vez
@muniz95
Copy link
Member

muniz95 commented Aug 4, 2017

Eu voto por cada curso ter um branch.

Justificativa: suponhamos que um curso tenha 15 capítulos e eu queira os fontes do capítulo 9. Se os fontes estivessem separados por pastas eu teria que baixar/clonar o repositório todo pra ter só uma pasta; na separação por branch eu pego só o branch que me interessa.

Além disso, pensem na seguinte hipótese: um curso de CSS que, no capítulo 3, aborde pré-processadores. Podemos ter quantos branches quisermos pra esse capítulo (cap03-sass, cap03-postcss, cap03-compass, etc). É minha ideia ao menos.

@kvnol
Copy link
Contributor

kvnol commented Aug 4, 2017

Eu concordo com o @muniz95 e acho que a sugestão de ter um capítulo por branch é válida.

@lai32290
Copy link

lai32290 commented Aug 4, 2017

A ideia do @muniz95 por inicio achei meio maluco, mas no fim me convenceu, acho que daria pra tentar separar pelo branch sim, não parece ser tão ruim.

@lai32290
Copy link

lai32290 commented Aug 4, 2017

Como já temos uma org openschoolbr, acho que cada curso seja um repositório novo, talvez pode ser uma opção também.

@muniz95
Copy link
Member

muniz95 commented Aug 4, 2017

@lai32290 isso mesmo, eles seriam como os repositórios que já existem aqui hoje.

A diferença é que eles teriam os tópicos indicando que são cursos, pra ter uma diferenciação mais clara.

@lai32290
Copy link

lai32290 commented Aug 4, 2017

@muniz95 show! =D

@lflimeira
Copy link
Member

Galera quanto ao conteúdo em si seria válido colocar frameworks para backend tbm não?

@yuriploc
Copy link
Author

yuriploc commented Aug 4, 2017 via email

@yuriploc
Copy link
Author

yuriploc commented Aug 4, 2017

Pessoas, poderíamos estipular um prazo (domingo, 2017-08-06, por exemplo) pra decidirmos o "macro" das trilhas e estrutura e começarmos a produzir os conteúdos.

O que acham?

@lflimeira
Copy link
Member

Acho que seria uma boa definir um prazo e começar a colocar a mão na massa.

@lai32290
Copy link

lai32290 commented Aug 5, 2017

Acho que o curso de Ionic 3 que já tem quase pronto, daria pra ser usado como um ponto de partida.

@kvnol
Copy link
Contributor

kvnol commented Aug 5, 2017

No mesmo padrão de separar as branchs para os módulos, seria legal um padrão de escrita para o nome dos repositórios e branchs, certo? Conversando com o @lflimeira e @wilcorrea achamos o hífen mais bonito que o underscore para o nome dos repositórios, mas para as branchs usaríamos o underscore.

O que acham?

@lflimeira
Copy link
Member

E ter um curso- na frente em todos os repositórios relacionados a curso. Ex: curso-PHP

@kvnol
Copy link
Contributor

kvnol commented Aug 5, 2017

E no caso do curso-PHP, o PHP será minúsculo ou maiúsculo? Lembrando que em casos de ramificações ficaria curso-PHP-Laravel.

Eu acho tudo minúsculo melhor visualmente.

@lflimeira
Copy link
Member

Boa @kvnol, criei minusculo.

Galera, eu tomei a liberdade de criar o primeiro para dar um start, mas o que ficar definido depois, nós alteramos para entrar no padrão.

https://github.com/openschoolbr/curso-php

@muniz95
Copy link
Member

muniz95 commented Aug 5, 2017

Eu pensei em colocar nos tópicos uma tag #curso, mas acho que com prefixo no nome do repo fica melhor

@lflimeira
Copy link
Member

@muniz95 o que vcs decidirem que fica melhor eu mudo la :)

@kvnol
Copy link
Contributor

kvnol commented Aug 5, 2017

@muniz95 fica melhor com o prefixo pq senão confunde com nossos repositórios institucionais, mas da mesma forma será utilizado a tag

@danilosilvadev
Copy link

danilosilvadev commented Aug 5, 2017

Eu acho q quanto mais simples e objetivo melhor. Quanta menas informação e mais conteúdo melhor. Acho q aquelas trilhas tem linguagens demais, conteúdos demais e pretensões demais. Parece uma tonelada de teoria e informação copiada da internet, sendo que vcs vao fazer no seu tempo livre. Daqui pra q termine e fique com qualidade, n sei n. Nas atuais condições n tem como oferecer algo melhor q os standarts w3schools, mdn, docs, video-aulas, codecademy, freecodecamp etc... Então melhor seria focar numa opção de oferecer algo q eles focam menos que seriam os projetos, os exemplos e etc. Bom né, eu n sei como q vao fazer, mas sei que mais do mesmo não me agradaria como aluno do curso. Acho q deveriam passar um ou dois meses só discutindo ideias e pesquisando até chegar numa conclusão. Boas ideias levam tempo e esforço para serem aprimoradas.

@kvnol
Copy link
Contributor

kvnol commented Aug 5, 2017

Exercícios para cada aula são essenciais e podemos fazer como nos cursos do @fdaciuk, com a diferença que os próprios alunos poderiam fazer o code review (alguém citou essa ideia, mas esqueci quem foi - pronuncie-se).

@lflimeira
Copy link
Member

Galera, para fecharmos essa discussão quanto a estrutura dos cursos, vamos fazer algumas proposta e fechar uma votação? O @wilcorrea propôs uma estrutura para utilizarmos git books como no exemplo que ele citou https://github.com/phpzm/php-like-a-boss, ele citou isso lá na issue openschoolbr/curso-php#1 . Eu acho uma boa ideia, e uma estrutura bacana. Acho que o @wilcorrea pode explicar melhor sobre ela.

Pois com isso definido, podemos continuar com as estruturações de conteúdo de cada curso.

O que vocês acham?

@wilcorrea
Copy link

wilcorrea commented Aug 5, 2017

Apenas para esclarecer, a proposta é a seguinte:

  • Cada curso é um repositório e os nomes dos cursos em minusculo e com hífen iniciando com o prefixo curso;
  • Cada repositório seria versionado de acordo com os envolvidos e as branches principais seriam sempre a develop e a master
  • O repositório teria uma estrutura semelhante a citada acima (https://github.com/phpzm/php-like-a-boss) para ser publicada no GH Pages com certa facilidade e publicado como PDF, ePUB e MOBI. No GH Pages fica assim https://phpzm.github.io/php-like-a-boss/
  • Capítulos e/ou módulos são organizados pelo índice
  • Os materiais que tiverem conteúdo em vídeo poderão ter referências para esses conteúdos, e, vice-versa, onde um poderia complementar o outro

PS.: os processos de builds ficam automatizados https://github.com/phpzm/php-like-a-boss/blob/master/package.json#L26

@yuriploc
Copy link
Author

yuriploc commented Aug 5, 2017

Acho essa estrutura muito boa, @wilcorrea @lflimeira. Permite que usuários sem conhecimento de git façam uso do material e que a gente possa distribuir com bem mais facilidade.

@oliveira-julio
Copy link

@yuriploc a Pré-trilha poderia como usar como base o livro How to Design Programs( htdp), que tem como uma das propostas ser introdutório de programação. É bem didático, e usa o paradigma funcional (mesmo sem dizer que tá usando). A estrutura do livro também é bem interessante, tendo bastante exercícios para cada conceito apresentado. O livro foca tanto no ensino da teoria, quanto na produção de um bom código, mas de forma bem simples . Ele usa uma ideia chamada Design recipe que é uma grande ajuda para quem tá iniciando ( ou mesmo para quem já é familiarizado com programação).
Link: http://www.htdp.org/

@wilcorrea
Copy link

@lflimeira o que acha de dar o setup lá no repositório para ficar mais fácil de apresentar pra o pessoal como que vai ficar?

@houstondapaz
Copy link

@wilcorrea só uma coisa a adicionar, cada modulo/capitulo ter uma branch, só com o seu conteúdo, de resto acho q está ótimo

@rlage
Copy link

rlage commented Aug 6, 2017

Análise de sistemas, processos de software deveriam estar na pre-trilha?

@wilcorrea
Copy link

@houstondapaz podemos tentar ; )
De início me parece pouco vantajoso por alguns fatores:

  • Para alternar entre módulo/capítulo individualmente seria preciso encerrar o que está fazendo em um para alternar entre as branches;
  • Juntar todo o conteúdo em uma branch para publicar vai exigir que o cabra mange de merge e talz na hora de fazer o trabalho (uso git em equipes de 5/6 devs e sei que nego faz commit em branch errada, tem que fazer cherry-pick, revert.. é o Ó, rs)
  • Vai ser complicado rastrear mudanças porque elas vão estar sempre dispersas em branches variadas e um simples reparo vai fazer com que seja preciso identificar a branch correta (nem os plugins de "edit on github" poderão ser usados porque na prática a branch principal tem que ser "readonly"

Fiquei pensando sobre essa abordagem desde que vi a ideia pela primeira vez no Telegram, e, confesso que só vi essas desvantagens e nenhuma vantagem (já que a que teria seria poder fazer checkout de uma branch em separado e o foco seria distribuir a apostila em formatos que o cara possa ver no celular no busão, por exemplo)

Caso tenha dito alguma bobagem ai ou tenham percebido vantagens na divisão em branches, por favor deixem-me saber : )

@yuriploc
Copy link
Author

yuriploc commented Aug 6, 2017

@juliooliveiracosta acho a ideia bem interessante, tem que ser fechada com o grupo que ficar responsável pela pré-trilha :)

@oliveira-julio
Copy link

@yuriploc Ok ^^ .

@lflimeira
Copy link
Member

@wilcorrea Eu acho valido criar essa estrutura la no PHP para mostrar. Se todos concordarem podemos fazer isso. 😄

@juliooliveiracosta o conteúdo do curso tem que ser discutido com o grupo que ficar responsável como o @yuriploc falou, mas a estrutura em que o curso vai ser construído tem que seguir o padrão que for resolvido 😃

@wilcorrea
Copy link

@lflimeira vô criar hoje a noite então, faço um vídeo e subo mostrando como que ficaria e fluxo de trabalho.

@erandirjunior
Copy link

fiz um curso de php alguns anos atrás, se a estrutura ajudar em alguma coisa: https://github.com/fsoaresjunior/curso-PHP5

@lflimeira
Copy link
Member

Boaa @wilcorrea ai colocamos no sobre o link para o vídeo e assim todos podem entender. 😄

Depois podemos começar a organizar o conteúdo do curso do PHP e ai vamos alinhando, quando isso estiver pronto, montamos o material e depois partimos para os videos. \o/

@lflimeira
Copy link
Member

Galera o @wilcorrea montou a estrutura lá no repositório de PHP https://github.com/openschoolbr/curso-php deem uma olhada, e depois digam o que vocês acham. Pois o quanto antes definir a estrutura melhor, pois podemos começar a focar nos conteúdos e desenvolvimento dos cursos. 😄

@yuriploc
Copy link
Author

yuriploc commented Aug 10, 2017 via email

@lflimeira
Copy link
Member

Será que vale abrir uma votação @yuriploc ?

@yuriploc
Copy link
Author

yuriploc commented Aug 10, 2017 via email

@lflimeira
Copy link
Member

Boa @yuriploc, acho que essa questão de deixar acessível é o mais legal da proposta.

@lflimeira
Copy link
Member

Deixem a opinião de vcs e se aprovam ou não a estrutura proposta pelo @wilcorrea no repositório https://github.com/openschoolbr/curso-php. 😄

@wilcorrea
Copy link

Com essa estrutura ai temos até um hot reload na hora de escrever os conteúdos
Voto nela
: )

@lflimeira
Copy link
Member

Eu curti e voto para que seja essa estrutura 😄

@kvnol
Copy link
Contributor

kvnol commented Aug 10, 2017

Eu curti muito. Gitbook é lindo! ♥

@larismourullo
Copy link

Gitbook lindo, gostei 💯

@wilcorrea
Copy link

♥ to all

@lflimeira
Copy link
Member

Galera, já que ninguém se opôs a estrutura apresentada pelo @wilcorrea, essa será a estrutura padrão utilizada por hora. Podemos seguir com as construções de proposta dos cursos seguindo essa estrutura. 😄

Já que foi definido, vou fechar essa issue.

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