Contribuindo com o PHP e o PHP TestFest 2017 - hhbr – Hackers House BR #16

Slide 1

Slide 1 text

Contribuindo com o PHP e o PHP TestFest 2017 Rogerio Prado de Jesus - Novembro 2017 #PHPTestFestBrasil #PHPDF #PHPSP #phptestfest

Slide 2

Slide 2 text

#PaiDoLéo

Slide 3

Slide 3 text

http://phpsp.org.br/

Slide 4

Slide 4 text

http://www.phpdf.org.br/

Slide 5

Slide 5 text

https://t.me/PHPTestFestBrasil

Slide 6

Slide 6 text

@SammyK @ramsey

Slide 7

Slide 7 text

Contribuição

Slide 8

Slide 8 text

No content

Slide 9

Slide 9 text

https://rogeriopradoj.com/ 2015/11/04/becoming-a-co ntributor-open-sourcer-an d-beyond-palestra-do-tdc- 2014-trilha-php/

Slide 10

Slide 10 text

No content

Slide 11

Slide 11 text

Créditos: https://www.flickr.com/photos/mrbill/2482009942

Slide 12

Slide 12 text

Existem formas de contribuir com a linguagem PHP...

Slide 13

Slide 13 text

… mesmo para quem não é desenvolvedor C

Slide 14

Slide 14 text

[...] Anybody who programs in PHP can be a contributing member of the community that develops and deploys it; the task of deploying PHP, documentation and associated websites is a never ending one. [...] http://docs.php.net/get-involved.php

Slide 15

Slide 15 text

PHP Manual

Slide 16

Slide 16 text

PHP Manual ● DocBook (XML) ● Estrutura Subversion ● Principal problema ○ Casos de apenas só API funções novas ● Principal caminho: ○ Editor online ○ https://edit.php.net/ ● Recursos: ○ http://doc.php.net/tutorial/ ○ https://www.sammyk.me/how-to-co ntribute-to-php-documentation

Slide 17

Slide 17 text

Tradução pt_BR

Slide 18

Slide 18 text

9% Atualizada com a última versão EN

Slide 19

Slide 19 text

91% Desatualizada ou indisponível

Slide 20

Slide 20 text

Situação atual (2017-09-01) Revcheck ● http://doc.php.net/images/revcheck/info_revcheck_p hp_pt_BR.png ● http://doc.php.net/images/revcheck/info_revcheck_p hp_all_lang.png

Slide 21

Slide 21 text

● 2014: PHP TranslationFest Brasil ● 2013: PHPSP + Docs #1 Tradução pt_BR Ações comunidades

Slide 22

Slide 22 text

GitHub: @alfsb @fabioluciano People.php.net: @ae

Slide 23

Slide 23 text

● Wiki oficial ○ https://wiki.php.net/doc/tra nslations/pt_br ● Roteiros ○ SVN ○ Git + GitHub (bridge) + SVN ○ "Modo não recomendado" ● Lista de e-mails oficial tradução Tradução pt_BR Recursos

Slide 24

Slide 24 text

Testes

Slide 25

Slide 25 text

Testes ● Suíte de testes escrita em PHP ● Testes de integração (caixa-preta)

Slide 26

Slide 26 text

Arquivos .phpt divididos em seções

Slide 27

Slide 27 text

--TEST-- Trivial "Hello World" test --FILE-- Hello World --EXPECT-- Hello World Mínimo

Slide 28

Slide 28 text

--TEST-- Trivial "Hello World" test --FILE-- --EXPECT-- Hello World https://github.com/php/php-src/commits/master/tests/basic/001.phpt

Slide 29

Slide 29 text

PHPT - Layout: https://qa.php.net/ phpt_details.php

Slide 30

Slide 30 text

Cobertura de testes: GCOV / LCOV http://gcov.php.net/PHP _HEAD/lcov_html/

Slide 31

Slide 31 text

Testes Roteiro ● Clonar o repositório do código fonte (php/php-src) ● Oficial ○ Compilar ○ Rodar testes atuais ○ Criar novos testes ● Ambiente facilitado via Docker ○ herdphp/docker-phpqa ○ PHPTestFestBrasil/phptt ● Mandar os testes para revisão

Slide 32

Slide 32 text

● Roteiro oficial: ○ https://qa.php.net/write-test .php ● Agrupado pt_BR: ○ https://github.com/PHPTest FestBrasil/phptestfestbrasil .github.io/wiki ● @SammyK ○ Slides ○ Playlist YouTube Testes Recursos

Slide 33

Slide 33 text

No content

Slide 34

Slide 34 text

Festival

Slide 35

Slide 35 text

Festival Comunidade, indivíduos e instituições juntos para melhorar um projeto comum Tem período definido Propósitos específicos Legado: Preparar mais pessoas para continuarem contribuindo mesmo após o período

Slide 36

Slide 36 text

TestFest, InstallFest, TranslationFest...

Slide 37

Slide 37 text

● 2008-2010 ○ TestFests mundiais ● 2013 ○ PHPSP + Docs #1 ● 2014/JUL ○ #PhpspMaisTestFest ● 2014/Dezembro ○ #PHPTranslationFestBrasil2014 Festival Um pouco de história

Slide 38

Slide 38 text

PHP TestFest 2017

Slide 39

Slide 39 text

● Objetivos ● Período ○ SET a DEZ 2017 ● Prêmios / incentivo ● @ramsey ● História 2017 ○ JUN (mailing) ○ JUL (http://phptestfest.org ) ○ AGO (Podcast, Hangouts, discussões) PHP TestFest 2017 #phptestfest

Slide 40

Slide 40 text

Discussões

Slide 41

Slide 41 text

● Globais: ○ https://phptestfest.org/ ○ Google Groups ○ Twitter ● Português: ○ Telegram @PHPTesfFestBrasil Discussões #phptestfest

Slide 42

Slide 42 text

E como vai ser o processo em definitivo?

Slide 43

Slide 43 text

https://twitter.com/phptestfest/status/90292 6147486457864

Slide 44

Slide 44 text

Eventos locais Grupo / Comunidade + Patrocinadores + Contribuidores ● PHP TestFest ● Como escrever e contribuir com PHPT ● Mini hackathon

Slide 45

Slide 45 text

Consolidação global ● Repo intermediário ● Pontuação ○ "Bons" testes ○ Iniciantes ○ Quantidade ● [WIP] Ferramenta e definições ● Ponte para prêmios ○ Patrocinadores ○ Divulgação ○ Janeiro/2018 phpcommunity.org + Revisores + Grupos / Comunidades + Patrocinadores

Slide 46

Slide 46 text

Recursos

Slide 47

Slide 47 text

https://phptestfest.org/ * Wiki PHPTestFestBrasil

Slide 48

Slide 48 text

Envolva-se

Slide 49

Slide 49 text

● Global ○ [email protected] ● Apoio local ○ Receber comunidades ○ Espaço para eventos ○ Apoio infraestrutura Instituição

Slide 50

Slide 50 text

● Cadastro no site oficial ● Discussões e interações ● Buscar apoio local e tocar eventos ● Apoiar ação global Grupos / Comunidades / Evangelistas

Slide 51

Slide 51 text

● Prepare-se ● Participe Contribuidor

Slide 52

Slide 52 text

Demonstração https://github.com/PHPTestFestBrasil/phptt ● phptt ● phptt generate ● phptt test ● phptt lcov https://www.youtube.com/watch?v=o9iEGEVJEZE ● repositório base ● fluxo contribuição open source no GitHub ● Pull Request

Slide 53

Slide 53 text

● Telegram PHPTestFestBrasil ○ https://t.me/PHPTestFestBrasil ● YouTube PHPTestFestBrasil ○ https://www.youtube.com/channel/UCZDace9Yohbdbncpj9Wf_mQ ● GitHub Organization PHPTestFestBrasil ○ https://github.com/PHPTestFestBrasil ● GitHub - Lista de eventos Brasil 2017 ○ https://github.com/PHPTestFestBrasil/2017 ● Tweets #phptestfest ○ Lista: https://twitter.com/hashtag/phptestfest?f=tweets&vertical=default ○ Não pare! https://twitter.com/rogeriopradoj/status/927889532741210113 Mais

Slide 54

Slide 54 text

Busque o seu caminho, a comunidade vai te ajudar!

Slide 55

Slide 55 text

33% off Valeu, #hhbr! --- @RogerioPradoJ #PaiDoLéo #mlaphp_pt_br #phptestfest #PHPTestFestBrasil #PHPDF #PHPSP