diff --git a/README.md b/README.md
index 38b7c66..6263501 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,37 @@
 CAMPUS CODE Dotfiles
 ====================
 
-## Source of inspiration
+## Introdução
 
-Our dotfiles are based on following amazing dotfiles:
+Nosso _dotfiles_ são inspirados nos seguintes excelentes dotfiles:
 
 [Skwp Dotfiles](http://github.com/skwp/dotfiles)
 
 [ThoughtBot Dotfiles](http://github.com/thoughtbot/dotfiles)
 
-## Requirements
+Esse dotfiles são usados nos nossos treinamentos, por isso a instalação desse
+dotfiles incluem alguns outros programas, os quais são parte do treinamento.
+
+## Softwares instalados
 
 * Zsh
 * [Ag](https://github.com/ggreer/the_silver_searcher)
-* [ITerm 2 (Mac)](https://www.iterm2.com/index.html)
-* MVim (Mac) or GVim (Linux)
 * [Solarized](http://ethanschoonover.com/solarized)
 * Tmux
 
-## Pre-Requirements
+Somente no MacOs
+
+* [ITerm 2 (Mac)](https://www.iterm2.com/index.html)
+* Chrome
+* Atom
+* Visual Studio Code
+* MVim
 
-- curl
+Somente no Ubuntu Family
+
+* GVim
+
+## Pre-Requirements
 
 Ubuntu
 
@@ -28,19 +39,19 @@ Ubuntu
 
 ## Install
 
-Run follow command:
+Execute o seguinte comando após instalar o `curl`:
 
 ```
 sh -c "`curl -fSs https://raw.githubusercontent.com/campuscode/cc_dotfiles/master/install.sh`"
 ```
 
-Type your password to change your default shell to `zsh`
+Sua senha será solicitada para completar a instalação quando necessário.
 
 ## Docs
 
-[Vim Key Mapping](Vim.md)
-
-[Tmux Key Mapping](Tmux.md)
+- [Vim Key Mapping](docs/Vim.md)
+- [Tmux Key Mapping](docs/Tmux.md)
+- [Zsh Key Mapping / Aliases](docs/Zsh.md)
 
 #### It's easy to make your customizations
 
diff --git a/Tmux.md b/docs/Tmux.md
similarity index 100%
rename from Tmux.md
rename to docs/Tmux.md
diff --git a/Vim.md b/docs/Vim.md
similarity index 100%
rename from Vim.md
rename to docs/Vim.md
diff --git a/docs/Zsh.md b/docs/Zsh.md
new file mode 100644
index 0000000..d727c6d
--- /dev/null
+++ b/docs/Zsh.md
@@ -0,0 +1,39 @@
+## Zsh
+
+### Caracter na linha de comando
+
+```
+~/workspace
+☻                                                                     ruby-2.7.0
+```
+
+Para substituir o "☻", basta incluir as seguintes variáveis no `.zshrc.local`:
+
+```
+export CC_GOOD_COMMAND=":)" # para exit 0, comando com sucesso
+export CC_BAD_COMMAND=":(" # para comandos com erro
+```
+
+### Key Bindings
+
+- Ctrl-A - Começo da linha
+- Ctrl-E - Fim da linha
+- Ctrl-R - pesquisa incremental no history
+- Ctrl-P - Pesquisa no history
+- Ctrl-N - Insere ultima palavra
+- Ctrl-T - Sudo e comando
+
+### Secrets
+
+Adicione suas variáveis de ambientes locais em `.secrets`
+
+### Aliases
+
+Leia o arquivo: `~/.aliases` para ver a quantidade de aliases úteis.
+
+Ser precisar rodar um comando sem o uso de alias, faça:
+
+`\comando`
+
+Ex: `\ls`
+
diff --git a/mac.sh b/mac.sh
index 2f36aff..6f2a848 100755
--- a/mac.sh
+++ b/mac.sh
@@ -4,6 +4,7 @@ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/
 brew install zsh ctags git hub tmux reattach-to-user-namespace the_silver_searcher
 brew install macvim --custom-icons --override-system-vim --with-lua --with-luajit
 brew cask install atom
+brew cask install visual-studio-code
 brew cask install google-chrome
 brew cask install iterm2
 
diff --git a/zshrc b/zshrc
index 81fd3d0..0600481 100644
--- a/zshrc
+++ b/zshrc
@@ -43,7 +43,7 @@ bindkey jj vi-cmd-mode
 # handy keybindings
 bindkey "^A" beginning-of-line
 bindkey "^E" end-of-line
-bindkey "^K" kill-line
+# bindkey "^K" kill-line #colide com ^K do vim mode
 bindkey "^R" history-incremental-search-backward
 bindkey "^P" history-search-backward
 bindkey "^Y" accept-and-hold