Jelaskan penanda waktu yang sedang ditampilkan
Saat menyajikan diskusi historis Reddit dalam aplikasi, tantangan terpenting ialah menjelaskan timestamp mana yang menentukan umur hasil. Waktu pembuatan sumber, saat aplikasi mengambil rekaman, dan saat arsip memasukkannya menjawab pertanyaan berbeda. Jangan beri semuanya label Diperbarui. Permintaan hari ini dapat mengambil diskusi lama tanpa membuat isinya mutakhir.
Untuk fitur pendakian hipotetis, pembaca yang membandingkan saran peta offline perlu tahu bahwa referensinya historis. Jika nilai created_utc yang valid tersedia, tandai tanggal sebagai waktu pembuatan posting atau komentar sumber. API meneruskan rekaman sumber datar; jangan anggap setiap rekaman memiliki field itu atau nilainya pasti layak ditampilkan.
Sediakan status desain yang nyata untuk tanggal hilang
Pertimbangkan dua label usulan, bukan contoh hasil pengambilan: Tanggal asli: tersedia dari rekaman, dan Tanggal asli: tidak tersedia. Kartu kedua harus tetap terbaca tanpa diam-diam mengganti tanggal dengan hari ini. Timestamp yang hilang berarti bukti tidak ada, bukan bukti diskusi tersebut baru.
Validasi jenis dan rentang field sebelum memformatnya. Untuk label relatif seperti beberapa tahun lalu, jelaskan acuannya dan berikan tanggal absolut yang mudah dimengerti bila memungkinkan. Pertimbangkan zona waktu tampilan aplikasi. Jika jam klien salah atau nilai tidak dapat ditafsirkan dengan yakin, gunakan status tanggal hilang yang konservatif alih-alih usia yang tampak presisi namun tidak andal.
Pisahkan riwayat pengambilan
Aplikasi boleh mencatat waktu pengambilan atau penyimpanan item untuk menjelaskan status daftar baca lokal. Beri label Diambil oleh aplikasi ini atau Disimpan secara lokal. Nilai itu menggambarkan tindakan aplikasi, bukan pembuatan rekaman, edit terakhir, balasan terakhir, waktu masuk arsip, atau akurasi saat ini. Nilai tersebut juga bukan pengukuran latensi dengan sendirinya.
Jangan mengarang tanggal pemasukan ke arsip dari waktu permintaan. Antarmuka saat ini tidak menjanjikan timestamp tersebut pada setiap rekaman. Jangan pula menyimpulkan seluruh periode cakupan dari item tertua atau terbaru dalam respons kecil. Ketiadaan hasil dapat memiliki beberapa penjelasan dan tidak membuktikan bahwa diskusinya tak pernah ada.
Filter tanggal tanpa mengklaim urutan waktu
Filter tanggal mempersempit pencarian, tetapi tidak menyediakan pengurutan kronologis. from dan to menerima tanggal YYYY-MM-DD dalam UTC, termasuk seluruh hari to. Permintaan hipotetis from=2025-01-01 dan to=2025-12-31 meminta rentang tanggal sumber tersebut, bukan hasil terbaru lebih dahulu.
Layanan mengembalikan urutan arsip _doc. Jika aplikasi mengurutkan rekaman yang diambil secara lokal berdasarkan field pembuatan yang valid, jelaskan sebagai pengurutan rekaman yang telah dimuat itu. Hal ini tidak membuktikan kartu pertama adalah kecocokan terbaru di seluruh arsip. Rekaman tanpa tanggal layak pakai perlu penempatan tersendiri yang dijelaskan, bukan timestamp rekaan.
Hubungkan kembali tanggal dengan keputusan pembaca
Diskusi lama mungkin membantu pendaki menentukan pertanyaan peta offline yang perlu diteliti: persiapan unduhan, penggunaan baterai, atau batas perangkat. Diskusi itu tidak membuktikan jalur sedang terbuka, produk berperilaku sama hari ini, atau solusi sementara lama masih sesuai. Pisahkan fitur membaca dari navigasi dan informasi keselamatan terbaru.
Label historis yang tenang lebih berguna daripada lencana kebaruan tanpa bukti. Hindari Baru aktif, Sepenuhnya tersinkron, atau Saran langsung tanpa bukti terpisah untuk klaim tersebut; respons arsip ini tidak menyediakannya. Pertahankan tautan sumber jika tersedia dan tangani halaman yang berubah atau hilang. Lihat /id/#field-notes untuk desain kartu diskusi dan daftar baca lokal.
