Merge tag '0.3.1' into develop

- updated main repository README.md and README-EN.md files with better information about the initiative

CHANGELOG.md

@@ -1,7 +1,7 @@
 # Changelog
 Project: Veritate Initiative - Fact Check Search and Aggregator)
 Description: A non-profit **fact checking agregator** for Brazilian news and politics.
-Version:     0.2.0
+Version:     0.3.1
 Author:      Celso Bessa
 Author URI:  https://www.celsobessa.com.br
 License:     GPL-2.0+
@@ -10,12 +10,27 @@ License URI: http://www.gnu.org/licenses/gpl-2.0.txt
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/)
 
+## 0.3.1  - [2018-05-22]
+
+### Changed
+- updated main repository README.md and README-EN.md files with better information about the initiative
+
+## 0.3.0  - [2018-05-18]
+
+### Added
+- Project Wiki at https://github.com/celsobessa/veritate/wiki, including How to Use guide. Initially, only in Brazilian Portuguese.
+
+### Changed
+- updated main repository README.md and README-EN.md files (some parts move to the project Wiki)
+- updated crawler, API and search components
+- Improved Veritate Crawler and API
+
 ## 0.2.0  - [2018-05-10]
 
-## Added
+### Added
 - Veritate Search proof of concept initital release ( https://veritatesearch.wowperations.com.br/ )
 
-## Changed
+### Changed
 - updated README.md and README-EN.md files (with some text revision by BitiAverbach)
 - Improved Veritate Crawler and API
 

LEIAME.md

@@ -1,5 +1,6 @@
 # Veritate Fact Check Search
 
-Agregador de Checagem de Fatos para o Brasil. Prova de conceito prevista para 7 de Maio de 2018.
+Veritate é um **projeto experimental sem fins lucrativos** para fortalecer checagens de fatos no Brasil. Composto por [Indexador](#indexador), [Índice Público/API](#indice-publico-api), e [Agregador/Busca](#agregador-busca) reunindo artigos diversas agências de **checagem de fatos**.
+<hr>
 
-> *As informações do projeto, em português, [estão no arquivo README.md](README.md).*
+> As informações do projeto, em português, *[estão no arquivo README.md](README.md).* ou na *[Wiki do Projeto](https://github.com/celsobessa/veritate/wiki)*.

README-EN.md

@@ -1,24 +1,27 @@
 # Veritate - Fact Check Search and Aggregator
 
-A **fact checking agregator** for Brazilian news and politics. A non-profit experiment.
+A non-profit experiment with the mission of strenghtening _fact checing_ in Brazil. Comprised by an [Crawler/Indexer](#crawler-indexer), [Public Index API](public-index-api) and **Fact Check** [Aggregator/Search](aggregator-search) for Brazilian news and politics.
+
 <hr>
 
 > **Para versão em português, [clique aqui](README.md).**
 
 <hr>
 
-> For more information, suggestions for fact check sites or to ask for removal of content violating copyright laws, please, send an email to veritate{at}wowperations[dot]com[dot]br
+> For more information, suggestions of new fact check outlets or to ask for removal of content, please, open an issue [at the project repository](https://github.com/celsobessa/veritate/issues) or send an email to veritate{at}wowperations[dot]com[dot]br
 
-## Sobre a iniciativa
+## About Veritate Initiative
 
-Developed by [Celso Bessa](https://www.celsobessa.com.br) with infrastructure support from [WoWPerations](https://www.wowperations.com.br), this is an experimental project, a proof of concept for a Fact Check crawler, aggregator and API focused on Brazilian news andp politics. The project goals are:
+Developed by [Celso Bessa](https://www.celsobessa.com.br) with infrastructure support from [WoWPerations](https://www.wowperations.com.br), this is an experimental project with the mission of strenghtening _fact checing_ in Brazil. Comprised by an [Crawler/Indexer](#crawler-indexer), [Public Index API](public-index-api) and **Fact Check** [Aggregator/Search](aggregator-search) for Brazilian news and politics.
 
-- Investigate, study and experiment with technologia, algorhythms, UX and design patters for improve algorhythm assisted journalism.
+- Research, experiment, develop and spread technologies, algorithms, design patterns and best practices for the improvement of digital journalism.
 - Improve access to high quality journalism
 - Instigate fact checking sharing and critical thinking against _fake news_
-- Instigate critical thinking and informed decisions about politics and votes
+- Instigate critical thinking and well informed decisions about politics and votes
+
+Initially, the project is comprised by an [Crawler/Indexer](#crawler-indexer), [Public Index API](public-index-api) and [Aggregator/Search](aggregator-search).
 
-Initially, the project will be comprised by an [Crawler/Indexer](#crawler-indexer), [Public Index API](public-index-api) and [Aggregator](aggregator-search).
+> If you understand brazilian portuguese, thhere is a *[Wiki](https://github.com/celsobessa/veritate/wiki)* with more in-depth information
 
 ### Veritate Overview
 
@@ -52,7 +55,14 @@ Right now, just [Agência Lupa](http://piaui.folha.uol.com.br/lupa/), [Agência
 
 ### How can my fact check outlet be indexed?
 
-Send an email (the address is above) with the outlet link. We will index only reputable and/or trustworth outlets according to our editorial. An editorial guideline is on roadmap , but we don't know when it will be published.
+You must open an issue [at the project repository](https://github.com/celsobessa/veritate/issues) with the following information
+
+- Outlet name
+- Outlet URL
+- Fact Checking section URL (if different from the main URL)
+- You Relationship with the oulet (reader, author, editor, publisher, etc)
+
+You can also send an email (the address is above) with the required information. We will index only reputable and/or trustworth outlets according to our editorial. An editorial guideline is on roadmap , but we don't know when it will be published.
 
 In the technological side, we give priority to websites using WordPress and using the Fact Check schema in a LD+JSON markup. Our crawler and algorithms also prefer faster, accessible and secure (HTTPS) websites, specially those easily accessible by mobile phones and screenreaders.
 

README.md

@@ -1,51 +1,31 @@
 # Veritate - Agregador e Buscador de Checagem de Fatos
 
-Veritate é um **projeto experimental sem fins lucrativos** de agregador/buscador reunindo artigos diversas agências de **checagem de fatos**.
+Veritate é um **projeto experimental sem fins lucrativos** para fortalecer checagens de fatos no Brasil. Composto por [Indexador](#indexador), [Índice Público/API](#indice-publico-api), e [Agregador/Busca](#agregador-busca) reunindo artigos diversas agências de **checagem de fatos**.
 <hr>
 
 > **For english version, [click here](README-EN.md).**
 
 <hr>
 
-> Para mais informações, para solicitar a inclusão de um site de checagem ou solicitar exclusão de material que viole direitos autorais, entre em contato através do email veritate{arroba}wowperations[ponto]com[ponto]br
+> Para mais informações, para solicitar a inclusão de um site de checagem ou solicitar exclusão de material, visite a *[Wiki do Projeto](https://github.com/celsobessa/veritate/wiki)* ou entre em contato através do email veritate{arroba}wowperations[ponto]com[ponto]br
 
 ## Sobre a iniciativa
 
-Idealizado pelo desenvolvedor <a href="https://www.celsobessa.com.br">Celso Bessa</a>, com suporte em hospedagem e infra-estrutura: <a href="https://www.wowperations.com.br">WoWPerations</a>, a iniciativa  Veritate tem como objetivos:
+Idealizado pelo desenvolvedor <a href="https://www.celsobessa.com.br">Celso Bessa</a>, com suporte em hospedagem e infra-estrutura: <a href="https://www.wowperations.com.br">WoWPerations</a>, a Iniciativa Veritate tem como missão fortalecer o jornalismo de checagem de fatos no Brasil:
 
 - Incentivar o consumo de jornalismo de qualidade
 - Estimular o compartilhamento de checagens de fatos
 - Instigar o senso crítico a respeito de notícias falsas (_Fake News_)
-- Fornecer uma ferramenta que ajude as pessoas a tomar decisões baseadas em informações verídicas
-- Investigar, estudar e experimentar tecnologias, algoritmo, padrões de design, experiência de uso em buscas, e jornalismo intermediado por algoritmo
+- Fornecer ferramentas que ajude as pessoas a tomar decisões baseadas em informações verídicas
+- Pesquisar, experimentar, desenvolver e divulgar tecnologias, algoritmos, padrões de design e melhores práticas para jornalismo digital.
 
-Inicialmente, a iniciativa terá os seguintes componentes: [Indexador](#indexador), [Índice Público/API](#indice-publico-api), e [Agregador/Busca](#agregador-busca).
+Inicialmente, a iniciativa conta com os seguintes componentes: [Indexador](#indexador), [Índice Público/API](#indice-publico-api), e [Agregador/Busca](#agregador-busca).
 
 ### Visão Geral - Veritate
 
 ![Diagrama com Visão Geral da Iniciativa Veritate - Versão 0.1.0](images/veritate-diagrama-visao-geral-0.1.0.png)
 
-### <a id="indexador">Indexador</a>
-
-Uma ferramenta para indexação, avaliação e organização de artigos publicados em veículos de checagem de fatos.
-
-No momento, estamos utilizando um serviço de terceiro (Saas) para rastreio (crawl) e raspagem de dados (scrapping) e um sistema próprio para avaliação e organização. É possível que num futuro próximo utilizemos infra-estrutura própria para rastreio/raspagem. Eventualmente, tornaremos público o sistema de avaliação.
-
-### <a id="indice-publico-api">Índice Público (API)</a>
-
-Um índice público com informações sobre as checagens de fatos indexadas para **consumo por sistemas**, que poderão consultá-lo através de uma API REST, com informações apresentadas em JSON.
-
-É a partir de sua API que alimentaremos o agregador e possibilitaremos a criação de serviços e sistemas por terceiros. Por exemplo, um plugin de WordPress poderia apresentar links de checagem de fatos para palavras-chave usadas no post de um blog.
-
-Para saber mais, visite o repositório oficial em [https://github.com/celsobessa/veritate-fact-check-crawler](https://github.com/celsobessa/veritate-fact-check-crawler) .
-
-### <a id="agregador-busca">Agregador/Busca</a>
-
-Uma [ferramenta de busca](https://veritatesearch.wowperations.com.br/) onde as pessoas irão encontrar links para artigos dos principais sites de checagem de fatos do Brasil.
-
-Por exemplo, uma pessoa que procurar a expressão "Lava Jato" verá uma série de links para checagens de fatos sobre a Operação Lava Jato nos sites indexados, e ao clicar nos links, , **lerá o conteúdo direto no site original**.
-
-*Uma prova de conceito da busca* pode ser acessada  [aqui](https://veritatesearch.wowperations.com.br/) . Como é um trabalho em progresso, é possível que erros aconteçam e que em alguns momentos a busca não esteja atualizada.
+Para saber mais detalhes sobre cada componente, visite a *[Wiki do Projeto](https://github.com/celsobessa/veritate/wiki)*
 
 ## Perguntas Frequentes (FAQ - Frequently Asked Questions)
 
@@ -55,7 +35,14 @@ Neste momento, apenas [Agência Lupa](http://piaui.folha.uol.com.br/lupa/), [Ag
 
 ### Como posso sugerir um veículo ou ter meu veículo adicionado?
 
-Envie um email para o endereço mencionado acima. Nós vamos indexar apenas sites respeitados ou com bom jornalismo, de acordo com nosso conselho editorial. Temos o plano de criar um guia editorial, mas ainda não sabemos quando ele será publicado.
+Se você quer sugerir algum veículo para ser indexado, abra uma "issue" [no repositório oficial](https://github.com/celsobessa/veritate/issues) com as seguintes informações:
+
+- Nome do Veículo
+- URL do veículo
+- URL da seção de checagens (se diferente da URL principal)
+- Sua relação com o veículo (leitor, autor, editor, publisher, etc)
+
+Você também pode enviar um email para o endereço mencionado acima com as mesmas informações. Nós vamos indexar apenas sites respeitados ou com bom jornalismo, de acordo com nosso conselho editorial. Temos o plano de criar um guia editorial, mas ainda não sabemos quando ele será publicado.
 
 No aspecto tecnológico, nós priorizamos sites usando WordPress e que usem o markup LD+JSON para checagem de fatos. Nosso rastreador e nosso algoritmo privilegia sites rápidos, acessíveis e seguros (usando HTTPS), especialmente os acessíveis facilmente por celulares ou leitores de tela. E se você der permissão expressa podemos apresentar pequenos trechos (entre 140 e 280 caracteres) do artigo de seu site, para que o conteúdo seja rastreado mais rapidamente e tenha prioridade entre os resultados.