Documentación
DOCUMENTACIÓN
La documentación de Foundation no es un folleto con un manual pegado detrás. Es el conocimiento operativo del software, publicado en el mismo repositorio que el código que describe: por eso no puede alejarse de lo que explica, y sigue estando disponible para usted pase lo que pase.
Todo lo que hay aquí es público
Puede leer la documentación completa antes de decidir si Foundation encaja en su proyecto, y puede seguirla usted mismo, a su ritmo, sin crear ninguna cuenta y sin preguntar a nadie. No hay nada restringido ni una versión reservada a quienes pagan.
Es deliberado. Una plataforma solo es verdaderamente reutilizable cuando el conocimiento necesario para adoptarla, configurarla, publicarla y mantenerla viaja junto con el software, en lugar de quedarse con quien lo escribió.
Si empieza de cero, el orden más útil es este: primero el README del repositorio, para entender qué ofrece Foundation y qué deja fuera a propósito; después, arrancar la base en local y recorrerla antes de leer especificaciones; a continuación, el manual de adopción para crear su propio proyecto. Después vienen la personalización del sitio y el branding, el manual de despliegue para publicar en su propio dominio y, más adelante, el de actualización cuando merezca la pena adoptar una versión más reciente.
Los manuales de funcionamiento
Cada manual es la referencia de su materia y está escrito para alguien que nunca ha visto Foundation.
- adoption.md — crear un proyecto Foundation nuevo
Cómo se establece un proyecto a partir de una versión inalterable de Foundation, de modo que la plataforma y el conocimiento operativo lleguen juntos.
- deployment.md — poner en producción un sitio ya validado
El procedimiento y las comprobaciones críticas antes de salir en vivo, incluido el trabajo de dominio y DNS que solo puede hacer el titular de la cuenta.
- foundation-upgrade.md — adoptar una versión más reciente
Cómo se adopta una versión nueva y cómo la separación entre archivos de la plataforma y del adoptante protege su configuración, sus contenidos, sus recursos y su marca.
- site-customization.md — adaptar su sitio
Qué debe editar, cómo añadir un idioma y dónde reside de verdad la identidad del sitio.
- branding-and-assets.md — marca y papeles gráficos
Qué papeles gráficos puede sustituir con su propio material y en qué orden se hace.
- content-management.md — mantener los contenidos
Cómo se guardan las páginas, la navegación y los textos como archivos, y cómo añadirlos o cambiarlos.
- validation.md — la barrera de validación
Qué se comprueba antes de aceptar una modificación y cómo ejecutar esas comprobaciones usted mismo.
- troubleshooting.md — acotar el problema
Los primeros pasos cuando algo no funciona: desde la salida del despliegue hasta páginas que no aparecen.
Por dónde empezar
El orden que menos tiempo desperdicia. Cada paso indica el documento que lo cubre.
Leer qué es Foundation
La README del repositorio: qué ofrece la plataforma, qué deja fuera a propósito y cómo se ve un sitio construido sobre ella.
Ejecutarlo en local antes de seguir leyendo
Una hora de práctica responde a más preguntas que un día de documentación.
Decidir cómo lo va a poseer
Un sitio o varios; sus propias cuentas o un acuerdo gestionado. Esta decisión pesa más que cualquier elección técnica.
Crear su propio proyecto
El manual de adopción: un proyecto a partir de una versión fija de Foundation, con la plataforma y el conocimiento operativo desde el primer día.
Hacer suyo el sitio
Personalización y marca: identidad, contenidos, idiomas y recursos, mediante configuración y archivos, sin reescribir la plataforma.
Publicar y mantener
El manual de despliegue para salir en vivo, el de actualización para adoptar versiones nuevas y el de validación para saber qué se comprueba.
No hace falta cuenta ni autorización
Los manuales suponen que trabaja en su propia copia del repositorio, con su propio alojamiento y su propio dominio. No hay nada que registrar ni a quién pedir permiso. Cuando un paso exige algo que usted no tiene —el acceso a los ajustes DNS de un dominio, por ejemplo— el manual lo advierte en ese mismo punto en lugar de dejarlo para después.