aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSilvio Rhatto <rhatto@riseup.net>2015-11-07 18:46:04 -0200
committerSilvio Rhatto <rhatto@riseup.net>2015-11-07 18:46:04 -0200
commit0aef8860a6e9fc69ee2c4d840771a17413af647f (patch)
tree384a3de54f6d02f2bac521505465b8dd2fda4a9b
parentdb9761f9c42401bb408b252886b71f0fa6aa9c73 (diff)
downloadboaspraticas-0aef8860a6e9fc69ee2c4d840771a17413af647f.tar.gz
boaspraticas-0aef8860a6e9fc69ee2c4d840771a17413af647f.tar.bz2
Updates Versionamento
-rw-r--r--aulas/ambientes.rst8
-rw-r--r--aulas/reinventando.rst14
-rw-r--r--aulas/versionamento.rst145
3 files changed, 151 insertions, 16 deletions
diff --git a/aulas/ambientes.rst b/aulas/ambientes.rst
index a31b472..828f5b2 100644
--- a/aulas/ambientes.rst
+++ b/aulas/ambientes.rst
@@ -2,8 +2,10 @@
===============================
- Neste curso será adotado o sistema operacional GNU/Linux como plataforma básica de trabalho.
-- Porém, o conteúdo do curso pode ser facilmente adaptado para outros sistemas.
-- Se você usa Windows ou MacOSX para desenvolvimento e quiser seguir normalmente o curso, recomendamos a criação de uma máquina virtual em GNU/Linux usando o Vagrant de acordo com a aula de `DevOps <devops.html>`_.
+- Porém, o conteúdo do curso pode ser facilmente adaptado para outros sistemas, como é o caso do MacOSX.
+- Se você usa Windows, recomendamos:
+ - A criação de uma máquina virtual em GNU/Linux usando o Vagrant de acordo com a aula de `DevOps <devops.html>`_.
+ - Ou o uso do Cygwin juntamente com seu editor de textos favorito.
2.1 - Ambiente básico e a guerra dos editores de texto
------------------------------------------------------
@@ -41,7 +43,7 @@
2.4 - Scripts e templates
~~~~~~~~~~~~~~~~~~~~~~~~~
-- Scripts de produtividade.
+- Scripts e atalhos de produtividade.
- Templates de desenvolvimento.
2.5 - Atividades
diff --git a/aulas/reinventando.rst b/aulas/reinventando.rst
index 25f05fb..6303ba1 100644
--- a/aulas/reinventando.rst
+++ b/aulas/reinventando.rst
@@ -1,11 +1,19 @@
7. Quando (não) reinventar a roda
=================================
-6.1 - Antipatterns
+6.1 - Patterns
+--------------
+
+* Filosofia UNIX:
+ * Pequenos softwares/bibliotecas.
+ * Que fazem uma coisa bem.
+ * E que podem ser facilmente combinados.
+
+6.2 - Antipatterns
------------------
-6.2 - Inferno de dependências
+6.3 - Inferno de dependências
-----------------------------
-6.3 - Documentação: lendo e escrevendo
+6.4 - Documentação: lendo e escrevendo
--------------------------------------
diff --git a/aulas/versionamento.rst b/aulas/versionamento.rst
index ef1f7c2..0c50bc9 100644
--- a/aulas/versionamento.rst
+++ b/aulas/versionamento.rst
@@ -4,55 +4,180 @@
4.1 - O que é? Pra que serve?
-----------------------------
+Tópicos:
+
* Salvar o estado do código em revisões sequenciais.
* Integrar o trabalho do time.
* Acompanhar as mudanças no código (encontrar bugs, rollback, etc).
* Boa prática: versionando desde o dia 0.
+* Ajuda, mas não resolve conflitos na edição de arquivos.
+
+Imagens:
+
+* https://git-scm.com/book/en/v2/book/01-introduction/images/local.png
4.2 - Quais sistemas existem?
-----------------------------
+Tópicos:
+
* RCS (pré-histórico).
* CVS (roots, centralizado).
* Subversion (svn) (tradicional, centralizado).
* Mercurial (hg), Monotone (mtn), Bazaar (bzr), Darcs, Git (modernos, distribuídos).
+Imagens:
+
+* Ícones e screenshots do site de cada sistema.
+
4.2 - Centralizados versus distribuídos
---------------------------------------
+Tópicos:
+
+* Centralizado:
+
+ * Repositório central para onde são enviadas mudanças.
+ * Ou seja, existe uma cópia de referência.
+
+* Distribuído:
+
+ * Cada cópia de trabalho é um repositório completo e possui todo o histórico de revisões (também uma forma de backup).
+ * Não requer um repositório central, porém um ponto de trocas central pode ser estipulado entre os desenvolvedores/as.
+
+Imagens:
+
+* Centralizado: http://phillihp.com/wp-content/uploads/2012/06/scm.png
+* Distribuído: https://git-scm.com/book/en/v2/book/01-introduction/images/distributed.png
+
4.3 - Git: introdução
---------------------
+4.3 - Características
+~~~~~~~~~~~~~~~~~~~~~
+
+* Desenvolvido inicialmente por Linus Torvalds.
+* É o mais popular e difundido.
+* Complexo e poderoso, porém pode ser usado de modo simples.
+* Checagem de integridade nativa!
+
+4.3 - Instalando
+~~~~~~~~~~~~~~~~
+
+* Focaremos em git pela linha de comando.
+* Disponível em tudo que é tipo de sistema operacional.
+
+4.3 - Configurando
+~~~~~~~~~~~~~~~~~~
+
+A única exigência é especificar um nome e email (de preferência funcional ;)
+ara constar nas informações de revisão.
+
+::
+ git config --global user.name "Seu Nome"
+ git config --global user.email "seu@email"
+
+4.3 - Repositórios
+~~~~~~~~~~~~~~~~~~
+
+* Repositórios: "pastas geridas pelo git".
+* Iniciando um projeto no git:
+
+::
+ mkdir projeto
+ cd projeto
+ git init
+
+* Pasta ".git" criada no repositório: não polui seu projeto.
+
+4.3 - Trabalhando no projeto
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* Três estágios de mudanças: cometidas (commited), marcadas para commit (staged) e modificadas (changed).
+
+::
+ atom README.md # edite seu arquivo
+ git status
+ git add README.md # em seguida edite mais um pouco
+ git status
+ git diff
+ git commit -m "Primeira revisão"
+ git add README.md # mudanças recentes adicionadas ao estágio de lançamento
+ git commit -m "Segunda revisão"
+ git commit -a -m "Terceira revisão" # coloca todas as mudanças no estágio e comete
+
+Imagens:
+
+* https://git-scm.com/book/en/v2/book/01-introduction/images/areas.png
+
4.4 - Git: navegando no histórico
---------------------------------
-4.5 - Git: ramificações (branches)
-----------------------------------
+4.4 - Log de revisões
+~~~~~~~~~~~~~~~~~~~~~
+
+* Árvore de histórico do repositório.
+* Cada "revisão" do histórico representa um estado do repositório (snapshot).
+* ID da revisão: hash SHA-1.
+
+::
+ git log
+ git cola
+ gitk
+
+Imagens:
+
+* https://git-cola.github.io/images/screenshot-main-linux.png
+* https://static.lwn.net/images/ns/kernel/gitk.png
+
+4.4 - Revertendo uma mudança
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* Você pode fazer um novo commit na unha ou usar o ferramental do git.
+
+::
+ git commit --amend
+ git revert
+ git rebase
+
+4.5 - Ramificações (branches e merges)
+--------------------------------------
4.6 - Usando o git-flow
-----------------------
-4.7 - Social coding (gitlab, github, etc)
+4.7 - Submódulos
+----------------
+
+* Um repositório git dentro de outro.
+* Trava em revisões específicas.
+* "Sistema de empacotamento" simples e integrado ao git.
+
+4.8 - Social coding (gitlab, github, etc)
-----------------------------------------
-4.8 - Github: criando e forkando um projeto
+4.9 - Github: criando e forkando um projeto
-------------------------------------------
-4.9 - Github: fazendo um pull request
+4.10 - Github: fazendo um pull request
-------------------------------------
-4.10 - Github: sistema de tickets
+4.11 - Github: sistema de tickets
---------------------------------
-4.11 - Atividades
+4.12 - Atividades
-----------------
#. Instale o git.
-#. Crie uma conta do `Github <https://github.com>`_ e uma no `Gitlab <https://gitlab.com>`_.
+#. Crie uma conta do `Github <https://github.com>`_ ou no `Gitlab <https://gitlab.com>`_.
#. Faça um pequeno site com o Skeleton.
Referências
-----------
-- `Skeleton: Responsive CSS Boilerplate <http://getskeleton.com/>`_
-- `Versionamento Semântico 2.0.0 <http://semver.org/lang/pt-BR/>`_.
+* `cheatsheet do git-flow <https://danielkummer.github.io/git-flow-cheatsheet/index.pt_BR.html>`_.
+* `Skeleton: Responsive CSS Boilerplate <http://getskeleton.com/>`_
+* `Versionamento Semântico 2.0.0 <http://semver.org/lang/pt-BR/>`_.
+* `Curso Básico de Git - RBtech <https://www.youtube.com/watch?v=WVLhm1AMeYE&list=PLInBAd9OZCzzHBJjLFZzRl6DgUmOeG3H0>`_.
+* `Instalando Git <https://git-scm.com/book/pt-br/v1/Primeiros-passos-Instalando-Git>`_.
+* `git-cola: The highly caffeinated Git GUI <https://git-cola.github.io/>`_