..
   Copyright (c) 2025 Allan Avendaño Sudario
   Licensed under Creative Commons Attribution-ShareAlike 4.0 International License
   SPDX-License-Identifier: CC-BY-SA-4.0

=====================
Guía 01: Git + GitHub
=====================

.. topic:: Objetivo específico
    :class: objetivo

    Desarrollar un repositorio personal en GitHub, que refleje la identidad digital del desarrollador, facilitando la presentación de sus habilidades y proyectos de manera clara y accesible.

Actividades en clases
=====================

Repositorio Personal
--------------------

1. Ingrese a su cuenta de :term:`GitHub`, en `https://github.com <https://github.com>`_.
2. Verifique si tiene, o no, un repositorio personal: 
    
   a) En la esquina superior derecha, haga clic en su foto de perfil y seleccione **Your repositories** (Sus repositorios). 
   b) Revise la lista de repositorios. Si encuentra un repositorio con el mismo nombre que su usuario de GitHub, ya tiene un repositorio personal.

   .. hint::
    
        Si no tiene un repositorio personal, siga las instrucciones de :term:`Bard` con la guía para :download:`crear repositorio personal <./pdfs/guia01-repositoriopersonal.pdf>` con Github.

3. :material-round:`note_alt;1.5em;sd-text-success` Revise la `Documentación de repositorios en GitHub <https://docs.github.com/es/repositories>`_ para con las actividades más comunes de los repositorios de proyectos en GitHub.

Contenido del repositorio
-------------------------

1. Utilice :term:`ChatGPT` para obtener sugerencias del diseño, de la estructura y del contenido de tu repositorio personal, p.e.: títulos de cada sección, tus proyectos, los enlaces a cada proyecto, las tecnologías que has utilizado, el estado de tus proyectos, correo institucional, capturas de pantalla de tus proyectos, etc. 
   
   .. attention::

        Omite datos sensibles, como: foto, números de contacto, correo personal, dirección, etc.

2. :material-round:`note_alt;1.5em;sd-text-success` Utilice la documentación del `Markdown Cheat Sheet <https://www.markdownguide.org/cheat-sheet/>`_, o un cliente de IAG, para generar las etiquetas de :term:`Markdown` que modifiquen el archivo *README.md* con la información de su repositorio personal.

GitHub Pages
------------

.. include:: ../tutoriales/github-pages.rst

Conclusiones
============

.. topic:: Preguntas de cierre

    * ¿De qué manera el uso de inteligencia artificial generativa para escribir o revisar documentos en Markdown puede enriquecer tu comprensión sobre la documentación técnica en el desarrollo de software, y en qué casos podría limitar tu aprendizaje?

    * Al generar documentación técnica con IA en formato Markdown, ¿cómo puedes asegurar la calidad, coherencia y autenticidad del contenido producido para que sea útil en un proyecto colaborativo de desarrollo?
    
    * ¿Qué actitudes y principios éticos deberían guiar el uso de IA generativa en la creación de documentación técnica, para mantener tu integridad como desarrollador y el respeto hacia el trabajo en equipo?


Actividades autónomas
=====================

Recursos extras
------------------------------

En redes:

.. raw:: html

    <blockquote class="twitter-tweet"><p lang="en" dir="ltr">Almost every software engineer has used Git before, but only a handful know how it works.<br><br>To begin with, it&#39;s essential to identify where our code is stored. The common assumption is that there are only two locations - one on a remote server like Github and the other on our… <a href="https://t.co/edXjF0fulA">pic.twitter.com/edXjF0fulA</a></p>&mdash; Alex Xu (@alexxubyte) <a href="https://twitter.com/alexxubyte/status/1708145139515109449?ref_src=twsrc%5Etfw">September 30, 2023</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

.. raw:: html

   <blockquote class="twitter-tweet"><p lang="en" dir="ltr">Publishing with GitHub Pages is now even simpler. Just three steps and you&#39;ve got yourself a website. <a href="https://t.co/hEwuD3aSoE">https://t.co/hEwuD3aSoE</a></p>&mdash; GitHub (@github) <a href="https://twitter.com/github/status/807389330528288768?ref_src=twsrc%5Etfw">December 10, 2016</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>