Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/saiba-como-foi-o-1o-sprint-online-do-querido-diario/

Número

5

Categoria

Comunidade e Tecnologia

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

Copiando aqui o comentário de @kaiciasca em #3 :

Aproveitando o registro aqui, fiquei pensando se, na hora que surgem as possibilidades de município quando digito o nome da cidade no campo, seria legal aparecer também o estado, pq são diversas cidades com nomes iguais em diferentes estados no Brasil.

Na sessão "Acompanhe a evolução do Querido Diário", adicionar gráficos (tipo pizza, barra, linha, etc.) indicando visualmente as estatísticas com foco no recorte do status atual, organizando a porcentagem concluída com relação aos totais por municípios, por estados, por capitais, por regiões.

Nível 0 - O diário ainda não está cadastrado na plataforma (censo)
Nível 1 - O diário foi cadastrado no censo, mas não tem raspador implementado
Nível 2 - O raspador está pronto, mas falta extrair o texto do arquivo fechado
Nível 3 - O conteúdo está disponibilizado em formato original e em .TXT

Por ex.:

12 cidades já na plataforma (Nível 3)
12/27 Capitais (44%)
12/ 5570 Municípios (0,21%)
X/ 27 Estados (Y%)

2226 cidades já tem robôs para coletar diário (Nível 2)
12/27 Capitais (44%)
2226/5570 (39,96%) Municípios
Z/27 (W%) Estados

597 cidades já foram mapeadas pelo senso (Nível 1)
12/27 Capitais (44%)
2226/5570 (39,96%) Municípios
x/27 (y%) Estados

Ou ainda, utilizar agrupamentos de estatísticas por regiões:
Centro-Oeste
Nordeste
Norte
Sudeste
Sul

Obs.: idealmente essas informações sobre o status do censo e dos raspadores deveriam ser consumidas a partir de uma API.

Atualmente, o texto da seção "contribua com código" está linkando apenas o Github da OKBR, o que não contribui para que o usuário seja corretamente direcionado aos repositórios do Querido Diário.
Sugiro uma edição no texto, listando os principais repositórios do projeto que aceitam contribuições (Raspadores, API, Toolbox, p. ex.).

Primeiro de tudo, obrigada pelo lançamento da plataforma, de extrema importância para nós, pesquisadorxs da atuação pública, e interessades em geral.
Tive uma questão ao fazer uma pesquisa. Sou de Campinas-SP e, ao pesquisar a cidade, ela abre três possibilidades no campo do município (Campinas do Piauí, Campinas e Campinas do Sul). Selecionei "Campinas", que tem o nível 1 de abertura. Porém, ao pesquisar, o resultado vem como sendo sobre Campinas do Piauí, que tem nível 0 de abertura. Incluo um print aqui para verem como fica:

Campinas do Piauí é a primeira cidade que aparece na lista de sugestões quando eu incluo o texto 'Campinas', porém eu chego a clicar e selecionar 'campinas' no campo. Ia até tentar propor o que poderia estar acontecendo, mas meus conhecimentos de programação são limitados, por enquanto, e queria mais passar o que estava ocorrendo mesmo.
Aproveitando o registro aqui, fiquei pensando se, na hora que surgem as possibilidades de município quando digito o nome da cidade no campo, seria legal aparecer também o estado, pq são diversas cidades com nomes iguais em diferentes estados no Brasil.

Registro aqui esses apontamentos que tive em email trocado com @giuliocc .

A aba de andamento do censo informa que já temos 598 cidades mapeadas, então precisamos atualizar o número na home do site do Querido Diário.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/okbr-e-ime-usp-encerram-semestre-de-parceria-com-muitos-avancos-para-o-querido-diario/

Número

8

Categoria

Querido Diário nas Universidades

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

Precisamos atualizar a build do Netlify, a que usamos atualmente vai deixar de funcionar a partir de 15 de Novembro de 2022.

DEPRECATION NOTICE: Builds using the Xenial build image will fail after November 15th, 2022.

The build image for this site uses Ubuntu 16.04 Xenial Xerus, which is no longer supported.
All Netlify builds using the Xenial build image will begin failing in the week of November 15th, 2022.

To avoid service disruption, please select a newer build image at the following link:
https://app.netlify.com/sites/querido-diario-plataforma/settings/deploys#build-image-selection

For more details, visit the build image migration guide:
https://answers.netlify.com/t/please-read-end-of-support-for-xenial-build-image-everything-you-need-to-know/68239

cc: @giuliocc

A página de resultados de pesquisa oferece 3 opções de ordenamento dos resultados (relevância, mais recentes e mais antigos). Ao fazer uma pesquisa e escolher um ordenamento tudo funciona. Entretanto, ao fazer uma pesquisa em sequência, o botão do ordenamento não atualiza.

Exemplo:
1ª busca: por "teste" em todas as cidades e todos os períodos. Ordenado por "mais recentes"
https://queridodiario.ok.org.br/pesquisa?term=teste&sort_by=descending_date
Notar: a query no link está certa, o botão também e os resultados.

2ª busca: foi trocado "teste" por "orçamento"
Notar: a query do link deixa de ter o ordenamento, os resultados também não estão ordenados por "mais recente" (tanto é que 2019 está antes de 2022), porém no texto do dropdown ainda indica que está ordenado.

Atualizar a página com F5 resolve o problema. O comportamento só aparece com buscas seguidas.
A tarefa aqui seria corrigir para que o texto volte a ser "relevante" quando uma nova busca for feita.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/querido-diario-recebe-apoio-de-equipe-de-estudantes-e-pesquisadores-do-ime-usp/

Número

7

Categoria

Querido Diário nas Universidades

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

A página do tutorial de busca avançada (PR #56) não passou no teste unitário (commit 2a239ff)

Precisa-se descobrir porque e corrigir

[English]
Advanced search tutorial page (PR #56) failed unit test (commit 2a239ff)

Need to find out why and fix

Adicionar um mapa à página inicial do Querido Diário, na sessão "Acompanhe a evolução do Querido Diário", indicando visualmente todos os municípios, com destaque para as capitais, que pode constar com um mecanismo de luzes que vão acendendo e mudando de cor de acordo com o nível de libertação dos Diários Oficiais daquele município, de acordo com a narrativa atual:

Ex.:

Nível 0 - Apagada - O diário ainda não está cadastrado na plataforma (censo)
Nível 1 - Vermelha - O diário foi cadastrado no censo, mas não tem raspador implementado
Nível 2 - Amarela - O raspador está pronto, mas falta extrair o texto do arquivo fechado
Nível 3 - Verde - O conteúdo está disponibilizado em formato original e em .TXT

Ou algum tipo análogo de visualização, com fogueiras ou outro símbolo/cores.

Obs.: idealmente essas informações sobre o status do censo e dos raspadores deveriam ser consumidas a partir de uma API.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/como-cientistas-de-dados-podem-analisar-diarios-oficiais-usando-a-querido-diario-toolbox/

Número

9

Categoria

Comunidade e Tecnologia

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

É necessPara fazer a busca por período é necessário digitar a data de inicio e de fim. Não está claro no formulário qual o formato da data (DD/MM/YYY por exemplo). Descobri ao acaso que se clicar na imagem ao lado desse campo de texto, aparece um calendário para facilitar esse preenchimento. Talvez ao clicar no campo de texto, abrir esse calendário já ajudasse a facilitar o uso desse campo. Também seria interessante limitar a data de fim para o ano atual (é possível eu colocar algo em 2050 se eu quiser pelo calendário), acredito que isso seja configurável de alguma maneira.

English version bellow.

Quando há muitos resultados, a API parece limitar a quantidade de resultados mostrados em 10 mil:

Mas não há indicação para a pessoa usuária de que esse é um limite. A mensagem poderia ser mais informativa, com algo como: "Mais de 10 mil resultados encontrados" e abaixo "Tente buscar termos mais específicos ou usar mais de um termo para encontrar o que busca".

ENGLISH

When there are too many results, the API seems to limit the amount of results shown to 10,000:

But there is no indication to the user that this is a limit. The message could be more informative, with something like: "Mais de 10 mil resultados encontrados [Over 10,000 results found]" and below "Tente buscar termos mais específicos ou usar mais de um termo para encontrar o que busca [Try looking for more specific terms or use more than one term to find what you're looking for]".

Descrição

Como o objetivo do Querido Diário é aproximar a informação pública das pessoas cidadãs, uma grande dificuldade é compreender o vocabulário de conceitos de administração pública. Para isso, o projeto tem um glossário.

Uma melhoria interessante para projeto seria destacar essas palavras mapeadas pelo glossário nos excertos de diários exibidos nos resultados de pesquisa.

No Querido Diário "Educação" isso já é feito com CNPJs: ao encontrar um número, o projeto destaca o conteúdo para que quem quiser saber mais sobre o CNPJ achado, tenha facilidade de obter a informação.

Pra ideia do glossário, algo similar pode ser feito com algumas adaptações:

• ao invés de um destaque colorido, apenas um destaque em negrito ou itálico
• ao invés de abrir o conteúdo em uma nova página, o significado da expressão destacada aparecer ao passar o cursor em cima (como em um balão)
• adicionar um botão de on/off (com off por padrão) para que pessoas especialistas que não precisam deste recurso, possam desabilitá-lo.

Para concretizar essa melhoria, alterações em outros repositórios serão necessárias.

Em testes realizados no navegador Brave Versão 1.47.186 Chromium: 109.0.5414.119 e no Chrome Versão 109.0.5414.119 foi observado que o painel do Looker Studio não funciona:

Já no Firefox ele funciona, mas empurra a lista de cidades para além do fim do container, causando o problema relatado no issue #102

Os testes foram feitos tanto em ambiente de desenvolvimento quanto no site em si, no Ubuntu 20.04.5

EDIT: o erro foi causado por interação com uma extensão. desconsiderar este issue.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/querido-diario-e-utilizado-em-estudo-da-ufrn-sobre-gastos-publicos-com-a-covid-19/

Número

15

Categoria

Querido Diário nas Universidades

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.
se o conteúdo tiver uma imagem, não precisa adicionar ao repositório; todas as imagens estão na Digital Ocean, basta referenciá-las:

• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem31-ufrn_remediosnaoeficazescovid.png

Português

Como notado por @campagnucci, a página Sobre não apresenta uma descrição dos objetivos do Querido Diário. Precisamos incluir esse texto. Podemos usar como referência a descrição da página do projeto no Catarse.

English

As noted by @campagnucci, the About page does not provide a description of the Querido Diário goals. We need to add this text. We can use the description of the project page in Catarse as a reference.

No site do Querido Diário , talvez seja interessante inserir link nas imagens abaixo para o site das entidades realizadoras e apioadoras do projeto.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/querido-diario-ja-conta-com-21-cidades-em-sua-plataforma/

Número

16

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

No curso Python para Inovação Cívica da Escola de Dados um tutorial bem completo para iniciantes sobre como implementar raspadores para o QD foi desenvolvido e para que não fique obsoleto podemos trazê-lo para nosso blog.

Nesse campo, é possível escolher apenas um município, então acredito que ele deveria se chamar Município ao invés de Municípios:

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/o-querido-diario-esta-no-ar-conheca-a-plataforma-inedita-para-busca-em-diarios-oficiais-municipais/

Número

12

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

O código de conduta do projeto no repo okfn-brasil/querido-diario-comunidade é exatamente igual ao que está aqui. Creio que para tornar isso mais fácil de manter, o arquivo CODE_OF_CONDUCT deveria apenas referenciar o de querido-diario-comunidade, pedindo para lê-lo.

Se possível, escrito tanto em inglês quanto em português. Encorajado por okfn-brasil/querido-diario-comunidade#4.

English

The project's code of conduct in the okfn-brasil/querido-diario-comunidade repo is exactly the same as the one in here. I believe that to make it easier to maintain the file CODE_OF_CONDUCT should just reference querido-diario-comunidade's, asking to read it.

If possible, written in English as well as portuguese. Encouraged by okfn-brasil/querido-diario-comunidade#4.

Português

Aqui apresento um exemplo de como uma requisição está chegando na API (a maioria dos parâmetros, exceto pelo querystring foram omitidos pois eram redundantes):

https://queridodiario.ok.org.br/api/gazettes?querystring=linux%20+%20windows (3211 resultados)

E um exemplo de como deveria ser recebido:

https://queridodiario.ok.org.br/api/gazettes?querystring=linux%20%2B%20windows (651 resultados)

O problema está no caractere + que não está sendo codificado mas deveria. Fazendo com que não seja entendido corretamente pela API como um operador AND na busca e ao invés de 651 resultados recebamos 3211 resultados.

English

Here I present an example of how a request is arriving at the API (most parameters, except for querystring, were omitted as they were redundant):

https://queridodiario.ok.org.br/api/gazettes?querystring=linux%20+%20windows (3211 results)

And an example of how it should be received:

https://queridodiario.ok.org.br/api/gazettes?querystring=linux%20%2B%20windows (651 results)

The problem is in the + character which is not being encoded but should be. Making it to not be understood correctly by the API as an AND operator in the search and instead of 651 results we receive 3211 results.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/retrospectiva-2021-relembre-as-reportagens-e-outros-casos-de-uso-do-querido-diario/

Número

14

Categoria

#AcheiNoDiárioOficial

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.
se o conteúdo tiver uma imagem, não precisa adicionar ao repositório; todas as imagens estão na Digital Ocean, basta referenciá-las:

• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem27-card-voce-sabia-manaus.png
• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem33-card-como-16-cidades-lgpd.jpg
• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem34-card-reportagem-catarinas.png
• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem35-card-reportagem-correionago.png
• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem36-card-reportagem-datalabe.png
• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem37-card-reportagem-abare.png

A página de cidades disponíveis (https://queridodiario.ok.org.br/cidades-disponiveis) exibe uma lista de cidades abaixo do painel de monitoramento. As cidades da lista são fornecidas pela API (https://queridodiario.ok.org.br/api/cities?levels=3)
Entretanto, a lista está exibindo apenas parte das cidades (parando nas cidades começando com S)

O comportamento só aparece na versão desktop. A mesma página pelo mobile exibe a lista toda com sucesso.

Português

Atualmente, temos um bug na área de paginação. Quando alguma busca atinge o limite e a paginação disponibiliza 1000 páginas, a seta da direita se sobrepõe ao número. Precisamos aumentar o espaçamento. Vale ressaltar que o mesmo não ocorre em dispositivos móveis.

English

We currently have a bug in the pagination area. When some search reaches the limit and the pagination makes 1000 pages available, the arrow on the right overlaps the number. We need to increase the spacing. It is worth mentioning that the same does not occur on mobile devices.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/ciencia-de-dados-para-inovacao-civica-recebe-bolsa-da-mozilla-research-projects/

Número

2

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.
se o conteúdo tiver uma imagem, não precisa adicionar ao repositório; todas as imagens estão na Digital Ocean, basta referenciá-las:

• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem30-serenata-mozilla.png

A indicação que a busca foi realizada e que tivemos resultados não está muito clara. Quando você pressiona "Pesquisar", não há uma indicação clara de que algo está acontecendo (nenhuma animação por exemplo) e como a busca não é feita com reload de pagina, pode parecer que não está acontecendo nada para o usuário.

Quando o resultado aparece, o espaço entre o formulário de busca e o primeiro resultado é muito grande. É necessário fazer scroll da tela para descobrir que retornou algo. Se a resolução do monitor não é tão alta, ou se a pessoa usa fontes maiores (como eu costumo usar), ela pode nem perceber que houve um resultado. Acredito que essa região abaixo poderia ser reduzida para que os resultados fiquem mais perto do formulário de busca e o usuário não precise fazer scroll para descobrir que tivemos resultados:

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/projeto-busca-tornar-diario-oficial-mais-acessivel/

Número

1

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.
se o conteúdo tiver uma imagem, não precisa adicionar ao repositório; todas as imagens estão na Digital Ocean, basta referenciá-las:

• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem28-imagem-dou.png

Criar uma seção na página "sobre" que possibilite a visualização de casos de sucesso (= conteúdos gerados com o Querido Diário a partir de parcerias, matérias jornalísticas, pesquisa acadêmica)

Essa funcionalidade já foi pensada desde o MVP do projeto e, portanto, já tem apêndice no código (conteúdo comentado ou não usado podem ser encontrados nos arquivos que tratam da página about) e só precisa da implementação de um carrossel ou algo do tipo pra funcionar.

Create a section on "about" page that allows the visualization of success stories (= content generated with Querido Diário from partnerships, journalistic articles, academic research)

This functionality has been thought of since the project's MVP and, therefore, already has an appendix in the code (commented or unused content can be found in the files related to about page) and only needs the implementation of a carousel or something like that to work.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/o-censo-dos-diarios-oficiais-ja-comecou-saiba-mais-sobre-como-o-levantamento-esta-sendo-planejado/

Número

6

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/plataforma-inedita-vai-permitir-busca-em-diarios-oficiais-de-municipios-brasileiros/

Número

10

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.
se o conteúdo tiver uma imagem, não precisa adicionar ao repositório; todas as imagens estão na Digital Ocean, basta referenciá-las:

• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem29-live-lancamento-qd.png

Recomendo a inclusão de âncoras para os itens do glossário. Dessa forma será possível a criação de links que referencie um item específico, facilitando a navegação e o compartilhamento. Isso tornará o Glossário mais reutilizável, podendo se tornar uma base de referência linkável.

English version bellow

Quando a busca de um termo não retorna nenhum resultado (pois o termo não foi encontrado nos diários daquele município), não há nenhuma mensagem na interface informando a pessoa usuária sobre a situação. Há apenas um card sobre o acesso do site do Diário em questão:

Isso só acontece quando há um município selecionado, como no exemplo acima. Quando não há município algum selecionado, a mensagem aparece:

Seria importante reproduzir essa mesma mensagem no caso dos municípios, mantendo o card da fonte oficial.

====================================

ENGLISH

When the search for a term does not return any results (since the term was not found in that municipality's gazettes), there is no message on the interface informing the user about the situation. There is only one card informing how to access the gazette website in question, as shown below:

This only happens when there is a selected municipality, as in the example above. When there is no municipality selected, the following message appears:

It would be important to reproduce this same message in the case of municipalities, keeping the official source card.

Adaptar o projeto para possibilitar um blog que padronize a maneira que postamos conteúdo no site do QD (textos mensais, materiais, usos acadêmicos). Este blog seria uma página a parte, que indexe todos os textos.

Adapt the project to enable a blog that standardizes the way we post content on the QD website (monthly texts, materials, academic uses). This blog would be a separate page, which indexes all texts.

Na sessão 'Níveis de Acesso' pode ser útil colocar número de cidades cadastradas por nível de acessos, para dar uma dimensão maior do total de municípios.

Exemplo:

Nível 0 de acesso - xxx cidades cadastradas - confira lista
Não possuímos a fonte de publicação do diário oficial deste município.

Nível 1 de acesso - xxx cidades - confira lista
Possuímos a fonte de publicação do diário oficial deste município.
Doe
Contribua com código

Nível 2 de acesso - xxx cidades - confira lista
Temos o script para coletar os arquivos e armazená-los em nossa base.
Precisamos da sua ajuda para conseguir desbloquear o formato fechado dos arquivos para publicá-lo aberto na plataforma.
[Doe]

Nível 3 de acesso - xxx cidades - confira lista
O conteúdo dos diários oficiais deste município está disponível na plataforma Querido Diário.

Hoje, quando é feita uma busca e a API retorna um erro, nada é exibido na tela.

Seria interessante a gente ter um tratamento para esses casos e exibir uma mensagem informando ao usuário que houve um problema com a busca.

No site do Querido Diário, o filtro por data parou de funcionar.

Exemplo: nesta busca por "lei de acesso à informação" (busca exata) em todos os municípios, no período de 01/01/2020 até 31/12/2020 (link da busca) está retornando a resultados como se não houvesse filtro por data (1481 sempre)

Na imagem, é possível ver um diário de 2016, ainda que a busca seja apenas em 2020

Por meio da API, esta mesma busca funciona, dando 149 resultados (link da busca na API)

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/contribua-para-libertar-a-informacao-dos-diarios-oficiais-das-capitais-brasileiras/

Número

3

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

O CONTRIBUTING do repositório está em português, para manter a documentação do repositório bilíngue ele precisa ser traduzido pro inglês.

Encorajado por okfn-brasil/querido-diario-comunidade#4.

Acredito que seguir a organização de documentos em outras línguas como no repositório okfn-brasil/querido-diario (languages/[language_code]/[document]) seja legal também.

English

The repo's CONTRIBUTING is in Portuguese and to keep the documentation bilingual it should be translated to English.

Encouraged by okfn-brasil/querido-diario-comunidade#4.

I believe that following the organization of documents in another languages like in okfn-brasil/querido-diario (languages/[language_code]/[document]) would be nice too.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/querido-diario-selecionado-por-programa-de-promocao-do-uso-de-ia-para-o-desenvolvimento-na-america-latina/

Número

4

Categoria

História

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.

Motivação

Adicionar notícia sobre o Querido Diário no blog do projeto

Link

https://ok.org.br/noticia/okbr-e-sete-parceiros-terao-apoio-do-google-para-monitorar-clima-em-diarios-oficiais/

Número

11

Categoria

Diário do Clima

O que é necessário?

1. Em src/assets/pages/blogposts/, conter um arquivo post-NUMERO.html, com o texto disponível no link acima, formatado em HTML.
2. Em src/assets/pages/blog.json, adicionar um novo conjunto de informações referentes ao post conforme destaque abaixo:

{
    "id": NUMERO,
    "title": "<-- insira título aqui, entre as aspas -->",
    "category":  "CATEGORIA",
    "content":  "<-- insira texto aqui, entre as aspas -->",
    "banner": "https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/banner-post<NUMERO>.png",
    "date": "<-- insira data da publicação original, entre as aspas, no formato DD/MM/AAAA -->",
    "author": "<-- insira nomes da autoria da publicação original, entre as aspas -->"
},

3. Em content, basta copiar e colar o conteúdo do arquivo .html que foi produzido no passo (1), removendo os "pula linha", deixando todo texto junto. Tome o cuidado também de escapar as aspas internas do content

OBSERVAÇÕES:
a ordem dos conjuntos de postagens no blog.json deve estar ordenada pelo id do maior para o menor.
se o conteúdo tiver uma imagem, não precisa adicionar ao repositório; todas as imagens estão na Digital Ocean, basta referenciá-las:

• https://querido-diario.nyc3.cdn.digitaloceanspaces.com/imagens_blog/imagem32-anuncio-diario-do-clima.png

O README do repositório está em português, para manter a documentação do repositório bilíngue ele precisa ser traduzido pro inglês.

Encorajado por okfn-brasil/querido-diario-comunidade#4.

Acredito que seguir a organização de documentos em outras línguas como no repositório okfn-brasil/querido-diario (languages/[language_code]/[document]) seja legal também.

English

The repo's README is in Portuguese and to keep the documentation bilingual it should be translated to English.

Encouraged by okfn-brasil/querido-diario-comunidade#4.

I believe that following the organization of documents in another languages like in okfn-brasil/querido-diario (languages/[language_code]/[document]) would be nice too.

Quando abrimos a página do Querido DIário, temos o formulário para fazermos a busca textual do conteúdo dos Diários. Porém sabemos que nem todas as cidades estão disponíveis (na prática, a maioria não tem busca textual disponível). Temos apenas uma indicação de nível de abertura (o que para um usuário novo não significa muita coisa).

Seria interessante ter disponível de uma maneira mais clara, quais os diários que realmente temos como fazer a busca textual do conteúdo. Pode ser uma lista na página, ou os nivels de acesso serem mais auto-explicativos (ao invés de 0, 1, 2, 3, ter um nome melhor). Acredito que isso tornaria o uso do site mais simples e prático.

O link para o repositório querido-diario-data-processing está como href e está incompleto. Deveríamos corrigí-lo para tornar um link para site externo com conteúdo "https://github.com/okfn-brasil/querido-diario-data-processing/".

Exemplo de comportamento atual:

Descrição

Ao selecionar o filtro de data na busca do Querido Diário, os caracteres iniciais do ano que são exibidos. Por exemplo:

Ficar que o ano é "20" não fica claro (é 2023? 2020?...). Uma melhoria interessante seria exibir os dois últimos carateres.

Português

As buscas do QD agora podem ser feitas seguindo a sintaxe simple query string query mas usuárias ainda não são informadas dessa possibilidade.

Uma ideia seria colocar como link no dropdown da busca "Sugestões de busca" para uma página de conteúdo no site do QD com exemplos de uso:

Outras sugestões também são bem vindas!

English

Searches in QD now can be done through the simple query string query syntax, but users are not being informed of this possibility yet.

An idea would be to put a link in the search dropdown "Sugestões de busca" for a content page in QD with examples:

Other suggestions are also welcome!