AIDE
De l'aide sans dépendance
Foundation est conçu pour être auto-assisté, et le modèle d'aide le reflète. Il n'y a pas de service de support Foundation, pas de compte à ouvrir et pas de formulaire de contact sur ce site — en inventer un laisserait croire à un service qui n'existe pas. Ce qui est réellement disponible figure ci-dessous.
- La documentation est livrée avec le code dans le dépôt public, donc elle ne peut pas s'éloigner de ce qu'elle décrit.
- Trois voies légitimes — votre propre travail, votre propre développeur ou agence, ou l'assistance optionnelle de Provelopment — sans vainqueur recommandé.
- Rien de ce qui est décrit ici n'est verrouillé, et rien sur cette page ne promet de délai de réponse.
Trois voies légitimes vers de l'aide
Ce sont les voies que les gens empruntent réellement, et elles se valent. Rien sur cette page n'en privilégie une : le site auquel vous aboutissez est le même quelle que soit celle que vous choisissez.
Vous aider vous-même
Le dépôt public est le principal canal d'aide pour Foundation. Sa documentation est écrite pour être suivie plutôt que survolée, et elle est versionnée à côté du code qu'elle décrit.
- README, le guide de personnalisation, le document d'architecture, le runbook de déploiement et les manuels détiennent chacun leur sujet.
- La porte de validation signale les problèmes de configuration au moment de la compilation en nommant le réglage, ce qui résout immédiatement la plupart des problèmes.
- Rien n'est retenu : il n'existe aucune offre payante qui débloque la documentation, le code ou une installation fonctionnelle.
Utiliser votre propre développeur ou agence
Parce que tout ce qu'un déploiement est censé modifier vit dans la configuration, le contenu et les ressources plutôt que dans le code de plateforme, un site Foundation peut être repris par tout développeur web compétent — y compris un qui n'a jamais vu Foundation.
- La transmission ne dépend pas de connaissance tacite : la frontière de propriété et l'architecture sont documentées, et les tests appliquent les frontières qu'elles décrivent.
- Il existe un chemin le plus court du froid au productif, et il fait deux documents de long.
- Rien dans l'exploitation, la modification ou le déploiement d'un site Foundation n'exige l'intervention de Provelopment.
Demander à Provelopment
Provelopment peut fournir une aide à la mise en œuvre, une assistance technique, un accompagnement et des services gérés aux organisations qui le souhaitent. Cette aide est distincte de la base et entièrement optionnelle.
- Foundation ne l'exige pas, et rien dans le logiciel n'en dépend.
- Elle s'organise séparément : ce site n'exploite ni canal de support ni canal commercial.
- Adopter Foundation, le déployer soi-même et ne jamais contacter Provelopment est un résultat pleinement réussi.
Aucune des trois n'est la voie recommandée. Faire appel à de l'aide — ou s'en passer — est une décision de service que vous pouvez prendre, ou inverser, à tout moment sans changer le logiciel.
Les documents qui détiennent les réponses
Les questions techniques sont traitées dans le dépôt, à côté du code que la réponse décrit. Chaque document ci-dessous fait autorité sur son sujet, et c'est pourquoi cette page ne les répète pas.
README
Ce qu'est le projet, comment démarrer, l'organisation du dépôt et les vraies commandes de validation.
CUSTOMIZING.md
Le guide de l'utilisateur en aval et la référence complète de configuration, y compris le tableau qui sépare ce qui est à vous de ce qui est à la plateforme.
ARCHITECTURE.md
Style architectural, frontières, sens des dépendances et motifs d'intégration.
DEPLOYMENT.md
Le runbook de lancement : premier déploiement, protection d'intégration continue, domaine personnalisé et vérifications après déploiement.
BRAND_ASSETS.md
Le contrat de remplacement des ressources de marque : chaque rôle graphique remplaçable, dans l'ordre où les remplacer.
instruction-manuals/
Les procédures : adoption, personnalisation, image de marque, contenu, validation, déploiement, mise à niveau et dépannage.
troubleshooting.md
Les pannes récurrentes et leurs résolutions sûres, y compris celles qui apparaissent après une mise à niveau.
Si ce site web et le dépôt divergent un jour, c'est le dépôt qui a raison. Cette page indique où regarder ; le dépôt fait le travail.
Quelle source répond à quelle question
La plupart des visiteurs arrivent avec l'une de quelques questions. Voici les destinations qui y répondent, et aucune n'exige un compte ni une conversation.
Qu'est-ce que Foundation, et que fournit-il ?
L'explication du projet sur son périmètre, ses frontières et le comportement de ses parties.
Comment est-ce assemblé techniquement ?
Les couches, le sens des dépendances et les frontières que les tests appliquent.
Comment adapter un site à mon activité ?
Identité, image de marque, contenu, dictionnaires et ressources, et quels fichiers sont à vous de modifier.
Comment le mettre en ligne ?
Le runbook de déploiement : le premier déploiement, le domaine personnalisé et les vérifications à effectuer ensuite.
À quoi ressemble un site Foundation achevé ?
Deux démonstrations en fonctionnement construites sur la même base, avec un contenu, une identité et une navigation différents.
Quelque chose ne va pas sur mon propre site.
La procédure de dépannage détient les problèmes qui se sont réellement répétés, chacun avec une résolution sûre et éprouvée ; la procédure de validation définit ce que signifie une vérification réussie.
Je préférerais que quelqu'un d'autre le mette en œuvre ou l'accompagne.
Le site propre de Provelopment décrit ce qu'il fournit. Cet arrangement se fait séparément du projet.
Cette page ne reproduit délibérément pas les manuels. Elle pointe vers eux, pour que chaque réponse conserve exactement une autorité.
Si vous êtes bloqué maintenant
La plupart des problèmes sur un site Foundation sont des problèmes de configuration, et la base est construite pour les signaler plutôt que les cacher. Parcourez cette liste avant de supposer qu'il y a un problème avec le projet.
1
Exécutez la porte de validation et lisez l'échec
Les problèmes de configuration sont signalés au moment de la compilation en nommant le réglage, ce qui résout immédiatement la plupart des problèmes. Le README nomme les commandes que le projet exécute lui-même.
2
Lisez la procédure de dépannage
Les manuels contiennent les pannes récurrentes et leurs résolutions sûres, y compris celles qui apparaissent après une mise à niveau amont.
3
Vérifiez ce qui a changé, si vous venez de mettre à niveau
La procédure de mise à niveau consigne ce qui se déplace entre versions de Foundation et quels fichiers appartiennent à l'adoptant, ce qui explique la plupart des problèmes qui apparaissent juste après une mise à niveau.
4
Demandez à la personne qui construit votre site
Si quelqu'un met en œuvre ou maintient le site pour vous, il a le déploiement sous les yeux et constitue le chemin le plus rapide vers une réponse.
Aucune étape ici ne dépend du fait de contacter Provelopment, et aucune n'a de délai de réponse associé.
Si vous voulez de l'aide, elle est disponible
Provelopment peut fournir une aide à la mise en œuvre, une assistance technique, un accompagnement et des services gérés aux organisations qui le souhaitent. Cette aide est distincte de la base et entièrement optionnelle.
- Elle s'organise séparément du projet : il n'y a rien sur ce site web à quoi s'inscrire.
- Rien dans le logiciel, la documentation ou les démonstrations en fonctionnement n'en dépend.
- Y recourir, ou décider de ne jamais y recourir, ne change rien à ce qu'est Foundation.
Foundation d'abord, selon ses propres termes ; l'assistance ensuite, si vous la voulez.
Ce que l'adoption d'un projet open source ne comprend pas
L'honnêteté d'un modèle d'aide compte autant que les voies qu'il contient, donc cette page énonce ses limites plutôt que de les laisser deviner.
- Ni service de support ni réponse garantie : rien de ce qui est décrit ici n'est assuré par du personnel, et ce site web n'accepte pas de demandes de support.
- Ni niveau de service, ni réponse aux incidents, ni obligation de disponibilité : vous exploitez votre propre déploiement, et le logiciel est fourni sans garantie.
- Ni contrat de maintenance : absorber les améliorations amont est une procédure documentée que vous ou votre développeur exécutez.
- Ni documentation verrouillée ni offre payante : chaque document décrit sur cette page est public, et le code est sous licence Apache-2.0.
- Ni obligation implicite pour Provelopment : l'assistance optionnelle est un accord de service distinct, et non un préalable au fonctionnement du logiciel.
Ce qui est disponible, c'est le travail du dépôt et — si vous le choisissez — un accord de service distinct. Rien d'autre n'est sous-entendu.
Commencez là où est votre question
Lisez le document qui détient votre question, regardez une démonstration en fonctionnement, ou prenez le parcours d'adoption quand vous serez prêt à construire.