Utilizador:Raylton P. Sousa/GSoC

Origem: Wikilivros, livros abertos por um mundo aberto.

Esse ano eu sou o mentor no Google Summer of Code 2012 e vou tentar auxilia-lo na tarefa de criar uma maneira de tornar o manuseio de livros mais simples aqui no Wikilivros e também no Wikisource. Desejem-me sorte!

Links úteis[editar | editar código-fonte]

Tarefas[editar | editar código-fonte]

Antes da codificação[editar | editar código-fonte]

  • Ler documentação(imediatamente)(em andamento)
  • Explicar como será o meu envolvimento, qual o meu nível de conhecimento, tempo etc.
  • Apresentar o aluno para as pessoas que terão envolvimento fundamental no projeto e que poderão ajuda-lo caso eu não esteja disponível como Sumana Harihareswara, Gregory Varnum, Helder.Wiki Feito
  • Apontar o aluno para documentações necessárias e para lugares onde ele possa tirar suas dúvidas, irc: #mediawiki lista: Wikitech-l e outros Feito
  • Entregar um texto sobre possíveis implementações, e dicas.(imediatamente) Feito
  • Conversar sobre a viabilidade das implementações
  • Criar um projeto para comparar com o do estudante... (isso quer dizer deixa-lo livre para inovar e ainda assim propor melhorias que tenho em mente)
    • Criar Wireframes
    • Criar Mockups
  • Ver o apresentação preliminar apresentada pelo estudante e avaliar.(em andamento)
  • Ver projetos de outros estudantes e avaliar(em andamento)

Etapa de planejamento[editar | editar código-fonte]

  • Fazer criticas em privado e elogios em publico
  • Estimular o aluno a fazer perguntas(principalmente inteligentes)
  • Certificar-me de que ele tem um ambiente de desenvolvimento construído e funcionado(inclui LAMP ou XAMP[argh] e acesso a Git/Gerrit).
  • Certificar-me de que ele já enviou a papelada para o google.
  • Certificar-me de que ele leu boa parte ou toda a documentação exigida.
  • Pedir a divulgação do inicio do projeto em diversos canais da comunidade de livros no mundo(para atrair mais olhos para o código)
  • Permitir que ele tenha contato com os editores de livros e de preferencia crie um vinculo.
  • Definição das Métricas de Sucesso - Pedir para que ele faça um relatório e screencast sobre como é a experiencia com livros atual(incluindo, dificuldade de edição e leitura, numero de acessos, numero de editores ativos etc). Para que ao fim do projeto seja possível avaliar o sucesso do mesmo.
  • Design document - Pedir para que faça blueprint, wireframes, mockups.
  • Software design document - Pedir para que defina meticulosamente como pretende implementar cada funcionalidade(techniacal notes).
  • Implementation time plan - Pedir para que refaça o cronograma de implementação com base nos dados obtidos acima.
  • Documentation plan - Pedir para que defina lugares onde vai documentar as configurações, o uso da interface e também pedir que comece a fazer relatórios semanais com o progresso e as dificuldades que enfrentou(estimular tamém que faça relatórios diários para evitar que alguma coisa se perca).

Codificação[editar | editar código-fonte]

  • Avisar aos devs que o aluno vai começar a commitar, pedir atenção extra
  • Explicar que os comentários que os membros da comunidade podem fazer em suas revisões de código, não tem relação a ele como pessoa, e sim ao seu código.
  • Sempre que uma pequena funcionalidade(das dezenas listadas) for finalizada. Deve-se "Testar[1][2]" e "Documentar" e "Comemorar". Tentar arduamente dividir as tarefas em sub-tarefas bem pequenas.
  • Certificar-me que grupos de funcionalidades que não sejam interdependentes possam ser desativadas por meio de configuração(para evitar que um erro em uma parte do código prejudique toda a implementação, e empeça o seu ativamento nos sites wikimedia)
  • Apresentar avaliações intercalares do progresso do estudante.(Caso o progresso seja ruim o estudante será excluído, que é improvável)
    • Redefinir metas e planos de acordo com o progresso, viabilidade etc.
  • Estimular o estudante a também fazer seus próprios relatórios de progresso e a sua de sua relação com o mentor e com a comunidade.
  • Supervisionar implementação e dar qualquer suporte.

Depois da codificação[editar | editar código-fonte]

  • O projeto deve estar pronto com uma semana de antecedência para que se possa dar um polimento e correções antes da entrega... Essa é também umas das fases para incentivar o aluno a continuar contribuindo com a comunidade.
  • Fazer avaliação final que deverá dizer se as metas foram cumpridas.(em caso negativo o estudante não receberá mais nada do google)
  • Se tudo der certo. Mandar o aluno para apresentar amostra de códigos para o Google. Pegar a camiseta do GSoC. Certificar-me que o estudante foi pago. Agradecer a todos e curtir a natureza =D

Pessoas[editar | editar código-fonte]