Skip to content

Commit 0228d9d

Browse files
CanduriFranklinCanduriFranklin
committed
docs: adicionar perfis de Franklin Canduri (pt, en, es, main) em um novo branch feat/community/CanduriFranklin; incluir edumagalhaess.md
1 parent 15fd19e commit 0228d9d

File tree

5 files changed

+499
-4
lines changed

5 files changed

+499
-4
lines changed

‎community/CanduriFranklin-en.md‎

Lines changed: 140 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,140 @@
1+
# Professional Guide to Git and GitHub
2+
English Version
3+
4+
---
5+
6+
## 📖 Introduction
7+
**Git** is a distributed version control system widely used to track changes in files and coordinate work on software projects.
8+
**GitHub** is a cloud-based platform that uses Git to host repositories and facilitate collaboration among developers.
9+
10+
---
11+
12+
## 🔑 Fundamental Concepts
13+
14+
### What is Git?
15+
Git is a distributed version control system created by **Linus Torvalds in 2005** to manage the Linux kernel development.
16+
It is known for its **efficiency, reliability**, and support for **non-linear workflows**.
17+
18+
📚 Official documentation: [Git Documentation](https://git-scm.com/doc)
19+
20+
### What is GitHub?
21+
GitHub is a platform that uses Git to host code repositories.
22+
Beyond storage, it provides collaboration tools such as **pull requests, issues, code reviews, and GitHub Actions**.
23+
24+
📚 Official documentation: [GitHub Docs](https://docs.github.com/)
25+
26+
---
27+
28+
## ⚙️ Git Features
29+
- Distributed: every developer has a complete copy of the repository history.
30+
- Fast: operations such as commits, diffs, and merges are performed locally.
31+
- Secure: uses SHA-1 to ensure integrity.
32+
- Flexible: supports multiple workflows and integrations.
33+
34+
## 🌐 GitHub Features
35+
- Collaboration: pull requests, code reviews, and discussions.
36+
- Continuous Integration: automation with GitHub Actions.
37+
- Documentation: support for wikis and README files.
38+
- Community: millions of active projects and developers.
39+
40+
📚 README Guide: [GitHub - About READMEs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)
41+
📚 Repository Guide: [GitHub - About Repositories](https://docs.github.com/en/repositories/creating-and-managing-repositories/about-repositories)
42+
43+
---
44+
45+
## 📝 Basic Git Commands
46+
47+
- Initialize a repository
48+
```bash
49+
git init
50+
Clone a repository
51+
52+
bash
53+
git clone <repository-url>
54+
Check status
55+
56+
bash
57+
git status
58+
Add files
59+
60+
bash
61+
git add <file>
62+
Commit changes
63+
64+
bash
65+
git commit -m "Commit message"
66+
Push changes
67+
68+
bash
69+
git push origin <branch-name>
70+
🚀 Advanced Git Commands
71+
View commit history
72+
73+
bash
74+
git log
75+
Create and switch to a new branch
76+
77+
bash
78+
git checkout -b <branch-name>
79+
Merge branches
80+
81+
bash
82+
git merge <branch-name>
83+
Resolve conflicts
84+
85+
bash
86+
git status
87+
git add <file>
88+
git commit
89+
Revert a commit
90+
91+
bash
92+
git revert <commit-hash>
93+
Reset to a previous state
94+
95+
bash
96+
git reset --hard <commit-hash>
97+
✅ Best Practices
98+
Small and frequent commits.
99+
100+
Clear and descriptive commit messages.
101+
102+
Separate branches for new features.
103+
104+
Code reviews before merging.
105+
106+
📚 Official best practices: GitHub Flow
107+
108+
🛠️ Additional GitHub Resources
109+
GitHub CLI → GitHub CLI Docs
110+
111+
GitHub Copilot → GitHub Copilot Docs
112+
113+
GitHub Sponsors → GitHub Sponsors
114+
115+
🌍 Other Official Documentation Platforms
116+
Microsoft Learn (Azure DevOps & Git) → Microsoft Learn - Azure DevOps
117+
118+
GitLab Documentation → GitLab Docs
119+
120+
Atlassian Bitbucket Documentation → Bitbucket Docs
121+
122+
SourceForge Documentation → SourceForge Docs
123+
124+
GNU Savannah (Free Software Projects) → Savannah Docs
125+
126+
🎯 Motivation for This Contribution
127+
This guide was created with the following goals:
128+
129+
Facilitate learning Git and GitHub.
130+
131+
Promote best practices in version control and collaboration.
132+
133+
Serve as a quick reference for essential commands.
134+
135+
Contribute to the community by providing accessible and organized material.
136+
137+
Inspire developers to explore official documentation across multiple platforms.
138+
139+
📌 Conclusion
140+
Git and GitHub are indispensable tools for modern teams. With Git, you can efficiently manage project history. With GitHub, you can expand collaboration and integrate automations that accelerate development. With platforms like Microsoft Learn, GitLab, and Bitbucket, you can broaden your knowledge and adapt workflows to different ecosystems.

‎community/CanduriFranklin-es.md‎

Lines changed: 140 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,140 @@
1+
# Guía Profesional de Git y GitHub
2+
Versión en Español
3+
4+
---
5+
6+
## 📖 Introducción
7+
**Git** es un sistema de control de versiones distribuido ampliamente utilizado para rastrear cambios en archivos y coordinar el trabajo en proyectos de software.
8+
**GitHub** es una plataforma basada en la nube que utiliza Git para alojar repositorios y facilitar la colaboración entre desarrolladores.
9+
10+
---
11+
12+
## 🔑 Conceptos Fundamentales
13+
14+
### ¿Qué es Git?
15+
Git es un sistema de control de versiones distribuido creado por **Linus Torvalds en 2005** para gestionar el desarrollo del kernel de Linux.
16+
Es conocido por su **eficiencia, confiabilidad** y soporte para **flujos de trabajo no lineales**.
17+
18+
📚 Documentación oficial: [Git Documentation](https://git-scm.com/doc)
19+
20+
### ¿Qué es GitHub?
21+
GitHub es una plataforma que utiliza Git para alojar repositorios de código.
22+
Además del almacenamiento, ofrece herramientas de colaboración como **pull requests, issues, revisiones de código y GitHub Actions**.
23+
24+
📚 Documentación oficial: [GitHub Docs](https://docs.github.com/)
25+
26+
---
27+
28+
## ⚙️ Características de Git
29+
- Distribuido: cada desarrollador tiene una copia completa del historial del repositorio.
30+
- Rápido: operaciones como commits, diffs y merges se realizan localmente.
31+
- Seguro: utiliza SHA-1 para garantizar la integridad.
32+
- Flexible: soporta múltiples flujos de trabajo e integraciones.
33+
34+
## 🌐 Características de GitHub
35+
- Colaboración: pull requests, revisiones de código y discusiones.
36+
- Integración continua: automatización con GitHub Actions.
37+
- Documentación: soporte para wikis y archivos README.
38+
- Comunidad: millones de proyectos y desarrolladores activos.
39+
40+
📚 Guía de README: [GitHub - About READMEs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)
41+
📚 Guía de Repositorios: [GitHub - About Repositories](https://docs.github.com/en/repositories/creating-and-managing-repositories/about-repositories)
42+
43+
---
44+
45+
## 📝 Comandos Básicos de Git
46+
47+
- Inicializar un repositorio
48+
```bash
49+
git init
50+
Clonar un repositorio
51+
52+
bash
53+
git clone <url-del-repositorio>
54+
Verificar estado
55+
56+
bash
57+
git status
58+
Agregar archivos
59+
60+
bash
61+
git add <archivo>
62+
Hacer commit
63+
64+
bash
65+
git commit -m "Mensaje del commit"
66+
Enviar cambios
67+
68+
bash
69+
git push origin <nombre-del-branch>
70+
🚀 Comandos Avanzados de Git
71+
Ver historial de commits
72+
73+
bash
74+
git log
75+
Crear y cambiar a un nuevo branch
76+
77+
bash
78+
git checkout -b <nombre-del-branch>
79+
Fusionar branches
80+
81+
bash
82+
git merge <nombre-del-branch>
83+
Resolver conflictos
84+
85+
bash
86+
git status
87+
git add <archivo>
88+
git commit
89+
Revertir un commit
90+
91+
bash
92+
git revert <hash-del-commit>
93+
Resetear a un estado anterior
94+
95+
bash
96+
git reset --hard <hash-del-commit>
97+
✅ Buenas Prácticas
98+
Commits pequeños y frecuentes.
99+
100+
Mensajes de commit claros y descriptivos.
101+
102+
Branches separados para nuevas funcionalidades.
103+
104+
Revisiones de código antes de hacer merges.
105+
106+
📚 Guía oficial de buenas prácticas: GitHub Flow
107+
108+
🛠️ Recursos Adicionales de GitHub
109+
GitHub CLI → GitHub CLI Docs
110+
111+
GitHub Copilot → GitHub Copilot Docs
112+
113+
GitHub Sponsors → GitHub Sponsors
114+
115+
🌍 Otras Plataformas con Documentación Oficial
116+
Microsoft Learn (Azure DevOps & Git) → Microsoft Learn - Azure DevOps
117+
118+
GitLab Documentation → GitLab Docs
119+
120+
Atlassian Bitbucket Documentation → Bitbucket Docs
121+
122+
SourceForge Documentation → SourceForge Docs
123+
124+
GNU Savannah (Proyectos de Software Libre) → Savannah Docs
125+
126+
🎯 Motivación de Esta Contribución
127+
Este guía fue creada con los siguientes objetivos:
128+
129+
Facilitar el aprendizaje de Git y GitHub.
130+
131+
Promover buenas prácticas de versionamiento y colaboración.
132+
133+
Servir como referencia rápida para comandos esenciales.
134+
135+
Contribuir con la comunidad ofreciendo material accesible y organizado.
136+
137+
Inspirar a los desarrolladores a explorar documentación oficial en múltiples plataformas.
138+
139+
📌 Conclusión
140+
Git y GitHub son herramientas indispensables para equipos modernos. Con Git, puedes gestionar el historial de manera eficiente. Con GitHub, puedes ampliar la colaboración e integrar automatizaciones que aceleran el desarrollo. Con plataformas como Microsoft Learn, GitLab y Bitbucket, puedes ampliar tu conocimiento y adaptar flujos de trabajo a diferentes ecosistemas.

0 commit comments

Comments
 (0)