HILFE
Hilfe ohne Bindung
Foundation ist auf Selbsthilfe ausgelegt, und das Hilfemodell spiegelt das. Es gibt keinen Foundation-Support-Schalter, kein Konto zum Eröffnen und kein Kontaktformular auf dieser Website — eines zu erfinden würde eine Dienstleistung andeuten, die nicht existiert. Was wirklich verfügbar ist, steht unten.
- Die Dokumentation wird mit dem Code im öffentlichen Repository ausgeliefert, sodass sie nicht von dem abweichen kann, was sie beschreibt.
- Drei legitime Wege — eigene Arbeit, eigene Entwicklerin oder Agentur oder optionale Unterstützung durch Provelopment — ohne empfohlenen Sieger.
- Nichts hier Beschriebenes ist gesperrt, und nichts auf dieser Seite verspricht eine Antwortzeit.
Drei legitime Wege zur Hilfe
Das sind die Wege, die Menschen tatsächlich gehen, und sie sind gleichwertig. Nichts auf dieser Seite bevorzugt einen davon: Die Website, die am Ende dabei herauskommt, ist dieselbe, welchen Sie auch wählen.
Selbst helfen
Das öffentliche Repository ist der primäre Hilfekanal für Foundation. Seine Dokumentation ist zum Befolgen geschrieben, nicht zum Überfliegen, und wird neben dem Code versioniert, den sie beschreibt.
- README, der Anpassungsleitfaden, das Architektur-Dokument, das Deployment-Runbook und die Handbücher besitzen jeweils ihr Thema.
- Das Validierungs-Gate meldet Konfigurationsprobleme zur Build-Zeit und benennt die Einstellung, was die meisten Probleme sofort löst.
- Nichts wird zurückgehalten: Es gibt keine bezahlte Stufe, die Dokumentation, Code oder eine funktionierende Installation freischaltet.
Ihre eigene Entwicklerin oder Agentur nutzen
Weil alles, was ein Deployment ändern soll, in Konfiguration, Inhalten und Assets statt in Plattformcode liegt, kann jede versierte Webentwicklerin eine Foundation-Website übernehmen — auch eine, die Foundation noch nie gesehen hat.
- Die Übergabe hängt nicht von angesammeltem Insider-Wissen ab: die Eigentumsgrenze und die Architektur sind dokumentiert, und die Tests setzen die Grenzen durch, die sie beschreiben.
- Es gibt einen kürzesten Weg vom Kalten zum Produktiven, und er ist zwei Dokumente lang.
- Nichts am Betreiben, Ändern oder Bereitstellen einer Foundation-Website erfordert die Beteiligung von Provelopment.
Provelopment fragen
Provelopment kann Umsetzungshilfe, technische Unterstützung, Betreuung und verwaltete Dienste für Organisationen anbieten, die sie möchten. Diese Hilfe ist von der Grundlage getrennt und vollständig optional.
- Foundation verlangt sie nicht, und nichts in der Software hängt von ihr ab.
- Sie wird separat vereinbart: Diese Website betreibt keinen Support- oder Vertriebskanal.
- Foundation zu übernehmen, selbst bereitzustellen und Provelopment nie zu kontaktieren, ist ein vollständig erfolgreiches Ergebnis.
Keiner der drei ist der empfohlene Weg. Hilfe hinzuzuziehen — oder darauf zu verzichten — ist eine Diensteentscheidung, die Sie jederzeit treffen oder umkehren können, ohne die Software zu ändern.
Die Dokumente, die die Antworten besitzen
Technische Fragen werden im Repository beantwortet, neben dem Code, den die Antwort beschreibt. Jedes Dokument unten ist für sein Thema maßgeblich — deshalb wiederholt diese Seite sie nicht.
README
Was das Projekt ist, wie man startet, der Aufbau des Repositorys und die echten Validierungsbefehle.
CUSTOMIZING.md
Der Leitfaden für Anwender und die vollständige Konfigurationsreferenz, einschließlich der Tabelle, die trennt, was Ihnen gehört und was der Plattform.
ARCHITECTURE.md
Architekturstil, Grenzen, Abhängigkeitsrichtung und Integrationsmuster.
DEPLOYMENT.md
Das Start-Runbook: erstes Deployment, Continuous-Integration-Absicherung, eigene Domain und die Prüfungen nach dem Deployment.
BRAND_ASSETS.md
Der Vertrag zum Austausch von Marken-Assets: jede austauschbare Grafikrolle, in der Reihenfolge des Ersetzens.
instruction-manuals/
Die Verfahren: Adoption, Anpassung, Branding, Inhalte, Validierung, Deployment, Upgrade und Fehlerbehebung.
troubleshooting.md
Die wiederkehrenden Fehler und ihre sicheren Lösungen, einschließlich derer, die nach einem Upgrade auftreten.
Falls diese Website und das Repository je nicht übereinstimmen, hat das Repository recht. Diese Seite erklärt, wo Sie nachsehen; das Repository führt die Arbeit aus.
Welche Quelle welche Frage beantwortet
Die meisten Besucher kommen mit einer von wenigen Fragen. Das sind die Ziele, die sie beantworten, und keines davon erfordert ein Konto oder ein Gespräch.
Was ist Foundation und was bietet es?
Die eigene Erklärung des Projekts zu seinem Umfang, seinen Grenzen und dem Verhalten der Teile.
Wie ist es technisch aufgebaut?
Die Schichten, die Abhängigkeitsrichtung und die Grenzen, die die Tests durchsetzen.
Wie passe ich eine Website an mein eigenes Unternehmen an?
Identität, Branding, Inhalte, Wörterbücher und Assets — und welche Dateien Sie ändern.
Wie bekomme ich es live?
Das Deployment-Runbook: das erste Deployment, die eigene Domain und die danach auszuführenden Prüfungen.
Wie sieht eine fertige Foundation-Website aus?
Zwei laufende Demonstrationen, auf derselben Grundlage gebaut, mit unterschiedlichen Inhalten, Identität und Navigation.
An meiner eigenen Website stimmt etwas nicht.
Das Verfahren zur Fehlerbehebung besitzt die Probleme, die tatsächlich wiederkehren, jeweils mit einer sicheren, bewährten Lösung; das Validierungsverfahren definiert, was eine bestandene Prüfung bedeutet.
Ich möchte lieber, dass jemand anderes es umsetzt oder betreut.
Die eigene Website von Provelopment beschreibt, was es anbietet. Diese Vereinbarung wird getrennt vom Projekt getroffen.
Diese Seite gibt die Handbücher bewusst nicht wieder. Sie verweist darauf, damit jede Antwort genau eine Autorität behält.
Wenn Sie gerade feststecken
Die meisten Probleme mit einer Foundation-Website sind Konfigurationsprobleme, und die Grundlage ist darauf ausgelegt, sie zu melden statt zu verbergen. Arbeiten Sie diese Liste durch, bevor Sie annehmen, dass etwas mit dem Projekt nicht stimmt.
1
Validierungs-Gate ausführen und den Fehler lesen
Konfigurationsprobleme werden zur Build-Zeit gemeldet und benennen die Einstellung, was die meisten Probleme sofort löst. Das README nennt die Befehle, die das Projekt selbst ausführt.
2
Das Verfahren zur Fehlerbehebung lesen
Die Handbücher enthalten die wiederkehrenden Fehler und ihre sicheren Lösungen, einschließlich derer, die nach einem Upgrade aus dem Upstream auftreten.
3
Prüfen, was sich geändert hat, falls Sie gerade aktualisiert haben
Das Upgrade-Verfahren hält fest, was zwischen Foundation-Versionen wandert und welche Dateien dem Adopter gehören — das erklärt die meisten Probleme, die unmittelbar nach einem Upgrade auftreten.
4
Die Person fragen, die Ihre Website baut
Wenn jemand die Website für Sie umsetzt oder pflegt, hat diese Person das Deployment vor sich und ist der schnellste Weg zu einer Antwort.
Kein Schritt hier hängt davon ab, Provelopment zu kontaktieren, und an keinen Schritt ist eine Antwortzeit geknüpft.
Wenn Sie Hilfe möchten, ist sie verfügbar
Provelopment kann Umsetzungshilfe, technische Unterstützung, Betreuung und verwaltete Dienste für Organisationen anbieten, die sie möchten. Diese Hilfe ist von der Grundlage getrennt und vollständig optional.
- Sie wird getrennt vom Projekt vereinbart: Es gibt nichts auf dieser Website, wofür man sich anmelden könnte.
- Nichts in der Software, in der Dokumentation oder in den laufenden Demonstrationen hängt davon ab.
- Sie zu nutzen — oder sich endgültig dagegen zu entscheiden — ändert nichts daran, was Foundation ist.
Zuerst Foundation, zu ihren eigenen Bedingungen; Hilfe danach, wenn Sie sie möchten.
Was die Adoption von Open Source nicht enthält
Die Ehrlichkeit eines Hilfemodells ist genauso wichtig wie die Wege darin, deshalb benennt diese Seite ihre Grenzen, statt sie erraten zu lassen.
- Kein Support-Schalter und keine garantierte Antwort: Nichts hier Beschriebenes ist besetzt, und diese Website nimmt keine Support-Anfragen entgegen.
- Kein Service-Level, keine Incident-Reaktion und keine Verfügbarkeitspflicht: Sie betreiben Ihr eigenes Deployment, und die Software wird ohne Gewährleistung bereitgestellt.
- Kein Wartungsvertrag: Verbesserungen aus dem Upstream zu übernehmen, ist ein dokumentiertes Verfahren, das Sie oder Ihre Entwicklerin ausführen.
- Keine gesperrte Dokumentation und keine bezahlte Stufe: Jedes auf dieser Seite beschriebene Dokument ist öffentlich, und der Code ist unter Apache-2.0 lizenziert.
- Keine implizite Verpflichtung für Provelopment: Optionale Hilfe ist eine getrennte Dienstvereinbarung, keine Voraussetzung dafür, dass die Software funktioniert.
Verfügbar ist die Arbeit im Repository — und, wenn Sie es wählen, eine getrennte Dienstvereinbarung. Nichts anderes wird angedeutet.
Starten Sie dort, wo Ihre Frage ist
Lesen Sie das Dokument, das Ihre Frage besitzt, sehen Sie sich eine laufende Demonstration an, oder nehmen Sie den Adoptionsweg, wenn Sie bereit zum Bauen sind.