miniguias

Guias rápidos para a utilização de projetos e ferramentas da comunidade OKBR.

Estão todos listados em https://okfn-brasil.github.io/miniguias/

Adicionar um novo Miniguia

Supondo ambinete UBUNTU 16 LTS

1. instalar comando mkdocs, http://www.mkdocs.org/
2. git clone https://github.com/okfn-brasil/miniguias.git e cd miniguias
3.  Para criar pasta chamada NovoGuia123 usar mkdocs new NovoGuia123... deixar o shell posicionando,cd NovoGuia123
4. Editar e criar todos os doc.md que desejar sob NovoGuia123/docs
5. rodar mkdocs build
6. git add e  git push de tudo o que fez...
7. espera 2 minutos o git preparar o site... pronto: a nova documentação está na URL https://okfn-brasil.github.io/miniguias/NovoGuia123/site/  
   (não esquecer de editar index.html incluindo a URL do novo miniguia)

Entendendo a proposta

A maioria das ferramentas e ambientes de participação da OKBR requerem uma certa familiarização.

Um miniguia é um documento com instruções, servindo tanto para "quebrar o gelo" e acolher quem quer dar os seus primeiros passos com um pouco mais de segurança, como para suprir as demandas de tradução de fast guides já existentes.