dg:Guia de preenchimento de Planilha jurisdictionLevel: mudanças entre as edições

De Documentação
(corrige link de planilha)
Sem resumo de edição
 
Linha 2: Linha 2:
{{Para|a versão planilha de pacotes|dg:Guia de preenchimento da Planilha de Pacotes|Guia de preenchimento da Planilha de Pacotes}}
{{Para|a versão planilha de pacotes|dg:Guia de preenchimento da Planilha de Pacotes|Guia de preenchimento da Planilha de Pacotes}}


Para alterar Jurisdições fazer upload e editar em interface amigável [https://docs.google.com/spreadsheets/d/1xibgSNwdbBbTS1Uv1eFfP_lWpiXYvGnhHBEP_bAPYwk/ desta planilha online colaborativa].
A "planilha oficial" de todas as jurisdições de um país é mantida em [[git]] da Digital-guard. Por exemplo as planilhas do Brasil e Colômbia estão respectivamente em [http://git.digital-guard.org/preserv-BR git.digital-guard.org/preserv-BR] e [http://git.digital-guard.org/preserv-CO git.digital-guard.org/preserv-CO].


Os diferentes níveis administrativos foram distribuídos por diversos arquivos CSV e pastas da hierarquia juridicional. Ofertamos um software para gerenciar todos esses arquivos, reunindo-os em um só ou explodindo novamente em vários. Como nem todos são programadores, e ferramentas de git como o Github ainda carecem de bons editores de CSV, optamos por nós mesmos reunirmos os arquivos os arquivos em uma só planilha online, onde a comunidade pode editar a vontade:  [https://docs.google.com/spreadsheets/d/1xibgSNwdbBbTS1Uv1eFfP_lWpiXYvGnhHBEP_bAPYwk/ desta planilha online colaborativa].
Atualmente não precisamos, as correções ocorrem na Wikidata, no OSM e outras fontes. Se for necessário editar pela planilha, o passo-a-passo seria o siguinte:
# Equipe DG carrega [https://docs.google.com/spreadsheets/d/1xibgSNwdbBbTS1Uv1eFfP_lWpiXYvGnhHBEP_bAPYwk/ esta planilha online colaborativa] com os dados mais atualizados.
# Usuário externo ou da equipe EG editam as correções desejadas na planilha colaborativa.
# A Equipe DG é avisada de edições, ou decide usar as edições realizadas, e roda o script de captura dos CSVs a partir da planilha.
# A Equipe DG roda <code>git diff</code> conferindo também se as edições são consistentes e dentro de um padrão esperado.
# Se aprovado pela Equipe DG, a mesma equipe faz <code>git add; git commit -m "mensagem"; git push</code>.
== Ver também ==
== Ver também ==
* [[Documentação Digital-guard]]
* [[Documentação Digital-guard]]

Edição atual tal como às 22h35min de 7 de dezembro de 2023

Disambig grey.svg Nota: Para a versão planilha de doadores, ver Guia de preenchimento da Planilha de Doadores
Disambig grey.svg Nota: Para a versão planilha de pacotes, ver Guia de preenchimento da Planilha de Pacotes


A "planilha oficial" de todas as jurisdições de um país é mantida em git da Digital-guard. Por exemplo as planilhas do Brasil e Colômbia estão respectivamente em git.digital-guard.org/preserv-BR e git.digital-guard.org/preserv-CO.

Os diferentes níveis administrativos foram distribuídos por diversos arquivos CSV e pastas da hierarquia juridicional. Ofertamos um software para gerenciar todos esses arquivos, reunindo-os em um só ou explodindo novamente em vários. Como nem todos são programadores, e ferramentas de git como o Github ainda carecem de bons editores de CSV, optamos por nós mesmos reunirmos os arquivos os arquivos em uma só planilha online, onde a comunidade pode editar a vontade: desta planilha online colaborativa.

Atualmente não precisamos, as correções ocorrem na Wikidata, no OSM e outras fontes. Se for necessário editar pela planilha, o passo-a-passo seria o siguinte:

  1. Equipe DG carrega esta planilha online colaborativa com os dados mais atualizados.
  2. Usuário externo ou da equipe EG editam as correções desejadas na planilha colaborativa.
  3. A Equipe DG é avisada de edições, ou decide usar as edições realizadas, e roda o script de captura dos CSVs a partir da planilha.
  4. A Equipe DG roda git diff conferindo também se as edições são consistentes e dentro de um padrão esperado.
  5. Se aprovado pela Equipe DG, a mesma equipe faz git add; git commit -m "mensagem"; git push.

Ver também