Commit 11ad16502a0c9ce1e07ba389bc910f89df12dc11

Authored by Antonio Terceiro
Committed by Sergio Oliveira
1 parent f7aa2bc2

split intro into its own file

Showing 2 changed files with 61 additions and 60 deletions   Show diff stats
docs/index.rst
1 Software Público Brasileiro: Manual de Operação 1 Software Público Brasileiro: Manual de Operação
2 *********************************************** 2 ***********************************************
3 3
4 -Introdução  
5 -==========  
6 -  
7 -Bem-vindo a documentação do Portal do Software Público Brasileiro.  
8 -  
9 -O Portal do Software Público Brasileiro (SPB) é uma plataforma de  
10 -compartilhamento e colaboração no desenvolvimento de softwares. O  
11 -projeto de evolução deste portal está sendo desenvolvido pela  
12 -Universidade de Brasília.  
13 -  
14 -O SPB é composto de um conjunto de ferramentas com funcionalidades  
15 -complementares, que são desenvolvidas de forma independentes pelas suas  
16 -respectivas comunidades. Estas ferramentas estão sendo integradas pela  
17 -nossa equipe de forma a apresentar uma experiência de usuário  
18 -consistente.  
19 -  
20 -* O Colab_ é uma ferramenta especializada na integração de outras  
21 - ferramentas. O Colab fornece um ponto central de autenticação de  
22 - usuários para as demais ferramentas da plataforma, indexa informações  
23 - das demais ferramentas para busca e gamificação, e fornece integração  
24 - visual entre as diferentes ferramentas que compõem o SOB. O Colab é um  
25 - software livre criado no Brasil, que teve sua origem no  
26 - Programa `Interlegis` do Senado Federal.  
27 -  
28 -.. _Colab: https://github.com/colab-community  
29 -.. _`Programa Interlegis do Senado Federal`: http://www.interlegis.leg.br/  
30 -  
31 -* O Noosfero_ é uma plataforma para criação de redes sociais que conta com  
32 - diversas funcionalidades de gestão de conteúdo como blogs, galeria de  
33 - imagens e vídeos, entre outros. O Noosfero também é um software livre  
34 - criado no Brasil, iniciado em 2007 pela COLIVRE_ e que hoje conta com  
35 - uma comunidade de desenvolvimento que inclui o SERPRO, a Universidade de  
36 - Brasília e o Fórum Brasileiro de Economia Solidária.  
37 -  
38 -.. _Noosfero: http://www.noosfero.org/  
39 -.. _COLIVRE: http://www.colivre.coop.br/  
40 -  
41 -* O Gitlab_ é uma plataforma para desenvolvimento colaborativo. Projetos  
42 - no gitlab são mantidos em repositorios ``git``, com gestão de tarefas  
43 - (*issue tracker*), *merge requests*, gestão de marcos (*milestones*),  
44 - suporte a integração com plataformas de integração contínua e  
45 - notificações.  
46 -  
47 -.. _Gitlab: https://www.gitlab.com/  
48 -  
49 -* O `GNU Mailman`_ é uma gerenciador de listas de email tradicionalmente  
50 - usado por diversas organizações no Brasil e no mundo.  
51 -  
52 -.. _`GNU Mailman`: http://www.gnu.org/software/mailman/  
53 -  
54 -O restando deste manual descreve a arquitetura do SPB bem como os  
55 -procedimentos necessários para sua implantação, manutenção, backup e  
56 -restauração e gestão de firewall.  
57 -  
58 .. toctree:: 4 .. toctree::
59 :maxdepth: 1 5 :maxdepth: 1
60 6
61 -  
62 -.. include:: arquitetura.rst  
63 -.. include:: implantacao.rst  
64 -.. include:: manutencao.rst  
65 -.. include:: backup.rst  
66 -.. include:: firewall.rst 7 + introducao
  8 + arquitetura
  9 + implantacao
  10 + manutencao
  11 + backup
  12 + firewall
docs/introducao.rst 0 → 100644
@@ -0,0 +1,55 @@ @@ -0,0 +1,55 @@
  1 +Introdução
  2 +==========
  3 +
  4 +Bem-vindo a documentação do Portal do Software Público Brasileiro.
  5 +
  6 +O Portal do Software Público Brasileiro (SPB) é uma plataforma de
  7 +compartilhamento e colaboração no desenvolvimento de softwares. O
  8 +projeto de evolução deste portal está sendo desenvolvido pela
  9 +Universidade de Brasília.
  10 +
  11 +O SPB é composto de um conjunto de ferramentas com funcionalidades
  12 +complementares, que são desenvolvidas de forma independentes pelas suas
  13 +respectivas comunidades. Estas ferramentas estão sendo integradas pela
  14 +nossa equipe de forma a apresentar uma experiência de usuário
  15 +consistente.
  16 +
  17 +* O Colab_ é uma ferramenta especializada na integração de outras
  18 + ferramentas. O Colab fornece um ponto central de autenticação de
  19 + usuários para as demais ferramentas da plataforma, indexa informações
  20 + das demais ferramentas para busca e gamificação, e fornece integração
  21 + visual entre as diferentes ferramentas que compõem o SOB. O Colab é um
  22 + software livre criado no Brasil, que teve sua origem no
  23 + Programa `Interlegis` do Senado Federal.
  24 +
  25 +.. _Colab: https://github.com/colab-community
  26 +.. _`Programa Interlegis do Senado Federal`: http://www.interlegis.leg.br/
  27 +
  28 +* O Noosfero_ é uma plataforma para criação de redes sociais que conta com
  29 + diversas funcionalidades de gestão de conteúdo como blogs, galeria de
  30 + imagens e vídeos, entre outros. O Noosfero também é um software livre
  31 + criado no Brasil, iniciado em 2007 pela COLIVRE_ e que hoje conta com
  32 + uma comunidade de desenvolvimento que inclui o SERPRO, a Universidade de
  33 + Brasília e o Fórum Brasileiro de Economia Solidária.
  34 +
  35 +.. _Noosfero: http://www.noosfero.org/
  36 +.. _COLIVRE: http://www.colivre.coop.br/
  37 +
  38 +* O Gitlab_ é uma plataforma para desenvolvimento colaborativo. Projetos
  39 + no gitlab são mantidos em repositorios ``git``, com gestão de tarefas
  40 + (*issue tracker*), *merge requests*, gestão de marcos (*milestones*),
  41 + suporte a integração com plataformas de integração contínua e
  42 + notificações.
  43 +
  44 +.. _Gitlab: https://www.gitlab.com/
  45 +
  46 +* O `GNU Mailman`_ é uma gerenciador de listas de email tradicionalmente
  47 + usado por diversas organizações no Brasil e no mundo.
  48 +
  49 +.. _`GNU Mailman`: http://www.gnu.org/software/mailman/
  50 +
  51 +O restando deste manual descreve a arquitetura do SPB bem como os
  52 +procedimentos necessários para sua implantação, manutenção, backup e
  53 +restauração e gestão de firewall.
  54 +
  55 +