Updates documentation

5 files changed, 46 insertions, 23 deletions

diff --git a/content/published/00-intro/intro.md b/content/published/00-intro/intro.md
index 06e6fb4..5e5c7d0 100644
--- a/content/published/00-intro/intro.md
+++ b/content/published/00-intro/intro.md
@@ -1,11 +1,19 @@
 # Introdução {#intro}
 
-Criar Bookup ajudou a manter um esquema uniforme, ao invés de ter que
-implementar e corrigir funcionalidades paralelamente em muitos repositórios, já
-que os livros tendem a aumentar. Lidando com a produção de conteúdo como
-lidamos com outros códigos, mas sem algoritmizar, ao contrário: usando um
-processo arbóreo-espiral^[@TODO: definir o método arbóreo-espiral.].
+Bookup é um conjunto de templates, programas e fluxos de trabalho para a
+autoria de livros em formatos HTML, PDF e EPUB.
+
+Ele é um componente de software modular baseado em [Bookdown][].
+
+Foi criado para resolver o problema de editar muitos livros simultaneamente:
+Bookup ajuda a manter um esquema uniforme, ao invés de ter que implementar e
+corrigir funcionalidades paralelamente em muitos repositórios.
+
+Com ele, a produção de conteúdo fica parecida com o trabalho com outros
+códigos.
 
 Não foi priorizado investir tempo em generalizar tudo ao máximo. O mais
-importante foi criar uma base comum para os meus livros, e talvez no futuro
+importante foi criar uma base comum para os meus livros, e talvez aos poucos
 generalizar para que possa ser usado por outras iniciativas.
+
+[Bookdown]: https://bookdown.org
diff --git a/content/published/05-workflow/funcionamento.md b/content/published/05-workflow/funcionamento.md
new file mode 100644
index 0000000..66ff216
--- /dev/null
+++ b/content/published/05-workflow/funcionamento.md
@@ -0,0 +1,9 @@
+# Funcionamento {#funcionamento}
+
+Bookup opera através da _compilação_ de arquivos:
+
+```
+                                             /--> Livro PDF
+Arquivos fonte em Markdown --> Compilação -->
+                                             \--> Livro HTML
+```
diff --git a/content/published/10-installation/installation.md b/content/published/10-installation/installation.md
deleted file mode 100644
index b2e2392..0000000
--- a/content/published/10-installation/installation.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# Instalação {#instalacao}
-
-Procedimento de instalação:
-
-* Vendorização (repositórios `bookup` e de bibliografia).
-* Symlinking:
-  * `_bookdown.yml`.
-  * `output.yml`.
-* Arquivos requeridos:
-  * `.gitignore`.
-  * `images/cover.png`.
-  * `_bookup.yml`.
-  * `_biblio.yml`.
-  * `LICENSE`.
-  * `DISCLAIMER`.
-  * `snippets/{contact,cover,keywords,project,url,volume}.txt`.
diff --git a/content/published/05-structure/structure.md b/content/published/10-structure/structure.md
index edc1884..f413396 100644
--- a/content/published/05-structure/structure.md
+++ b/content/published/10-structure/structure.md
@@ -1,6 +1,6 @@
 # Estrutura de pastas {#estrutura}
 
-A estrutura de pastas de um projeto usando Bookup:
+A estrutura de pastas de um projeto usando Bookup é a seguinte:
 
 * `archive`: armazena versões antigas do livro.
 * `content`: o conteúdo do livro.
diff --git a/content/published/15-installation/installation.md b/content/published/15-installation/installation.md
new file mode 100644
index 0000000..9024b41
--- /dev/null
+++ b/content/published/15-installation/installation.md
@@ -0,0 +1,22 @@
+# Instalação {#instalacao}
+
+Procedimento de instalação do Bookup.
+
+## Vendorização
+
+* Vendorização (repositórios `bookup` e de bibliografia).
+
+## Links simbólicos
+
+* `_bookdown.yml`.
+* `output.yml`.
+
+## Arquivos requeridos
+
+* `.gitignore`.
+* `images/cover.png`.
+* `_bookup.yml`.
+* `_biblio.yml`.
+* `LICENSE`.
+* `DISCLAIMER`.
+* `snippets/{contact,cover,keywords,project,url,volume}.txt`.