Upgrade to Pro — share decks privately, control downloads, hide ads and more …

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

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

Talk on hhbr – Hackers House BR #16.

Video: https://youtu.be/XazncfYacPc

Rogerio Prado de Jesus

November 07, 2017
Tweet

More Decks by Rogerio Prado de Jesus

Other Decks in Technology

Transcript

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

    View full-size slide

  2. http://phpsp.org.br/

    View full-size slide

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

    View full-size slide

  4. https://t.me/PHPTestFestBrasil

    View full-size slide

  5. @SammyK @ramsey

    View full-size slide

  6. Contribuição

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  9. Existem formas
    de contribuir
    com a
    linguagem PHP...

    View full-size slide

  10. … mesmo para
    quem não é
    desenvolvedor C

    View full-size slide

  11. [...] 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

    View full-size slide

  12. 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

    View full-size slide

  13. Tradução pt_BR

    View full-size slide

  14. 9%
    Atualizada com a última versão EN

    View full-size slide

  15. 91%
    Desatualizada ou indisponível

    View full-size slide

  16. 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

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  19. ● 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

    View full-size slide

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

    View full-size slide

  21. Arquivos .phpt
    divididos em
    seções

    View full-size slide

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

    View full-size slide

  23. --TEST--
    Trivial "Hello World" test
    --FILE--

    --EXPECT--
    Hello World
    https://github.com/php/php-src/commits/master/tests/basic/001.phpt

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  26. 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

    View full-size slide

  27. ● 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

    View full-size slide

  28. 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

    View full-size slide

  29. TestFest,
    InstallFest,
    TranslationFest...

    View full-size slide

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

    View full-size slide

  31. PHP TestFest
    2017

    View full-size slide

  32. ● 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

    View full-size slide

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

    View full-size slide

  34. E como vai ser o
    processo em
    definitivo?

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  37. 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

    View full-size slide

  38. https://phptestfest.org/
    * Wiki
    PHPTestFestBrasil

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  41. ● Prepare-se
    ● Participe
    Contribuidor

    View full-size slide

  42. 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

    View full-size slide

  43. ● 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

    View full-size slide

  44. Busque o seu
    caminho, a
    comunidade vai te
    ajudar!

    View full-size slide

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

    View full-size slide