Wikipédia:Desenvolvimento técnico/Coordenação
Desenvolvimento técnico | Coordenação
Este é o espaço de coordenação do Desenvolvimento técnico. Aqui discute-se ideias para potenciar o desenvolvimento técnico dos wikipedistas, documentação a ser criada ou expandida, assim como no programa de mentoria.
alea jacta est[editar código-fonte]
Uma vez que ninguém se opôs em Wikipédia:Esplanada/geral/Mais programadores na wikipédia Lusófona? (2abr2013), acabei por mover as páginas para cá. Falta somente a do Danilo, que prefiro que ele dê autorização primeiro. Então passando agora para coisas mais concretas, que dizem da orgaização/informação das páginas? Esta ficaria para a coordenação das operações e a Wikipédia:Desenvolvimento técnico/Café das dúvidas para a colocação das dúvidas de quem está a desenvolver as suas capacidades de programação. Temos depois Wikipédia:Desenvolvimento técnico/Python como mini-introdução ao mundo python, e entretanto apareceria Wikipédia:Desenvolvimento técnico/Python/Pywikipediabot a dar luzes sobre o framework. Pensei igualmente em mais duas coisas neste início: um mapa sobre en:DRCS com o básico de git e/ou hg, pois é útil para a partilha de código, e um mapa para regex, algo que indubitavelmente acaba por ser necessário.
Sobre as mentorias em si, não sei qual será o mais indicado, mentorias personalizadas, onde temos um mentor definido para cada utilizador a aprender, ou então algo descentralizado, onde colocam as questões no café, sem haver necessariamente uma pessoa que sirva de guia.
Dêm uma vista de olhos, e dêem sugestões de melhorias, ainda falta passar os cabeçalhos para predefinições, para ver se arrancamos o quanto antes. Alchimista Fala comigo! 17h45min de 7 de maio de 2013 (UTC)
- De fato, uma coisa importante que precisa ser definida nesse projeto é como será as mentorias. Acho que depende muito dos aprendizes, do que eles preferem. Poderíamos usar só o café inicilamente, até percebermos quais são as dificuldades mais frequentes e assim termos uma base para definir uma melhor abordagem. Sobre o DRCS e git, eu não entendo quase nada sobre isso, uma documentação sobre isso seria muito bem vinda. Sobre Expressões regulares, sempre que tenho alguma dúvida olho este guia, que considero um ótimo guia sobre o assunto, completo e fácil de entender, talvez um link para ele seja o suficiente. Danilo.mac(discussão) 18h54min de 7 de maio de 2013 (UTC)
- Algo que poderia ser útil seria algo com um mini-projecto para aprendizes. Não sei se dará demasiado trabalho para os mentores, mas poderiam ter uma página com sugestões do que fazer para os aprendizes, por exemplo uma lista de projectos de pequena escala (sem soluções). Isso obrigaria os tutores a pensarem como resolver determinado "problema". Vejam por exemplo o site [1]. GoEThe (discussão) 21h18min de 18 de maio de 2013 (UTC)
- Interessante, é uma boa abordagem, vou pensar em alguns mini-projetos. Outra forma que eu estava pensado seria os aprendizes dizerem algo que queriam fazer na Wikipédia e os tutores iam tirando todas as dúvidas que os aprendizes iam tendo durante o desenvolvimento da ferramenta, o que acham? Danilo.mac(discussão) 03h40min de 22 de maio de 2013 (UTC)
- É interessante, contudo há algo que temos de ter em conta. Se for algo como o site que o Goethe apontou, acabamos por ter mais dispersão de esforços, pelo menos neste ponto inícial. A minha proposta é que se crie uma lista desses sites com exercícios práticos, para que possam exercitar, e caso tenham dúvidas, podemos tirá-las cá. Tinha começado uma lista em Wikipédia:Desenvolvimento_técnico/Python#Tutoriais e podemos sempre expandir. Normalmente são criados por quem tem experiência no ensino de python, além de acontecer como no caso apontado, em que os casos de treino são específicos a uma área, e acaba por ser mais motivador aprender com um assunto que apreciamos. Eu preferiria esses mini-tutoriais já com o pywp, vou mandar um mail p lista tech, para ver se há alguma wiki de testes que possa ser útil para testar com mais à vontade os primeiros scripts, mas sinceramente, sabendo o básico de looops e condicionais, um pouco de regex e tendo noção do que é uma classe e uma instância (uma class e def), já consegue criar uns scripts simples para enviar uma mensagem a uma lista de utilizadores, ou fazer correcções em páginas. A partir dai é mesmo só acumular experiência. Entretanto, já tentei procurar os meus scripts mais simples, e vou colocá-los no bitbucket, para que possam ver, mas já deve dar para perceber que os mais simples andam sempre à volta de ciclos for, if, e um pouco de regex. Tens alguma tarefa simples que um bot pude-se fazer Goethe? Podia-te acompanhar enquanto a criavas. Alchimista Fala comigo! 22h08min de 23 de maio de 2013 (UTC)
- Hmm, uma coisa que me dava jeito era ver se as páginas nesta lista tinham iw para português, e adicioná-los à página. GoEThe (discussão) 07h17min de 26 de maio de 2013 (UTC)
- Goethe, dei uma vista de olhos, e parece-me que não contêm interwikis para a pt.wp, em todo o caso, para isso já existe script, o de iw. Vou dar uma vista de olhos às tuas contribuições, para ver se encontro algo, entretanto, mais alguma ideia? Alchimista Fala comigo! 14h10min de 29 de maio de 2013 (UTC)
- Hmmm, isso não pode estar certo. Nem pelo Wikidata? en:Help:HTML faz ligação com Ajuda:HTML, por exemplo. GoEThe (discussão) 14h13min de 29 de maio de 2013 (UTC)
- Bom, então alguns têm, contudo se reparares no exemplo que deste, já está no wikidata, por isso é que vês os iw's na página em Português. Com o wikidata não é mais necessário adicionar iw's, isso é tudo gerido no wikidata, basta adicionar lá que aparece logo em todos os projectos. Alchimista Fala comigo! 16h24min de 29 de maio de 2013 (UTC)
- Acho que me expliquei mal. Eu não quero adicionar interwikis às páginas, quero fazer uma tabela com uma página em inglês e o correspondente em português para um projecto de melhorar a ajuda na Wikipédia. GoEThe (discussão) 16h31min de 29 de maio de 2013 (UTC)
- Bom, então alguns têm, contudo se reparares no exemplo que deste, já está no wikidata, por isso é que vês os iw's na página em Português. Com o wikidata não é mais necessário adicionar iw's, isso é tudo gerido no wikidata, basta adicionar lá que aparece logo em todos os projectos. Alchimista Fala comigo! 16h24min de 29 de maio de 2013 (UTC)
- Agora percebi, dá para fazer isso, e parece-me simples, aliás, creio que vais ser o primeiro a dar o corpo ao manifesto :P Alchimista Fala comigo! 20h21min de 29 de maio de 2013 (UTC)
- Hmmm, isso não pode estar certo. Nem pelo Wikidata? en:Help:HTML faz ligação com Ajuda:HTML, por exemplo. GoEThe (discussão) 14h13min de 29 de maio de 2013 (UTC)
- Goethe, dei uma vista de olhos, e parece-me que não contêm interwikis para a pt.wp, em todo o caso, para isso já existe script, o de iw. Vou dar uma vista de olhos às tuas contribuições, para ver se encontro algo, entretanto, mais alguma ideia? Alchimista Fala comigo! 14h10min de 29 de maio de 2013 (UTC)
- Hmm, uma coisa que me dava jeito era ver se as páginas nesta lista tinham iw para português, e adicioná-los à página. GoEThe (discussão) 07h17min de 26 de maio de 2013 (UTC)
- É interessante, contudo há algo que temos de ter em conta. Se for algo como o site que o Goethe apontou, acabamos por ter mais dispersão de esforços, pelo menos neste ponto inícial. A minha proposta é que se crie uma lista desses sites com exercícios práticos, para que possam exercitar, e caso tenham dúvidas, podemos tirá-las cá. Tinha começado uma lista em Wikipédia:Desenvolvimento_técnico/Python#Tutoriais e podemos sempre expandir. Normalmente são criados por quem tem experiência no ensino de python, além de acontecer como no caso apontado, em que os casos de treino são específicos a uma área, e acaba por ser mais motivador aprender com um assunto que apreciamos. Eu preferiria esses mini-tutoriais já com o pywp, vou mandar um mail p lista tech, para ver se há alguma wiki de testes que possa ser útil para testar com mais à vontade os primeiros scripts, mas sinceramente, sabendo o básico de looops e condicionais, um pouco de regex e tendo noção do que é uma classe e uma instância (uma class e def), já consegue criar uns scripts simples para enviar uma mensagem a uma lista de utilizadores, ou fazer correcções em páginas. A partir dai é mesmo só acumular experiência. Entretanto, já tentei procurar os meus scripts mais simples, e vou colocá-los no bitbucket, para que possam ver, mas já deve dar para perceber que os mais simples andam sempre à volta de ciclos for, if, e um pouco de regex. Tens alguma tarefa simples que um bot pude-se fazer Goethe? Podia-te acompanhar enquanto a criavas. Alchimista Fala comigo! 22h08min de 23 de maio de 2013 (UTC)
- Interessante, é uma boa abordagem, vou pensar em alguns mini-projetos. Outra forma que eu estava pensado seria os aprendizes dizerem algo que queriam fazer na Wikipédia e os tutores iam tirando todas as dúvidas que os aprendizes iam tendo durante o desenvolvimento da ferramenta, o que acham? Danilo.mac(discussão) 03h40min de 22 de maio de 2013 (UTC)
Wikipédia:Desenvolvimento técnico/Sistemas de controlo de versão[editar código-fonte]
Já agora, criei Wikipédia:Desenvolvimento técnico/Sistemas de controlo de versão, para já tem somente o hg (mercurial) como SCV, e o bitbucket para ter os repos online, alguém pode expandir ali o git? Eu sinto-me mais confortável com o hg, parece-me ser mais fácil de aprender, especialmente porque pouco uso dou, embora o git seja o mais usado na wm, e o github igualmente. Mas para partilha do código, parece-me mais prático usar um ou o outro, nada mais simples do que um hg comit -> hg push (ou os equivalentes no GIT) para terem o código num repo online, com mentores a poderem editar esse mesmo código e fazerem alterações no mesmo. Alchimista Fala comigo! 22h23min de 23 de maio de 2013 (UTC)
- Andei lendo essa página um tempo atrás, cheguei a instalar o mercurial e criar um projeto no Google code, mas o mercurial estava dando erro e acabei não mexendo mais, vou ver se resolvo o problema e passo meus scripts para o repositório online. Agora que falou sobre o bitbucket estou na dúvida qual repositório online é melhor, andei lendo alguns comentários na internet dizendo que o Google code é mais fácil de usar então criei lá, o bitbucket é melhor? Danilo.mac(discussão) 02h09min de 2 de junho de 2013 (UTC)
- Ao dizer qual o melhor corre-se o risco de cair nos gostos pessoais. Eu já usei o code.googe, contudo em termos de internet, pode dizer-se que é do século passado. O design é pouco atraente e intuitivo, além de ainda não possuir algumas das novidades da moda. Grande parte dos projectos estão a migrar para os repositórios da moda, mais actuais, onde o github se destaca, no entanto só funciona com git. O bitbucket, por exemplo, tal como o github, permite que se faça um fork, uma espécie de cópia do projecto. Se fizeres um fork de um repositório meu, por exemplo, podes alterá-lo para algo completamente diferente, ou então aprimorar os códigos e depois fazer um pull request, que é um pedido para que uma alteração seja incluída no meu repositório. Tem ainda outros pormenores de interação, eu posso seguir os teus projectos e vice versa, e enquanto que no github (no code já não me lembro) sempre que há uma alteração qualquer ou comentário sou avisado, o bitbucket permite seleccionar o tipo de avisos que pretendo receber, se alguém abre um ticket de um bug, ou se é feita alguma alteração no código. Tem ainda repositórios privados, que podem ter até 5 elementos. Enfim, se estás indeciso entre o bit e o code, a minha opinião é que para partilhar código e permitir a colaboração, o bitbucket é mais indicado, agora tens também o github, que é o repo da moda, e que funciona somente com o git, igualmente na moda. Eu vou usando o git quando é necessário porque os repos oficiais da wikimédia usam o git, e uso o hg para os meus próprios, onde são utilizações mais ligeiras e parece-me mais simples para uma utilização básica, embora aqui certamente há várias opiniões, em muitos casos, por serem ferramentas muito parecidas, cai um pouco na sensação e opinião pessoal. Alchimista Fala comigo! 11h32min de 2 de junho de 2013 (UTC)
Pywikipediabot[editar código-fonte]
Gostaria de criar uma página com exemplos de códigos para o robô python, onde seria melhor colocar? Wikipédia:Desenvolvimento técnico/Pywikipediabot/exemplos? Danilo.mac(discussão) 01h45min de 3 de junho de 2013 (UTC)
Aqui o que estou querendo fazer, acho que exemplos assim ajudam bastante. Talvez isso possa ser colocado diretamente na página sobre pywikipediabot. Danilo.mac(discussão) 02h18min de 4 de junho de 2013 (UTC)