Translation - Lesson 3

Author: cedmenezes

docs/lessons/03-software-documentation/index.md

@@ -1,39 +1,39 @@
-# 03 - Explorando um projeto desconhecido
+# 03 - Exploring an unknown project
 
-<ah-external-content src="slides_fb.html" />
+<ah-external-content src="slides_cedm.html" />
 
-Este roteiro tem algumas perguntas com o objetivo de guiar a exploração do código e documentar suas descobertas. Você também pode aplicá-lo para qualquer outro projeto mal documentado em que precisar trabalhar no futuro.
+This script has some questions with the aim of guiding the exploration of the code and documenting its findings. You can also apply it for any other poorly documented project you need to work on in the future.
 
-Baixe o código do projeto a ser analisado [aqui](codigo.zip) e siga as perguntas. Elas são um guia de como explorar um projeto que vocês não conhecem.
+Download the project code to be analyzed [here](codigo.zip) and follow the questions. They are a guide to how to explore a project that you do not know.
 
 
-## Dependências e serviços usados
+## Dependencies and services used
 
 !!! question 
-    Quais tecnologias são usadas no código? Além da linguagem de programação, liste também as bibliotecas/módulos externos usados.
+    What technologies are used in code? In addition to the programming language, also list the external libraries/modules used.
 
 !!! question 
-    A aplicação utiliza um banco de dados. Qual gerenciador? Onde a aplicação busca a base de dados? Quais são as tabelas usadas? Como elas são criadas? 
+    The application uses a database. Which manager? Where does the application search for the database? What are the tables used? How are they created?
 
-## Deploy inicial
+## The initial deploy
 
 !!! question
-    A aplicação usa autenticação? Se sim, qual tipo? Como usuários são criados? Existe algum usuário administrador? Como é feita a segurança das senhas? Qual a senha padrão?
+    Does the application use authentication? If so, which guy? How are users created? Is there an administrator user? How is password security done? What is the default password?
 
 !!! question
-    Quais comandos você usou para rodar a aplicação? Escreva todos desde a criação do banco de dados e dos usuários até o funcionamento completo do projeto.
+    What commands did you use to run the application? Write everyone from creating the database and users to the full operation of the project.
 
 !!! question
-    Agora que você consegue rodar a aplicação, explore-a um pouco e descreva em poucas frases para quê ela serve.
+    Now that you can run the application, explore it a bit and describe in a few phrases for what it serves.
 
-## Documentação do projeto
+## Project Documentation 
 
 !!! question 
-    Se você fosse criar um guia de usuário (aluno) para esta aplicação, quais tarefas descreveria? 
+    If you were to create a user guide (student) for this application, what tasks would you describe? 
 
 !!! question 
-    Se você fosse criar um guia de usuário (professor) para esta aplicação, quais tarefas descreveria?
+    If you were to create a user guide (teacher) for this application, what tasks would you describe?
 
 !!! question 
-    O quê você descreveria em um guia de desenvolvedor para esta aplicação?
+    What would you describe in a developer guide for this application?