BANTUAN
Bantuan tanpa keterikatan
Foundation dirancang untuk dibantu sendiri, dan model bantuannya mencerminkan itu. Tidak ada meja bantuan Foundation, tidak ada akun yang perlu dibuka, dan tidak ada formulir kontak di situs ini — mengarangnya akan menyiratkan layanan yang tidak ada. Yang benar-benar tersedia ada di bawah.
- Dokumentasinya disertakan bersama kodenya di repositori publik, sehingga tidak dapat menyimpang dari apa yang dijelaskannya.
- Tiga jalur yang sah — pekerjaan Anda sendiri, pengembang atau agensi Anda sendiri, atau bantuan opsional Provelopment — tanpa pemenang yang dianjurkan.
- Tidak ada yang dijelaskan di sini yang dikunci, dan tidak ada di halaman ini yang menjanjikan waktu tanggapan.
Tiga jalur sah menuju bantuan
Inilah jalur yang benar-benar diambil orang, dan semuanya sama validnya. Tidak ada di halaman ini yang mengistimewakan salah satunya: situs yang Anda hasilkan tetap sama apa pun pilihan Anda.
Bantu diri Anda sendiri
Repositori publik adalah kanal bantuan utama untuk Foundation. Dokumentasinya ditulis untuk diikuti, bukan untuk dibaca sekilas, dan diberi versi di samping kode yang dijelaskannya.
- README, panduan penyesuaian, dokumen arsitektur, runbook penerapan, dan panduan masing-masing memegang subjeknya.
- Gerbang validasi melaporkan masalah konfigurasi saat build sambil menyebutkan pengaturannya, yang menyelesaikan sebagian besar masalah dengan segera.
- Tidak ada yang ditahan: tidak ada level berbayar yang membuka dokumentasi, kode, atau instalasi yang bekerja.
Pakai pengembang atau agensi Anda
Karena semua yang diharapkan diubah suatu penerapan berada di konfigurasi, konten, dan aset alih-alih di kode platform, situs Foundation dapat diambil alih oleh pengembang web mana pun yang kompeten — termasuk yang belum pernah melihat Foundation.
- Penyerahannya tidak bergantung pada pengetahuan yang hanya dikuasai segelintir orang: batas kepemilikan dan arsitekturnya terdokumentasi, dan pengujian menegakkan batas yang dijelaskannya.
- Ada jalur terpendek dari dingin menjadi produktif, dan panjangnya dua dokumen.
- Tidak ada bagian dari menjalankan, mengubah, atau menerapkan situs Foundation yang menuntut keterlibatan Provelopment.
Tanyakan kepada Provelopment
Provelopment dapat menyediakan bantuan penerapan, pendampingan teknis, dukungan, dan layanan terkelola bagi organisasi yang menginginkannya. Bantuan itu terpisah dari basisnya dan sepenuhnya opsional.
- Foundation tidak menuntutnya, dan tidak ada di perangkat lunaknya yang bergantung padanya.
- Bantuan diatur terpisah: situs ini tidak menjalankan kanal dukungan atau kanal penjualan.
- Mengadopsi Foundation, menerapkannya sendiri, dan tidak pernah menghubungi Provelopment adalah hasil yang sepenuhnya berhasil.
Tidak ada dari ketiganya yang merupakan jalur yang dianjurkan. Meminta bantuan — atau tidak memintanya — adalah keputusan layanan yang dapat Anda ambil atau balik kapan saja tanpa mengubah perangkat lunaknya.
Dokumen yang memegang jawabannya
Pertanyaan teknis dijawab di repositori, di samping kode yang dijelaskan jawabannya. Setiap dokumen di bawah berwenang untuk subjeknya, dan itulah sebabnya halaman ini tidak mengulangnya.
README
Apa proyek ini, cara memulai, susunan repositori, dan perintah validasi yang sebenarnya.
CUSTOMIZING.md
Panduan pengguna hilir dan referensi konfigurasi lengkap, termasuk tabel yang memisahkan milik Anda dari milik platform.
ARCHITECTURE.md
Gaya arsitektur, batas, arah dependensi, dan pola integrasi.
DEPLOYMENT.md
Runbook peluncuran: penerapan pertama, pengamanan integrasi berkelanjutan, domain khusus, dan pemeriksaan setelah penerapan.
BRAND_ASSETS.md
Kontrak penukaran aset merek: setiap peran grafis yang dapat digantikan, dalam urutan penggantiannya.
instruction-manuals/
Prosedurnya: adopsi, penyesuaian, merek, konten, validasi, penerapan, peningkatan, dan penanganan masalah.
troubleshooting.md
Kegagalan yang berulang dan penyelesaian amannya, termasuk yang muncul setelah peningkatan versi.
Jika situs web ini dan repositori suatu saat berbeda, repositori yang benar. Halaman ini menjelaskan ke mana harus melihat; repositori yang mengerjakannya.
Sumber mana menjawab pertanyaan mana
Sebagian besar pengunjung datang dengan satu di antara sedikit pertanyaan. Inilah tujuan yang menjawabnya, dan tidak ada yang menuntut akun atau percakapan.
Apa itu Foundation, dan apa yang disediakannya?
Penjelasan proyek sendiri tentang cakupan, batasnya, dan bagaimana bagian-bagiannya berperilaku.
Bagaimana susunannya secara teknis?
Lapisan, arah dependensi, dan batas yang ditegakkan pengujian.
Bagaimana saya menyesuaikan situs untuk bisnis saya?
Identitas, merek, konten, kamus, dan aset — serta berkas mana yang milik Anda untuk diubah.
Bagaimana cara membuatnya daring?
Runbook penerapan: penerapan pertama, domain khusus, dan pemeriksaan yang harus dijalankan setelahnya.
Seperti apa situs Foundation yang sudah selesai?
Dua demonstrasi yang berjalan, dibangun dari basis yang sama, dengan konten, identitas, dan navigasi berbeda.
Ada yang salah pada situs saya sendiri.
Prosedur penanganan masalah memegang masalah yang benar-benar berulang, masing-masing dengan penyelesaian aman yang terbukti; prosedur validasi menentukan arti pemeriksaan yang lulus.
Saya lebih suka orang lain yang menerapkan atau mendukungnya.
Situs Provelopment sendiri menjelaskan apa yang disediakannya. Pengaturan itu dilakukan terpisah dari proyeknya.
Halaman ini sengaja tidak menyalin panduannya. Ia menunjuk ke sana, sehingga setiap jawaban mempertahankan tepat satu otoritas.
Jika Anda sedang terhambat sekarang
Sebagian besar masalah pada situs Foundation adalah masalah konfigurasi, dan basisnya dibangun untuk melaporkannya alih-alih menyembunyikannya. Telusuri daftar ini sebelum menganggap ada yang salah dengan proyeknya.
1
Jalankan gerbang validasi dan baca kegagalannya
Masalah konfigurasi dilaporkan saat build sambil menyebutkan pengaturannya, yang menyelesaikan sebagian besar masalah dengan segera. README menyebutkan perintah yang dijalankan proyek itu sendiri.
2
Baca prosedur penanganan masalah
Panduannya mencakup kegagalan yang berulang dan penyelesaian amannya, termasuk yang muncul setelah peningkatan versi dari hulu.
3
Periksa apa yang berubah, jika Anda baru meningkatkan versi
Prosedur peningkatan mencatat apa yang berpindah antar versi Foundation dan berkas mana yang milik adopter, yang menjelaskan sebagian besar masalah yang muncul tepat setelah peningkatan.
4
Tanyakan kepada yang membangun situs Anda
Jika seseorang menerapkan atau memelihara situsnya untuk Anda, orang itu memiliki penerapannya di depan mata dan merupakan jalur tercepat menuju jawaban.
Tidak ada langkah di sini yang bergantung pada menghubungi Provelopment, dan tidak ada langkah yang disertai waktu tanggapan.
Jika Anda ingin bantuan, ia tersedia
Provelopment dapat menyediakan bantuan penerapan, pendampingan teknis, dukungan, dan layanan terkelola bagi organisasi yang menginginkannya. Bantuan itu terpisah dari basisnya dan sepenuhnya opsional.
- Ia diatur terpisah dari proyeknya: tidak ada apa pun di situs web ini yang bisa Anda ikuti pendaftarannya.
- Tidak ada bagian dari perangkat lunak, dokumentasi, atau demonstrasi yang berjalan yang bergantung padanya.
- Memakainya, atau memutuskan untuk tidak pernah memakainya, tidak mengubah apa pun tentang apa itu Foundation.
Foundation lebih dahulu, dengan ketentuannya sendiri; bantuan setelahnya, jika Anda mau.
Apa yang tidak termasuk dalam adopsi sumber terbuka
Kejujuran model bantuan sama pentingnya dengan jalur di dalamnya, jadi halaman ini menyatakan batasnya alih-alih membiarkannya disimpulkan.
- Tanpa meja dukungan dan tanpa tanggapan yang dijamin: tidak ada yang dijelaskan di sini yang dijaga petugas, dan situs web ini tidak menerima permintaan dukungan.
- Tanpa tingkat layanan, tanggapan insiden, atau kewajiban ketersediaan: Anda menjalankan penerapan Anda sendiri, dan perangkat lunaknya diberikan tanpa jaminan.
- Tanpa kontrak pemeliharaan: menyerap perbaikan dari hulu adalah prosedur terdokumentasi yang Anda atau pengembang Anda jalankan.
- Tanpa dokumentasi terkunci dan tanpa level berbayar: setiap dokumen yang dijelaskan di halaman ini publik, dan kodenya berlisensi Apache-2.0.
- Tanpa kewajiban tersirat bagi Provelopment: bantuan opsional adalah pengaturan layanan terpisah, bukan prasyarat agar perangkat lunaknya bekerja.
Yang tersedia adalah pekerjaan di repositori dan — jika Anda memilihnya — pengaturan layanan terpisah. Tidak ada yang lain yang disiratkan.
Mulailah dari tempat pertanyaan Anda
Baca dokumen yang memegang pertanyaan Anda, lihat demonstrasi yang berjalan, atau ambil jalur adopsinya saat Anda siap membangun.