TABLA DE CONTENIDO

RESUMEN EJECUTIVO .................................................................................................... 2

INTRODUCCIÓN ............................................................................................................... 3
Objetivos del Informe ......................................................................................................... 4
1. Proceso de Clonación y Uso ....................................................................................... 4
1.1 Instalación de Git ................................................................................................. 4
1.2 Descarga de Git ................................................................................................... 5
1.3 Instalación en el Sistema ..................................................................................... 5
1.4 Verificación de la Instalación ............................................................................... 6
1.5 Creación de una Cuenta en GitHub ..................................................................... 6
1.6 Clonación del Repositorio .................................................................................... 7
1.7 Clona el Repositorio ............................................................................................ 8
1.8 Exploración del Repositorio ............................................................................... 10
1.8.1 Lectura del Archivo README.md ............................................................... 10
CONCLUSIONES ............................................................................................................ 15
BIBLIOGRAFIA ................................................................................................................ 16
RESUMEN EJECUTIVO

Este informe tiene como objetivo experimentar con las funcionalidades de las herramientas
de control de versiones, centrándonos en Git y GitHub. Los pasos clave incluyen la
instalación de Git, la creación de una cuenta en GitHub y la creación de una copia local del
repositorio "OWASP Top 10 2021".

El control de versiones es esencial para el desarrollo de software, permitiendo el

seguimiento de cambios y la colaboración efectiva. Git es una herramienta de control de
versiones ampliamente utilizada, y GitHub es una plataforma que facilita la colaboración en
proyectos gestionados con Git.

Pasos Clave:

Instalación de Git: Se recomienda descargar e instalar Git desde el sitio web oficial.

Creación de una cuenta en GitHub: Es necesario registrarse en GitHub para aprovechar

sus capacidades de alojamiento remoto y colaboración.

Copia Local del "OWASP Top 10 2021": Utilizando Git, se clona el repositorio "OWASP Top
10 2021" desde GitHub a una ubicación local. Esto permite acceder a la documentación y
realizar cambios si es necesario.

Este ejercicio brinda una experiencia práctica en el uso de Git y GitHub para el control de
versiones y la colaboración en proyectos de desarrollo de software. Estas herramientas son
fundamentales para el seguimiento de cambios y la gestión eficaz de proyectos. El informe
destaca la importancia de Git y GitHub como recursos valiosos en el desarrollo de software
y cómo estos contribuyen a mejorar la productividad y la colaboración en equipos de
desarrollo.
INTRODUCCIÓN

En el entorno altamente dinámico y colaborativo del desarrollo de software, el control de

versiones se alza como un pilar fundamental. Este informe tiene como objetivo llevar a cabo
una inmersión detallada en las funcionalidades cruciales de las herramientas de control de
versiones, con un enfoque particular en Git y GitHub. A través de una serie de pasos
concretos, se persigue adquirir una comprensión profunda de estas herramientas, así como
destacar su relevancia y utilidad en el panorama actual del desarrollo de software.

El control de versiones no es solo una práctica técnica; es una práctica estratégica que
conlleva implicaciones cruciales para la calidad, la colaboración y la trazabilidad en
proyectos de software. Git, en su calidad de sistema de control de versiones distribuido, ha
transformado de manera significativa la manera en que los equipos gestionan sus códigos
fuente y colaboran de manera efectiva.

En este informe, presentaremos un enfoque meticuloso que abarcará desde la instalación

de Git hasta la creación de una cuenta en GitHub, culminando en la creación exitosa de
una copia local de un repositorio específico, en este caso, el "OWASP Top 10 2021". Este
recurso es esencial en la identificación y mitigación de vulnerabilidades de seguridad en
aplicaciones web, lo que subraya aún más la importancia del control de versiones en un
contexto donde la seguridad es primordial.
Objetivos del Informe

El presente informe tiene como objetivo principal la exploración y comprensión exhaustiva

de las herramientas de control de versiones, con un enfoque específico en Git y GitHub.

Objetivos específicos

• Instalación de Git.
• Creación de una Cuenta en GitHub.
• Copia Local del OWASP Top 10 2021.

1. Proceso de Clonación y Uso

El proceso de clonación y uso de Git y GitHub desempeña un papel central en nuestra

exploración de estas herramientas de control de versiones. Una vez que hemos instalado
Git y creado una cuenta en GitHub, la clonación de un repositorio se convierte en la puerta
de entrada a un mundo de colaboración y seguimiento de cambios en el desarrollo de
software.

La clonación de un repositorio, como ilustraremos en este informe, implica traer una copia
completa del proyecto desde el repositorio remoto de Git a nuestro entorno local. Este paso
sencillo nos permite acceder a todos los archivos y la historia de cambios asociados con el
proyecto. Desde aquí, podemos realizar modificaciones, crear ramas para el desarrollo de
características específicas y realizar commits para registrar cambios significativos.

El proceso de clonación y uso de Git y GitHub no solo se trata de gestionar archivos, sino
también de fomentar la colaboración efectiva. A medida que trabajamos en nuestros
proyectos locales, podemos compartir nuestros cambios con otros colaboradores, mantener
un registro preciso de quién hizo qué y cuándo, y resolver conflictos de manera eficiente en
caso de que varios colaboradores modifiquen el mismo archivo simultáneamente.

1.1 Instalación de Git

La instalación de Git es el primer paso crucial en nuestra exploración del control de

versiones con Git y GitHub. Git, como un sistema de control de versiones distribuido,
proporciona las bases necesarias para rastrear y gestionar cambios en el código fuente de
manera eficiente. Este proceso de instalación se adapta a múltiples sistemas operativos, lo
que lo hace accesible y versátil para una amplia gama de entornos de desarrollo.

La instalación de Git garantiza que los desarrolladores puedan aprovechar todas las
capacidades de esta herramienta esencial, incluyendo la creación de repositorios locales,
el seguimiento de cambios, la gestión de ramas y la colaboración en proyectos distribuidos.
En este informe, ofreceremos instrucciones detalladas para instalar Git en diversos
sistemas operativos, asegurando que los lectores puedan configurar esta poderosa
herramienta sin inconvenientes. Una vez que Git esté instalado y configurado
adecuadamente, estaremos listos para adentrarnos en la creación de cuentas en GitHub y
en la clonación de repositorios, lo que permitirá una experiencia completa en el control de
versiones y colaboración en proyectos de desarrollo de software.

1.2 Descarga de Git

El primer paso que tomé para integrar Git en mi flujo de trabajo fue la descarga de la
herramienta. Encontré que Git está ampliamente disponible y es compatible con varios
sistemas operativos, lo que facilita su adquisición. Para ello, visité el sitio oficial de Git en
https://git-scm.com/ y seleccioné la versión adecuada para mi sistema operativo. Opté por
la versión para Windows, ya que es el sistema que utilizo. La descarga fue rápida y directa,
lo que me permitió avanzar rápidamente hacia la instalación.

1.3 Instalación en el Sistema

Una vez que descargué el instalador de Git, procedí a iniciar el proceso de instalación en
mi sistema. La instalación en Windows fue bastante sencilla y siguió un flujo de trabajo
intuitivo. Durante la instalación, se me presentaron diversas opciones de configuración,
como la ubicación de instalación y las componentes adicionales. Dado que estoy
empezando, decidí mantener las configuraciones predeterminadas, ya que suelen ser
adecuadas para la mayoría de los usuarios. Además, aseguré seleccionar la opción que
agrega Git al PATH del sistema, lo que facilita el acceso a Git desde la línea de comandos.
1.4 Verificación de la Instalación

Una vez que finalizó la instalación, era importante para mí verificar que Git se hubiera
instalado correctamente en mi sistema. Para hacerlo, abrí una ventana de comandos y
escribí el siguiente comando:

git –version

1.5 Creación de una Cuenta en GitHub

Luego de haber instalado Git, el siguiente paso crucial en mi exploración de las

herramientas de control de versiones fue la creación de una cuenta en GitHub. GitHub es
una plataforma esencial que facilita el alojamiento de proyectos de software, la colaboración
entre equipos y el seguimiento de cambios utilizando Git.
1. Accedí al sitio web de GitHub en https://github.com/ desde mi navegador.
2. Una vez en la página principal de GitHub, busqué y seleccioné la opción "Sign up"
(Registrarse) para comenzar el proceso de registro.
3. Llené el formulario de registro, proporcionando mi dirección de correo electrónico,
una contraseña segura y un nombre de usuario único.
4. Después de completar el formulario, hice clic en "Create account" (Crear cuenta)
para continuar.
5. GitHub me solicitó verificar mi dirección de correo electrónico mediante un código
de verificación que me enviaron por correo electrónico. Ingresé el código de
verificación para confirmar mi dirección de correo electrónico.
 6. Luego, fui dirigido a una página donde tuve la opción de elegir un plan de GitHub.
Opté por el plan gratuito, que es perfecto para proyectos personales y pequeños
equipos.
7. Finalmente, completé un breve cuestionario opcional sobre mis intereses en
desarrollo de software y mi nivel de experiencia.
Tras completar estos pasos, mi cuenta en GitHub quedó creada exitosamente. Esto me
permitió acceder a todas las características y funcionalidades que GitHub ofrece,
incluyendo la capacidad de crear y alojar repositorios, colaborar en proyectos con otros
desarrolladores y contribuir a proyectos de código abierto. La creación de una cuenta en
GitHub marcó el inicio de mi viaje hacia la gestión de versiones y la colaboración en
proyectos de desarrollo de software de manera efectiva.

1.6 Clonación del Repositorio

Una vez que había instalado Git y creado mi cuenta en GitHub, el siguiente paso en mi
proceso de aprendizaje fue la clonación de un repositorio. En este caso, decidí clonar el
repositorio "OWASP Top 10 2021" desde GitHub a mi máquina local. Esto me permitió
acceder a la documentación esencial sobre las vulnerabilidades de seguridad en
aplicaciones web y experimentar directamente con Git y GitHub.

Pasos que seguí para llevar a cabo la clonación del repositorio:

Encontrar el Repositorio: Utilicé el navegador web para visitar la página del repositorio
"OWASP Top 10 2021" en GitHub, que se encuentra en la siguiente dirección:
https://github.com/OWASP/Top10/tree/master/2021.
Copiar la URL del Repositorio: En la página del repositorio, hice clic en el botón "Code" y
luego copié la URL del repositorio. Pude elegir entre utilizar HTTPS o SSH, dependiendo
de mi configuración de GitHub.

1.7 Clona el Repositorio

Selecciono el Repositorio en GitHub: Abro mi navegador web y accedo al repositorio que

deseo clonar. En este caso, quiero clonar el "OWASP Top 10 2021", por lo que utilizo el
siguiente enlace: https://github.com/OWASP/Top10/tree/master/2021.

Obtengo la URL del Repositorio: En la página del repositorio, hago clic en el botón "Code"
(o "Código") que se encuentra en la esquina superior derecha del repositorio. Esto despliega
un menú donde puedo copiar la URL del repositorio https://github.com/OWASP/Top10.git .
Opto por utilizar la URL HTTPS, que es adecuada para la mayoría de los casos.
Abro la Terminal: En mi computadora, abro una terminal para trabajar con Git desde la
línea de comandos. Esto me permitirá ejecutar los comandos necesarios para clonar el
repositorio.

Selecciono una Carpeta de Destino: Antes de clonar el repositorio, navego hasta la

ubicación en mi sistema donde quiero que se cree la copia local del repositorio en D:\Git.
Utilizo el comando cd para cambiar al directorio deseado.

Clono el Repositorio: En la terminal, utilizo el comando git clone seguido de la URL del
repositorio que copié previamente.

Esto descargará y clonará el repositorio "OWASP Top 10 2021" en mi máquina local.

Exploración del Repositorio: Una vez que se completó la clonación, tenía una copia local
del repositorio "OWASP Top 10 2021" en mi máquina. Pude explorar y acceder a todos los
archivos y la historia de cambios asociados con este repositorio.

Estos pasos me permitieron clonar con éxito el repositorio desde GitHub a mi entorno local,
lo que abrió la puerta para realizar cambios, crear ramas para el desarrollo de nuevas
características y colaborar de manera efectiva en proyectos utilizando Git y GitHub. La
clonación de un repositorio es una acción fundamental en el proceso de control de versiones
y gestión de proyectos de desarrollo de software.
1.8 Exploración del Repositorio

Tras haber clonado con éxito el repositorio "OWASP Top 10 2021" en mi máquina local, mi
siguiente paso crucial fue explorar su contenido y revisar detenidamente la información que
albergaba. Esto es fundamental para comprender el propósito y el alcance del repositorio,
así como para identificar cualquier recurso o dato relevante.

1.8.1 Lectura del Archivo README.md

El archivo README.md del repositorio "OWASP Top 10 2021" proporciona información
importante sobre cómo trabajar con este repositorio, incluyendo las instrucciones para
construir una copia local, realizar pruebas locales, y contribuir a la traducción del proyecto.

Instalación de Python

Primero, visito el sitio web oficial de Python en https://www.python.org/downloads/windows/.

Descargo la última versión estable de Python para Windows (Python 3.11) haciendo clic en
el enlace de descarga correspondiente. Aseguro de elegir el instalador que tiene la
extensión ".exe".

Ejecuto el archivo descargado. El asistente de instalación de Python se abrirá.

Sigo las instrucciones del instalador, asegurándome de marcar la opción "Add Python 3.11
to PATH" durante la instalación. Esto es importante para que Python se agregue
automáticamente al PATH del sistema.

Una vez que la instalación ha finalizado, abro la línea de comandos (cmd) y verifico la
instalación escribiendo python --version. Esto me asegura que Python se ha instalado
correctamente y veo la versión instalada.
 1. Abro una terminal en mi computadora.
2. Navego al directorio principal del repositorio "OWASP Top 10 2021" que
previamente cloné en mi máquina local. Utilizo el comando cd para cambiar al
directorio correcto.
3. Una vez que estoy en el directorio raíz del repositorio, ejecuto el comando make
install-python-requirements para instalar las dependencias de Python necesarias
para el proyecto.

Al ejecutar el comando sale error, se tiene que instalar el make de :

https://sourceforge.net/projects/gnuwin32/
Cd 2021

```bash
cd 2021
mkdocs serve
```
Problemas encontrados al configurar MkDocs con el plugin 'i18n' para la creación de un
sitio web de documentación multilingüe. A pesar de los esfuerzos realizados para solucionar
los problemas, algunos errores persisten y requieren una revisión más profunda.

Error en la Configuración de 'i18n'

Uno de los errores principales encontrados se refiere a la configuración del plugin 'i18n' en
el archivo mkdocs.yml. Se ha verificado que la configuración se ajusta al formato
recomendado y se ha seguido la documentación oficial, sin embargo, el siguiente error
persiste:

ERROR - Config value 'plugins': Plugin 'i18n' option 'languages': Expected a list of items,
but a <class 'dict'> was given.
Este error indica que se esperaba una lista de idiomas, pero en su lugar se proporcionó un
diccionario. La configuración del plugin 'i18n' en el archivo mkdocs.yml

Acciones Realizadas
Se han realizado las siguientes acciones para intentar solucionar los problemas
mencionados:
• Se verificó la configuración del plugin 'i18n' en el archivo mkdocs.yml y se ajustó
para que coincida con el formato recomendado.
• Se ejecutó el comando mkdocs build --clean para intentar construir el sitio web
estático después de verificar la configuración. Sin embargo, el mismo error persistió.
• Se investigó la versión de MkDocs y del plugin 'i18n' para asegurarse de que fueran
compatibles y se actualizaron a las últimas versiones disponibles.

A pesar de las acciones realizadas hasta ahora, los errores persisten y requieren una
revisión adicional.:
• Consultar la documentación oficial de MkDocs y del plugin 'i18n' en busca de
soluciones específicas para los errores encontrados.
 • Buscar ayuda en foros y comunidades en línea relacionadas con MkDocs y GitHub
para obtener asesoramiento de otros usuarios y desarrolladores.
• Considerar la creación de un nuevo proyecto MkDocs desde cero para verificar si
los errores persisten en un entorno nuevo y limpio.
• Registrar los errores específicos, incluyendo cualquier mensaje adicional o detalles
relacionados con la configuración, para facilitar la resolución de problemas.

Los problemas encontrados en la configuración de MkDocs con el plugin 'i18n' han impedido
la construcción exitosa del sitio web de documentación multilingüe. Se requiere una revisión
adicional y la búsqueda de soluciones específicas para cada error. Se recomienda consultar
recursos adicionales y buscar asesoramiento de la comunidad para resolver estos
problemas y avanzar en la creación del sitio web de documentación.
CONCLUSIONES

El objetivo de la actividad era experimentar con las funcionalidades de las herramientas de

control de versiones, específicamente Git, y crear una copia local de la documentación del
"OWASP Top 10 2021" desde el repositorio en GitHub. Sin embargo, se han enfrentado
desafíos y errores en el proceso de configuración y construcción del sitio web de
documentación multilingüe utilizando MkDocs con el plugin 'i18n'.

Conclusiones generales de este informe:

Éxito en la Configuración Inicial: La instalación de Git y la creación de una cuenta en GitHub

se llevaron a cabo con éxito. Se logró crear una copia local del repositorio del "OWASP Top
10 2021" siguiendo las instrucciones proporcionadas en el archivo README.md del
repositorio.

Desafíos con MkDocs e 'i18n': Se identificaron desafíos y errores significativos al intentar

configurar MkDocs con el plugin 'i18n' para crear un sitio web de documentación multilingüe.
El error más prominente estaba relacionado con la configuración del plugin 'i18n',
específicamente con la opción 'languages', que se esperaba que fuera una lista pero se
proporcionó como un diccionario.

Acciones Realizadas: Se tomaron medidas para abordar los errores, incluyendo la

verificación de la configuración, la actualización de las versiones de MkDocs y el plugin
'i18n', y la ejecución del comando mkdocs build --clean. Sin embargo, los errores
persistieron.

Próximos Pasos: Se sugieren próximos pasos para resolver los problemas, que incluyen
consultar la documentación oficial, buscar asesoramiento en la comunidad y considerar la
creación de un nuevo proyecto MkDocs desde cero.

Necesidad de Registro Detallado: Se destaca la importancia de registrar errores y mensajes

específicos, así como detalles adicionales relacionados con la configuración, para facilitar
la resolución de problemas y la colaboración con la comunidad.
En resumen, aunque se logró un progreso inicial al instalar Git, crear una cuenta en GitHub
y copiar el repositorio del "OWASP Top 10 2021", la configuración de MkDocs con el plugin
'i18n' presentó desafíos que requieren una revisión adicional. El proceso de aprendizaje y
solución de problemas es esencial en el desarrollo de habilidades en el control de versiones
y la gestión de la documentación.
BIBLIOGRAFIA

Chacon, S., & Straub, B. (2014). Pro Git. Apress. GitHub, Inc. (2023). Documentación de
GitHub. https://docs.github.com/

MkDocs y OWASP Top 10 2023. MkDocs. (2023). Documentación de MkDocs.

https://www.mkdocs.org/

OWASP. (2023). OWASP Top 10 2021.

https://github.com/OWASP/Top10/tree/master/2021
Python. (2023) Python Releases for Windows
https://www.python.org/downloads/windows/.