-
Notifications
You must be signed in to change notification settings - Fork 8
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
Estrutura e conteúdo do curso. #1
Comments
O ideal para ter uma estrutura bem organizada é ter como dividir o curso em pelo menos dois níveis.
|
Podemos usar branches para o Nível e Pastas para os Capítulos para tentar manter tudo em um repositório só |
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: PHP Básico:
PHP Avançado:
O que vc acha @wilcorrea ? |
@lflimeira acho que ficaria muito bom seu estilo de organização, seria de fácil entendimento e facilitaria nas buscas.
|
@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. |
Uma sugestão pode ser através de projetos. |
@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. |
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. Vale lembrar que esse formato não impede em nada que o conteúdo também seja organizado por diretórios. |
@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 😄 |
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 é? |
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. |
Mas essa ideia de Branch que está em votação na issue de estrutura, meia que foi deixada de lado já, não? |
na minha opinião, apenas o branch master deveria ter README. 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. |
Não é nem por isso, é mais para o cara navegar de um capítulo até outro quando ele está fora da master... |
Galera, bora começar a discutir sobre o conteúdo do curso. 😄 Vamos definir os assuntos abordados em cada capitulo, e depois começamos a montar um conteúdo. O primeiro capitulo tem que ser de Introdução ao PHP. Ter uma apresentação do curso, mostrar como instalar o PHP (uma coisa que os cursos fazem, é sempre escolher um OS para mostrar a instalação, poderíamos mostrar a instalação nos 3 principais) , falar um pouco da história e evolução do PHP e a ultima versão estável, falar sobre aplicações web a questão cliente/servidor e onde o PHP se encaixa nisso. Esse, para mim, seria o primeiro capitulo. O que vcs acham? |
O que acham de a gente usar esse material aqui como referência
https://github.com/PHProgramando/phprogramando ?
|
Uma parada interessante também é ter uma qualidade visual diferenciada, tipo nesse e-book aqui http://static.umbler.com/news/static/ebook-boas-praticas-nodejs.pdf, ou, algo menos "moderno" como esse cara aqui https://leanpub.com/vuejs2-portuguese |
@wilcorrea podemos pegar como referencia sim, só temos que ver com os autores se eles liberam. Vc acha que no meio do curso, n seria legal colocar um projeto? Mas sem ser um ToDo rsrsrsr Quanto a qualidade visual, eu gostei bastante, acho que pode prender mais a atenção dos alunos e tornar mais agradável. @kvnol, você acho que o pessoal de design conseguiria fazer uma identidade visual para as apostilas? |
Está no Github e é MIT, isso quer dizer que eles esperam que a gente use. Conheço pelo Telegram o pessoal que está trabalhando na apostila, acredito que eles irão gostar da ideia. Criar algo durante o curso é sempre um diferencial. É uma abordagem que me agrada é até a que a gente usa no nosso canal do PHPZM. |
@lflimeira está tudo certo com o pessoal que começou a apostila. Creio que já que a gente tem os dados brutos o primeiro passo agora seja criar o sumário com base nos conteúdos que ele tem, e, em seguida "mergear" com outros conteúdos para chegar a um sumário final. |
@wilcorrea que bom, então vamos usar como base sim. Podemos pegar o sumário deles e colocar aqui e ir modificando. Melhor colocar o sumário lá no gitbooks e vamos alterando, ou colocamos aqui na issue e vamos discutindo? |
Só discordo da abordagem HTTP cliente/servidor. Acho que dá pra ser o capítulo 2. O capítulo 2 explicaria como funciona o protocolo HTTP a diferença entre cliente e servidor (pra tentar explicar de uma vez por todas porque não dá pra fazer um |
Então @oliveiraev o @wilcorrea propôs de seguir esse curso que já existe. https://github.com/PHProgramando/phprogramando Vamos ver os tópicos do curso passado como referência e depois vamos adicionando conteúdo. |
Galera, eu fiz um sumário inicial, o que vcs acham? o que poderia ser inserido no curso? Se tiverem dúvida sobre algum tópico, podem perguntar 😄
|
Top! Vamos colocar isso no repo?! Let's start?! |
Você já pensou em conteúdo? Não dá pra jogar arquivos e imagens pra antes de Programação orientada a objetos? :D |
Legal a estrutura, hoje falta cursos tão completos assim, ainda mais de graça, o que achei mais interessante é a parte do "Fixação do conteúdo do capítulo" normalmente os cursos não tem isso, alguns só... Outra coisa interessante é no andamento ou no final criar um projeto, acho que é muito importante isso.. |
@wilcorrea Qual melhor lugar para colocar? No readme inicial ou já colocar na apostila? @oliveiraev Pode ser, só que para lidar com imagens existem algumas bibliotecas, por isso pensei em POO antes, para dar uma base. @richmanzoli obrigado pelo feedback, o que vc acha melhor o projeto durante o curso ou no final do curso para relembrar e agregar tudo que foi aprendido? |
A gente podia montar um milestone |
@lflimeira na apostila |
cade o curso? |
Boa noite @ReactGirl, estamos desenvolvendo, atualmente fechamos um conteúdo para o curso, e vamos começar a desenvolver capítulo a capítulo. Logicamente que todos podem ajudar. 😄 |
@kvnol obrigado pela aprovação : ) Introduzi alguns textos da apostila do PHProgramando, mas ela não cobre muita coisa da nossa ementa não. Tem que redistribuir e talz, mas fui colocando. |
Como estamos? |
Acho que parados @oliveiraev, eu mexi no final do mês passado e até agora não consegui voltar pro projeto. Estou pensando em ir criar um plano de fazer uns 30 minutos por dia : ) |
Mas foi definida uma estrutura, modo de escrita, fluxo de desenvolvimento da ideia?? Tendo um capítulo de exemplo a gente pode dividir outros capítulos entre quem se prontifica e depois juntar tudo pro time (ou alguém da coordenação) fazer a revisão. |
Aparentemente esse modelo aqui foi aprovado pelo pessoal @oliveiraev eu cheguei a fazer esse cara aqui, mas esbarrei em duas questões:
O pessoal está tendo dificuldades de dar feedback, mesmo o @lflimeira que era uma das pessoas com quem eu estava tendo mais contato tem estado muito atolado e no Slack o feedback tem sido demorado. Estava pensando em:
|
Também sou contra. Apesar de ser justamente a facilidade do PHP de "cuspir" páginas web que seja atraente...
Não entendi a questão sobre padrão de exibição de códigos. A gente consegue incorporar os snippets do próprio github e usar as PSR?
👍 👍 👍 👍 ... Se precisar de ajuda pra dar um suporte em ambientes Windows, abre issues e já me marca como asignee que eu toco.
Pra mim que isso já tava subentendido desde o começo kkkkkkk |
Opa, eae pessoal, então eu submeti o sumário como proposta, podemos alinhar melhor ele de uma forma que faça mais sentido. Estou um pouco parado por causa do trampo novo e organização do PHP TestFest, mas estou de olho aqui ainda rsrsrs Podemos alinhar para fazer um capítulo e depois a galera vai complementando e criando outros capítulos. Qual a sugestão de vcs quanto aos pontos ques vcs levantaram @wilcorrea e @oliveiraev? |
Podem mandar um PR com a proposta, assim já vamos discutindo nele e tiramos a ideia daqui. |
E se a gente recebesse o conteúdo/material e depois fizesse a "curadoria" com code-review, análise gramatical e discussão a respeito do que pode ser quebrado em outros capítulos?? Eu, particularmente, acredito que é mais fácil se basear em algo concreto, palpável do que a gente ficar discutindo toda a ementa de cabo a rabo, se HTTP tem que ser ou não o primeiro capítulo antes da primeira linha de conteúdo relevante realmente aparecer. A gente montaria apenas um fluxo de "aceite" de pull requests. Alguém manda um capítulo, ele é revisado gramaticalmente, a gente delibera sobre o conteúdo e um head do projeto aceita ou não a PR. Desviando sem desviar, o que vcs acham do PHP do jeito certo? |
Esse fluxo já foi definido @oliveiraev, na verdade o projeto deu uma parada na questão de enviar conteúdo, já está disponível para enviar, quem quiser contribuir pode contribuir 😁 Acho realmente válido gerar conteúdo e depois nós reorganizamos isso. Quanto ao PHP do jeito certo eu n entendi muito bem sua pergunta, em qual sentido? Mas eu acho um material muito bom e necessário. |
Vamos utilizar essa issue para organizar o conteúdo e estrutura do curso de PHP.
The text was updated successfully, but these errors were encountered: