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: