[Hapi versão Alpha] Fluxo de trabalho de de traduções até geração do Hapi (do website, dos schemas e das OpenAPI)

[fititnt]

Esse tópico é para comentários sobre o processo de como estamos fazendo (e como poderíamos otimizar um pouco mais) a forma de traduzir tanto textos exclusivos do Hapi (como termos de uso, nome do site, etc) bem como termos potencialmente reusáveis fora do Hapi.

Mesmo que exista uma chance de menos de 20% do projeto sair da fase Alpha, creio que é melhor deixar pronto do que travar no meio do caminho. Outro ponto importante é separar a tarefa de quem cria site, gera arquivos, etc da equipe de revisores de texto e de tradutores.

Alguns fatos para quem cair de paraquedas (isto é, não saber o que é HXL e está apenas interessado em ajudar com código ou traduções)

Licença de uso dos dados: domínio público

Tanto trabalho das pessoas fundadoras, como expectativa de quem colabore, é dedicação ao domínio público.

Digo de forma muito resumida: exceto por 1) logos ou marcas (que nos nem usamos) bem como 2) reuso do material aqui em obras derivadas (exemplo: copiar datasets em pacotes PHP composer, JS NPM,...) você NÃO poder induzir usuário final de que "a organização XPTO apoia meu projeto", os dados do Hapi podem ser reusados sem nem mesmo citar fontes (por isso Domínio Público).

Essa licença é meio "extremista" porém faz sentido quando falamos de tecnologia humanitária e/ou dados abertos. Isso antes caminho para governos locais ou organizações internacionais terem oportunidade de "validar/aprovar" parte dos dados daqui sem que isso implique em "concordar/apoiar" o HXL-CPLP e/ou indivíduos que colaborem com organização de conteúdo dedicado ao uso comum.

Do reconhecimento de pessoas colaboradoras

Nota: contribuições anônimas (desde que haja como reconfirmar) são uma opção prevista. O rascunhado nesse ponto é exclusivo para pessoas que explicitamente queriam reconhecimento e, ainda assim, como vão querer dentro das opções disponíveis.

Um lado negativo de intencionalmente escolhermos dedicação ao domínio público (para facilitar a questão humanitária), bem como parte de toda lógica ficar em formato remoto (isto é, não ser "commit de GitHub" do usuário) é que pessoas podem se sentir pouco reconhecidas.

Ainda estamos abertos a sugestões, porém já está certo o seguinte:

• As formas de referenciar quem colabora no projeto principal não vão ser automáticas (como gerar lista de colaboradores apenas por quem colabora por código via GitHub).
• Vamos ver meios de valorizar mesmo quem ajuda além de código ou traduções e revisão de texto.
• Principalmente pessoas que estão em início de carreira na área de tecnologia (e faça diferença receber recomendações, não apenas anotação de que ajudou no projeto) vai ter apoio ativo de outros colegas. (Fica mais fácil se além de colaborar aqui falar em privado quais áreas noi tecnológicas tem interesse

Em geral, uma das nossas metas é manter projeto acessível para que colaboradores não especialistas (seja em código ou em revisão/tradução de texto) tenham condições de fazer até mesmo contribuição senão em software livre, em em tecnologia humanitária, através do HXL-CPLP.

Por que foco em colaboradores NÃO especialistas (exemplo: pessoas tradutoras profissionais)?

Outro ponto de procurar manter não só o Hapi, mas individualmente os "pedaços de textos entre diversas línguas" que poderia ser reusável por organizações grandes ou países é... dificilmente pessoas que trabalham profissionalmente com tradução vão ter interesse em colaborar pro bono com iniciativas como HXL-CPLP.

O problema vai além do dinheiro. Notem que na maioria das vezes fontes potenciais de financiamento podem ser justamente as menos interessadas em melhorar a interoperabilidade de dados na questão humanitária internacional com a própria região.

Ter traduções não perfeitas ainda é melhor que nenhuma tradução.

Como é o processo de ajudar com traduções?

A documentação exata de como será esse processo não está pronta, pois ainda estamos adaptando.

Esse post vai conter referências em português sobre a evolução disso. Os commits e o código fonte podem não conter todos os detalhes que a gente pode por aqui.

[fititnt]

Nota: apenas como referência, esse post documenta como está nesse momento, porém ainda pretendo organizar algumas coisas antes de chamar mais gente.

Processo atual (data: 2021-05-26)

Planilha HXL-CPLP-Vocab_Auxilium-Humanitarium-API

• https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=1181688279

Rakefile

# rake
task default: %i[download_hxl_datum]

# rake completum
task completum: %i[download_hxl_datum openapi_exportandum]

# @see https://docs.google.com/spreadsheets/d/1ih3ouvx_n8W5ntNcYBqoyZ2NRMdaA0LRg5F9mGriZm4/edit#gid=1181688279
task :download_hxl_datum do
  puts 'download_hxl_datum'
  puts 'Sincroliza dados HXL de _data/ do Google Planilhas' if l('pt')
  puts 'Syncronize HXL data from _data/ from Google Planilhas' if l('en')
  sh '_systema/programma/download-hxl-datum.sh'
end

task :openapi_exportandum do
  puts 'download_hxl_datum'
  puts 'openapi-generator-cli: gera arquivos baseado nos OpenAPI' if l('pt')
  puts 'openapi-generator-cli: generate files base on OpenAPI' if l('en')
  sh '_systema/programma/openapi-exportandum.sh'
end

# _[por] Messages on user language [por]_
# _[por] Mensagem no idioma do usuário [por]_
# @exemplum
#   ENV['LANG'] contains 'pt_BR.UTF-8'
#   ---
#   l('pt')
# @resultatum
#   true
def l(iso6391, fallback: false)
  ENV['LANG']&.start_with?(iso6391) || fallback
end

arquivo _data/L10n.hxl.csv

• _data/L10n.hxl.csv