Pilih pertanyaan yang dapat dijelajahi lewat arsip
Rancangan terperinci ini bersifat hipotetis. Seorang pendaki telah memilih rute dan menyiapkan ponsel untuk dipakai jauh dari koneksi yang dapat diandalkan. Ia ingin membaca pembahasan orang tentang peta offline: apa yang perlu diunduh lebih dulu, asumsi perangkat mana yang perlu diperiksa, dan pertanyaan untuk perangkat lunak pilihannya. Arsip menjadi sumber diskusi historis, bukan penyedia peta.
Tempatkan fitur membaca di samping catatan persiapan, bukan dalam panduan arah belokan demi belokan. Sebuah hasil tidak boleh dianggap sebagai kondisi jalur terverifikasi hanya karena berada di dekat rute. Unduhan peta, izin lokasi, penutupan jalur terkini, dan informasi keselamatan tetap berada pada bagian aplikasi yang tepat. Pembagian ini memberi pengalaman historis peran yang berguna tanpa otoritas yang tidak dimilikinya.
Kirim satu permintaan kecil yang disengaja
Mulailah dengan kueri contoh offline maps dan subreddit hiking. Klien mengirim pilihan tersebut ke backend Anda; backend dapat memanggil /v1/search?q=offline%20maps&subreddit=hiking&limit=3&page=1 memakai kunci layanan tersimpan. Ini adalah rancangan permintaan, bukan bukti adanya tiga rekaman yang cocok. Kunci tetap di backend dan bukan bagian dari masukan pendaki.
Halaman awal yang kecil memungkinkan Anda merancang tugas membaca sebelum membuat umpan besar. q memakai pencocokan AND pada title dan text, sehingga frasa itu bukan instruksi pencarian frasa persis atau semantik. Jika pendaki mengubahnya, jelaskan pencarian baru dan mulai ulang urutan halaman. Jangan memperluas kueri diam-diam lalu memberi label seolah hasil baru berasal dari pertanyaan semula.
Jadikan rekaman sebuah referensi, bukan rekomendasi
Arsip mengembalikan rekaman datar. Kartu dapat menampilkan teks yang tersedia, komunitas sumber, tanggal pembuatan yang valid, serta tautan sumber yang dapat digunakan. Komentar mungkin tidak memiliki judul atau konteks yang berguna. Nyatakan bahwa judul atau tanggal tidak tersedia alih-alih mengarangnya. Pengelompokan lokal memakai pengenal induk yang ada dapat menghubungkan sebagian rekaman, tetapi tidak membuktikan diskusi lengkap.
Arsip menyediakan rekaman dalam urutan dokumen, bukan berdasarkan waktu, relevansi, atau skor. Sesuaikan antarmuka dengan batas itu: sebut area tersebut referensi historis, bukan jawaban terbaik. Pembaca dapat membandingkan pengalaman berbeda dan mengikuti sumber jika tersedia. Jangan mengubah cuplikan pengaturan orang lain menjadi petunjuk yang dipastikan berlaku bagi perangkat atau perjalanan ini.
Rancang hasil yang kurang membantu lebih dahulu
Permintaan yang berhasil mungkin tidak memberikan rekaman. Pertahankan masukan terlihat dan tawarkan perubahan secara sengaja, seperti mencoba istilah lain. Status kosong menjelaskan respons itu; bukan bukti bahwa topik tersebut tidak pernah dibahas. Setiap pengambilan berhasil, termasuk tanpa hasil, memerlukan satu kredit. Operator aplikasi perlu memahami biayanya sebelum mengaktifkan pencarian otomatis.
Kegagalan adalah hal berbeda. Pertahankan pertanyaan dan tampilkan pilihan mencoba lagi bila sesuai. Masalah kunci layanan dan kredit menjadi urusan operator, sedangkan pendaki membutuhkan penjelasan singkat bahwa pencarian diskusi tidak tersedia. Jangan menempatkan kontrol pembayaran akun pada alur ini atau menganggap permintaan lambat sebagai bukti arsip sedang mati.
Biarkan pembaca pergi membawa sesuatu yang terbatas
Jika pagination.has_more mengizinkan, tindakan Tampilkan lagi dapat mengambil halaman berikutnya dengan filter dan limit yang sama. Pembaca juga dapat menyimpan referensi sumber di daftar lokal milik aplikasi. Kedua tindakan itu tidak menjamin cakupan lengkap, ketersediaan sumber permanen, atau salinan offline seluruh percakapan. Referensi yang disimpan juga tidak mengunduh peta yang dapat dipakai.
Penutup yang berguna adalah daftar singkat pertanyaan untuk diperiksa pendaki pada perangkat lunak peta dan panduan terkini yang benar-benar dipakainya. Itu merupakan tujuan desain, bukan manfaat yang telah diukur. Pertahankan label historis setiap kali referensi muncul kembali. Lihat /id/#field-notes untuk pemetaan kartu, label umur sumber, dan pilihan daftar bacaan lokal.
