Neste tutorial explicaremos como você pode contribuir com os projetos da Contadoria, tornando-se nosso(a) parceiro(a) e colaborador(a) no desenvolvimento e aperfeiçoamento das planilhas de cálculo e dos complementos.

Criando uma issue

A forma mais simples de contribuir com os projetos da Contadoria é comunicar-se conosco para:

• reportar um problema (“bug”);
• fazer uma sugestão ou comentário;
• tirar uma dúvida;
• reclamar de algo que vai mal.

Para fazer isso, você deve criar uma “issue” no Github.

Mas calma… Isso é bem simples!

O Github é a plataforma de desenvolvimento de projetos onde estão armazenados os códigos-fontes das planilhas de cálculo e dos complementos. É por meio dessa plataforma que nós organizamos as tarefas de desenvolvimento utilizando uma ferramenta que se chama “Issues”.

Se você quiser entender melhor do que se trata, veja aqui e aqui.

Para facilitar sua vida, nós desenvolvemos um modo mais simples de criar issues. É um “aplicativinho” que concentra todos os procedimentos para você numa única tela.

Você pode acessá-lo seguindo este link. Caso prefira, poderá acessá-lo diretamente da planilha de cálculo, clicando em “complementos - cálculos previdenciários - ajuda - informar um problema”.

Inicialmente, você se deparará com uma barra de ferramentas com o logo da Contadoria e um botão de login. Clique nesse botão para logar-se, conforme a figura abaixo:

Em seguida, você verá uma tela popup do Github. Se você ainda não estiver logado, ele pedirá que você se logue. Se ainda não estiver inscrito no Github essa tela também oferecerá a você a opção de fazê-lo clicando num link, conforme abaixo:

Assim que estiver superada a fase de login, o Github pedirá sua autorização para executar o aplicativo Contadoria Issues. Se você confia em nós e em nossa política de privacidade clique no botão.

Feito isso, você verá o formulário de criação de issues, com o seu pequeno avatar no canto superior direito indicando que você está logado.

Agora é só preencher os dados e clicar no botão ENVIAR.

A partir dessa tela, você poderá criar quantas issues quiser, sem precisar repetir o processo de login e autorização.

Atenção! Reflita bem antes de enviar uma issue, porque, uma vez criada, ela nunca poderá ser excluída do sistema, nem mesmo pelos administradores.

Se você é um usuário avançado ou se tem vontade de aprofundar-se no assunto, é possível também criar uma issue diretamente no Github. Para tanto, basta visitar o site de um dos projetos da Contadoria e inserir a sua issue diretamente ali, como na figura abaixo:

Claro que, antes, você terá de cadastrar-se no Github como usuário. Mas isso é bem simples. Basta navegar até o site https://github.com/ e seguir o procedimento de inscrição (“sign up”).

Fale conosco

Você também pode nos contatar diretamente pelos e-mails e telefones das Contadoriais do Juizado Especial Federal de São Paulo ou das Turmas Recursais dos Juizados Especiais Federais de São Paulo.

Torne-se um desenvolvedor

Se você tiver interesse e alguma facilidade com planilhas e computadores, poderá também tornar-se um desenvolvedor. Nesse caso, deve solicitar sua inclusão no grupo dos desenvolvedores. A partir de então passará a ter acesso direto aos códigos-fontes das planilhas e dos complementos.

É bom que você já tenha ou se disponha a adquirir algum conhecimento das tecnologias utilizadas nos projetos, especialmente Javascript, Google Apps Script e Google Sheets.

Há vários livros, cursos e tutoriais online sobre esses temas. Um livro que nos foi especialmente útil e que recomendamos é Going GAS From VBA to Google Apps Script do Bruce Macpherson, que é um dos “papas” no assunto e mantém o site Desktop Liberation, com um montão de coisas interessantes sobre Google Sheets, Excel e Google Apps Script.

Para quem já conhece VBA (a linguagem de script criada pela Microsoft para os aplicativos do Office), o livro do Bruce Macpherson ensina como migrar sem (muitos) traumas para o Google Apps Script.