Skip to content
This repository has been archived by the owner on Aug 17, 2023. It is now read-only.

Latest commit

 

History

History
54 lines (28 loc) · 3.66 KB

CONTRIBUTING.md

File metadata and controls

54 lines (28 loc) · 3.66 KB

Contribuir para o TPP

Read this in other languages: English

👍 🎉 Primeiramente, um grande obrigado pela tua contribuição com o teu tempo! 🎉 👍

Se ainda não te juntaste ao nosso canal de comunicação Slack, poderás fazê-lo aqui!

Queremos que desenvolvas características do projeto que te entusiasmem!!!

Se ficares preso em qualquer ponto, estás à vontade para criar um Issue no GitHub.

Todos os membros da nossa comunidade são obrigados a seguir o nosso código de conduta. Certifica-te que és acolhedor e amigável em todos os nossos espaços.

Abaixo estão algums recursos importantes para quem começa:

Contribuir no desenvolvimento

Se quiseres mergulhar profundamente e ajudar com o desenvolvimento do TPP, instala primeiro o projeto localmente de acordo com o nosso Guia de Instalação. Depois disso, sugerimos que vejas os Issues no nosso Issue Tracker que estejam marcados como Good First Issue. Estes Issues são ótimos para teres um começo suave e não te colocam em frente ás partes mais complexas do sistema.

Se quiseres trabalhar em tarefas mais desafiadoras, então segue os seguintes marcadores: data, feature, bug. Estes Issues têm uma visão geral e descrição do pretendido. Este tipo de Issues serão os ideais para começares. Dito isto, estes não são necessariamente os Issues mais fáceis.

Testing

Para que possamos garantir a funcionalidade da aplicação, é importante correr vários testes no software para anular a possibilidade de erros lógicos.

  • Cada serviço terá no seu repositório um ficheiro markdown TESTING.md para vos explicar de como testar o serviço.

  • Certifica-te que a característica soluciona realmente o problema em questão.

Estilo de código (Coding style)

  • Cada serviço terá no seu repositório um ficheiro markdown STYLING.md para vos explicar de como seguir o coding style do projeto.

Introdução dos teus dados no AUTHORS.md

Se for o teu primeiro commit em qualquer repositório, adiciona o teu nome e contacto no ficheiro AUTHORS.md


Contribuir na recolha de dados

Com centenas de operadoras de transportes públicos, também vamos precisar da tua ajuda na recolha de dados. Certifica-te que os dados recolhidos estejam disponíveis ao público.

Para contribuir com carregamento de horários em formato (PDF ou JPG) entra na plataforma Brutus e segue as indicações de lá: https://brutus.tpp.pt/

Obtenção dos dados das operadoras em formato GTFS

É necessário haver uma especificação de dados para que a integração e a manuntenção dos dados sejam eficientes. Poderão ler o documento publicado pela Google neste link

Nem todas as empresas, infelizmente, aderem ao idealismo do Open-Data, isso implica que haja burocracias na obtenção de dados. Caso queiram contactar as operadoras de transporte, falem primeiro com um dos membros da administração do projeto: glaand (André Glatzl), Rui-Santos (Rui J Santos), VitorSantos1 (Vítor Santos).