Saltar al contenido

AYUDA

Ayuda sin dependencia

Foundation está diseñado para ser autoasistido, y el modelo de ayuda lo refleja. No hay un servicio de soporte de Foundation, ni una cuenta que abrir, ni un formulario de contacto en este sitio: inventar uno implicaría un servicio que no existe. Lo que sí está disponible de verdad es lo siguiente.

  • La documentación se distribuye con el código en el repositorio público, así que no puede alejarse de lo que describe.
  • Tres vías legítimas —trabajo propio, su propio desarrollador o agencia, o la asistencia opcional de Provelopment— sin un ganador recomendado.
  • Nada de lo aquí descrito está restringido, y nada de esta página promete un tiempo de respuesta.

Tres vías legítimas para recibir ayuda

Estas son las vías que la gente realmente toma, y son igual de válidas. Nada de esta página privilegia una: el sitio con el que termina es el mismo elija la que elija.

  • Ayudarse usted mismo

    El repositorio público es el canal principal de ayuda para Foundation. Su documentación está escrita para seguirse y no para hojearse, y se versiona junto al código que describe.

    • README, la guía de personalización, el documento de arquitectura, el runbook de despliegue y los manuales poseen cada uno su materia.
    • La puerta de validación informa de los problemas de configuración en tiempo de compilación nombrando el ajuste, lo que resuelve la mayoría de los problemas de inmediato.
    • Nada se retiene: no hay un nivel de pago que desbloquee documentación, código o una instalación funcional.

    Manuales

  • Usar su propio desarrollador o agencia

    Como todo lo que se espera que cambie un despliegue vive en configuración, contenido y recursos y no en código de plataforma, un sitio Foundation lo puede asumir cualquier desarrollador web competente, incluso uno que nunca haya visto Foundation.

    • La entrega no depende de conocimiento acumulado: la frontera de propiedad y la arquitectura están documentadas, y las pruebas aplican las fronteras que describen.
    • Existe un camino más corto de cero a productivo, y tiene dos documentos de largo.
    • Nada de ejecutar, cambiar o desplegar un sitio Foundation exige la intervención de Provelopment.

    La guía de personalización

  • Preguntar a Provelopment

    Provelopment puede ofrecer ayuda de implementación, asistencia técnica, soporte y servicios gestionados a las organizaciones que los quieran. Esa ayuda es independiente de la base y totalmente opcional.

    • Foundation no la exige, y nada del software depende de ella.
    • Se acuerda por separado: este sitio no opera un canal de soporte ni de ventas.
    • Adoptar Foundation, desplegarlo usted mismo y no contactar nunca con Provelopment es un resultado completamente exitoso.

    Provelopment

Ninguna de las tres es la vía recomendada. Incorporar ayuda —o prescindir de ella— es una decisión de servicio que puede tomar o revertir en cualquier momento sin cambiar el software.

Los documentos que poseen las respuestas

Las preguntas técnicas se responden en el repositorio, junto al código que la respuesta describe. Cada documento de abajo es autorizado en su materia, y por eso esta página no los repite.

  • README

    Qué es el proyecto, cómo empezar, la estructura del repositorio y los comandos reales de validación.

  • CUSTOMIZING.md

    La guía para el usuario posterior y la referencia completa de configuración, incluida la tabla que separa lo que es suyo de lo que es de la plataforma.

  • ARCHITECTURE.md

    Estilo arquitectónico, fronteras, dirección de dependencias y patrones de integración.

  • DEPLOYMENT.md

    El runbook de lanzamiento: primer despliegue, protección de integración continua, dominio propio y las comprobaciones posteriores.

  • BRAND_ASSETS.md

    El contrato de sustitución de recursos de marca: cada rol gráfico reemplazable, en el orden en que sustituirlos.

  • instruction-manuals/

    Los procedimientos: adopción, personalización, marca, contenido, validación, despliegue, actualización y resolución de problemas.

  • troubleshooting.md

    Los fallos recurrentes y sus resoluciones seguras, incluidos los que aparecen después de una actualización.

Si este sitio web y el repositorio alguna vez no coinciden, el repositorio es el correcto. Esta página explica dónde mirar; el repositorio hace el trabajo.

Qué fuente responde a qué pregunta

La mayoría de los visitantes llega con una de unas pocas preguntas. Estos son los destinos que las responden, y ninguno exige una cuenta ni una conversación.

  • ¿Qué es Foundation y qué ofrece?

    La explicación propia del proyecto sobre su alcance, sus fronteras y cómo se comportan las piezas.

    Capacidades

  • ¿Cómo está construido técnicamente?

    Las capas, la dirección de dependencias y las fronteras que las pruebas aplican.

    Arquitectura

  • ¿Cómo adapto un sitio a mi propio negocio?

    Identidad, marca, contenido, diccionarios y recursos, y qué archivos son suyos para cambiar.

    Personalización del sitio

  • ¿Cómo lo pongo en marcha?

    El runbook de despliegue: el primer despliegue, el dominio propio y las comprobaciones posteriores.

    Despliegue

  • ¿Cómo es un sitio Foundation terminado?

    Dos demostraciones en funcionamiento construidas sobre la misma base, con contenido, identidad y navegación diferentes.

    Demos

  • Algo va mal en mi propio sitio.

    El procedimiento de resolución de problemas posee los problemas que realmente se han repetido, cada uno con una solución segura y probada; el procedimiento de validación define qué significa una comprobación superada.

    Procedimiento de resolución de problemas

  • Preferiría que otra persona lo implementara o lo mantuviera.

    El sitio propio de Provelopment describe lo que ofrece. Ese acuerdo se hace por separado del proyecto.

    Provelopment

Esta página deliberadamente no reproduce los manuales. Apunta a ellos, para que cada respuesta conserve exactamente una autoridad.

Si está atascado ahora mismo

La mayoría de los problemas con un sitio Foundation son problemas de configuración, y la base está construida para informarlos y no para ocultarlos. Recorra esta lista antes de suponer que algo va mal en el proyecto.

  1. 1

    Ejecute la puerta de validación y lea el fallo

    Los problemas de configuración se informan en tiempo de compilación nombrando el ajuste, lo que resuelve la mayoría de los problemas de inmediato. El README nombra los comandos que el propio proyecto ejecuta.

  2. 2

    Lea el procedimiento de resolución de problemas

    Los manuales incluyen los fallos recurrentes y sus resoluciones seguras, incluidos los que aparecen después de una actualización anterior.

  3. 3

    Compruebe qué cambió, si acaba de actualizar

    El procedimiento de actualización registra qué se mueve entre versiones de Foundation y qué archivos son del adoptante, lo que explica la mayoría de los problemas que aparecen justo después de una actualización.

  4. 4

    Pregunte a quien construye su sitio

    Si alguien implementa o mantiene el sitio para usted, tiene el despliegue delante y es la vía más rápida a una respuesta.

Ningún paso de aquí depende de contactar con Provelopment, y ningún paso lleva asociado un tiempo de respuesta.

Si quiere ayuda, está disponible

Provelopment puede ofrecer ayuda de implementación, asistencia técnica, soporte y servicios gestionados a las organizaciones que los quieran. Esa ayuda es independiente de la base y totalmente opcional.

  • Se acuerda por separado del proyecto: no hay nada en este sitio web a lo que registrarse.
  • Nada del software, la documentación o las demostraciones en funcionamiento depende de ella.
  • Usarla, o decidir no usarla nunca, no cambia nada de lo que Foundation es.

Provelopment

Primero Foundation, en sus propios términos; después la asistencia, si la quiere.

Qué no incluye adoptar código abierto

La honestidad de un modelo de ayuda importa tanto como las vías que contiene, así que esta página declara sus límites en lugar de dejarlos a la interpretación.

  • Ni servicio de soporte ni respuesta garantizada: nada de lo aquí descrito está atendido, y este sitio web no acepta solicitudes de soporte.
  • Ni nivel de servicio, ni respuesta a incidentes, ni obligación de disponibilidad: usted ejecuta su propio despliegue, y el software se proporciona sin garantía.
  • Ni contrato de mantenimiento: absorber las mejoras anteriores es un procedimiento documentado que ejecutan usted o su desarrollador.
  • Ni documentación restringida ni nivel de pago: cada documento descrito en esta página es público, y el código está licenciado bajo Apache-2.0.
  • Ni obligación implícita para Provelopment: la asistencia opcional es un acuerdo de servicio aparte, no un requisito previo para que el software funcione.

Lo que está disponible es el trabajo del repositorio y, si lo elige, un acuerdo de servicio aparte. No se insinúa nada más.

Empiece donde está su pregunta

Lea el documento que posee su pregunta, mire una demostración en funcionamiento o tome la ruta de adopción cuando esté listo para construir.