You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Web-Dev-For-Beginners/README.md

4.2 KiB

SDAW_6464

Sustituye XXXX por las 4 últimas cifras de tu NRE y STUDENT_NAME por tu nombre real en los ficheros.

Repositorio de práctica de control de versiones (Git + GitHub) y servidor Node.js mínimo.

Objetivos

  • Comprender un VCS distribuido y diferenciar trabajo local vs remoto.
  • Usar ramas para funcionalidades independientes.
  • Integrar mediante Pull Requests y resolver conflictos.
  • Documentar el proceso de desarrollo.

📁 Estructura del proyecto

/SDAW_6464
├── index.html
├── script.js
├── package.json
├── server.js
└── README.md

▶️ Cómo levantar el servidor en local

  1. Instala dependencias:
npm install
  1. Ejecuta el servidor:
npm start
# Abre http://localhost:3000

El botón en index.html mostrará: Hola STUDENT_NAME (edita script.js para poner tu nombre real).

🧩 Comandos Git y Node.js utilizados

Node.js

  • npm init -y inicialización (ya incluido).
  • npm install express dependencias.
  • npm start arrancar servidor.

Git

# 1) Inicialización y configuración local
git init
git config user.name "Tu Nombre"
git config user.email "tu-email@ejemplo.com"
git config --list

# 2) Primer commit
git add .
git commit -m "chore: initial commit (estructura base)"

# 3) Crear repo remoto y enlazar (reemplaza <usuario> y utiliza SSH o HTTPS)
git branch -M main
git remote add origin git@github.com:<usuario>/SDAW_XXXX.git
# o: git remote add origin https://github.com/<usuario>/SDAW_XXXX.git
git push -u origin main

# 4) Trabajo en ramas (ejemplo)
git checkout -b feat/estructura-proyecto
git add .
git commit -m "feat: añadir estructura base de app web"
git push -u origin feat/estructura-proyecto

# 5) Seguimiento y restauración
git status
git log --oneline --decorate --graph --all
git diff
git restore <fichero>               # deshacer cambios no indexados
git restore --staged <fichero>      # sacar del área de staging
git revert <hash>                   # crear commit que revierte otro

🌿 Ramas simultáneas (para la práctica)

Desde main crea dos ramas con los identificadores facilitados por el docente:

# Rama 1
git checkout main
git pull --rebase origin main
git checkout -b rama1_nombreApellido1Estudiante

# Rama 2
git checkout main
git pull --rebase origin main
git checkout -b rama2_nombreApellido1Estudiante

📄 Ediciones solicitadas del README

En rama 1, añade:

## Información técnica añadida desde rama 1
En esta sección se describen los principales comandos de Git utilizados durante la práctica:
- git init: (COMPLETAR)
- git add: (COMPLETAR)
- git commit: (COMPLETAR)
- git branch: (COMPLETAR)
- git merge: (COMPLETAR)
- git push: (COMPLETAR)

Luego:

git add README.md
git commit -m "docs(rama1): explicar comandos básicos de Git"
git push -u origin rama1_nombreApellido1Estudiante

En rama 2, pega el log de Git en una línea (formato adecuado):

git log --oneline > log_oneline.txt

Copia el contenido en el README bajo:

## Información técnica añadida desde rama 2
(COPIAR AQUÍ LA RESPUESTA POR EL COMANDO INDICADO EN EL PÁRRAFO ANTERIOR)

Y sube los cambios:

git add README.md log_oneline.txt
git commit -m "docs(rama2): añadir historial en una línea"
git push -u origin rama2_nombreApellido1Estudiante

🔀 Pull Requests (integración)

  1. En GitHub, abre un Pull Request para cada rama contra main (NO elimines las ramas).
  2. Si hay conflictos, resuélvelos manteniendo todo el contenido de todas las ramas.
  3. Realiza el merge (puedes usar Squash & merge para un historial más limpio).

Sincronización final

git fetch origin
git checkout main
git pull --rebase origin main
git branch -a         # verifica ramas locales y remotas
git log --oneline --decorate --graph --all

📝 Conclusiones personales (edita esta sección)

  • Qué aprendí sobre Git y PRs:
  • Dificultades y cómo las resolví:
  • Buenas prácticas que aplicaría en futuros proyectos:

🔧 Notas

  • Archivo .gitignore incluye node_modules/ y otros temporales.
  • Puedes usar https://readme.so/ para pulir este README (sube su contenido y agrega secciones).

© STUDENT_NAME