Esta página contém os detalhes de um projeto de escrita técnica aceito para a temporada de documentos do Google.
Resumo do projeto
- Organização de código aberto:
- Fatos nutricionais abertos
- Redator técnico:
- FutureOfDocs
- Nome do projeto:
- Documentar a API Open Food Facts
- Duração do projeto:
- De longa duração (5 meses)
Project description
Ouvi falar pela primeira vez sobre a "temporada de documentos" por um e-mail que recebi do instrutor de um curso sobre a documentação da API REST que fiz alguns meses atrás. Embora realmente tenha gostado da ideia, decidi que só me candidataria a um projeto se realmente pudesse me identificar com ele. Isso era algo que eu faria além do meu trabalho regular e, se fizesse, deve ser divertido e significativo.
Quando li a descrição da Open Food Facts, sabia que tinha encontrado esse projeto. Adoro cuidar do meu corpo e saúde com exercícios e alimentação. Realmente acho que a nutrição é uma das chaves para uma vida feliz, e todos devemos ser capazes de fazer escolhas melhores, o que só é possível se tivermos informações suficientes sobre a comida e os cosméticos que usamos. O Open Food Facts coloca essas informações à nossa disposição, e quero contribuir com essa iniciativa incrível.
Nos últimos três anos, trabalhei como redator técnico em uma empresa de desenvolvimento de software especializada em automação de processos e lançamentos. Entre outros, implementamos uma API REST com o Swagger que permite que os desenvolvedores se comuniquem com nossos aplicativos por meio de solicitações de API. Ajudei as equipes de desenvolvimento a escrever descrições melhores para as solicitações/respostas e, juntos, identificamos quais informações são necessárias para nossos clientes fornecê-las de maneira clara e concisa.
Analisei o site atual da API Open Food Facts e acho que podemos reestruturar e aprimorar a documentação para torná-la mais fácil de usar (páginas Geral, LER, GRAVAR). Além disso, eu adoraria criar, com as equipes de desenvolvimento, uma forma de gerar a documentação da API automaticamente a partir do código (isso leva tempo, por isso estou propondo uma colaboração duradoura).
todos sabemos que aparências são importantes ;) É por isso que também podemos ajustar o CSS e o logotipo da API REST para alinhar a interface moderna com a documentação do usuário.
Espero trabalhar com você neste projeto.