Berikan orang sesuatu untuk ditautkan agar mereka bisa membicarakannya

 (simonwillison.net)
1 poin oleh GN⁺ 2024-07-14 | 1 komentar | Bagikan ke WhatsApp
  • Jika Anda ingin orang memahami dan membagikan proyek atau fitur produk, yang dibutuhkan lebih dulu adalah halaman web khusus, bukan penjelasan berulang
  • Meski ChatGPT Code Interpreter adalah fitur yang kuat, nama resminya dan kemudahannya untuk ditemukan di dokumentasi resmi tidak konsisten, sehingga penjelasan buatan orang lain justru menjadi tautan yang lebih berguna
  • Contoh Claude Artifacts serta GitHub Codespaces·Copilot menunjukkan bahwa ketika sebuah fitur menjadi objek yang bisa ditautkan, membagikan dan menjelaskannya menjadi lebih mudah
  • Seperti Boring Technology dari Dan McKinley, ketika sebuah konsep dirangkum dalam halaman terpisah, orang yang baru pertama kali mendengarnya bisa cepat mengikuti konteks hanya lewat satu tautan
  • Nilai halaman khusus bukan hanya soal visibilitas pencarian, tetapi juga mencegah kita mengulang penjelasan yang sama dalam percakapan di web

Mengapa halaman yang bisa ditautkan itu diperlukan

  • Untuk hal-hal seperti proyek, ide, atau fitur produk yang ingin dipahami dan dibicarakan orang lain, diperlukan halaman yang bisa ditautkan
  • Hyperlink adalah sarana dasar untuk memperluas percakapan di web, sehingga kita bisa menghubungkan orang ke penjelasan yang paling menentukan tanpa harus menulis ulang setiap kali
  • Jika tidak ada halaman khusus, perhatian dan trafik pencarian bisa mengalir ke penjelasan buatan orang lain atau ke halaman yang lebih dulu mengambil alih kata kunci pencarian

Masalah discoverability pada ChatGPT Code Interpreter

  • ChatGPT Code Interpreter adalah fitur yang memungkinkan ChatGPT menulis dan menjalankan kode Python selama proses merespons
  • Fiturnya sendiri sangat kuat, tetapi jika Anda tidak tahu cara mengaktifkannya lewat prompt, keberadaannya sulit disadari
  • Saat mencari Code Interpreter di situs OpenAI, yang muncul bisa berupa dokumentasi teknis tentang fitur API atau thread forum lama, sehingga membingungkan
  • Saat memperkenalkan fitur ini, halaman tag code-interpreter justru lebih berguna sebagai tautan daripada halaman resmi OpenAI
  • Dokumentasi yang sebenarnya akhirnya ditemukan, tetapi judulnya adalah Data analysis with ChatGPT, dan karena istilah “Code Interpreter” tidak ada di halaman itu, dokumen tersebut sulit ditemukan
  • OpenAI terus mengganti nama fitur ini antara Code Interpreter, Advanced Data Analysis, dan Data analysis with ChatGPT

Contoh fitur dengan halaman yang dibuat dengan baik

  • Fitur Artifacts milik Claude setidaknya memiliki halaman bantuan yang mudah ditemukan
  • Namun, artikel pengumuman Artifacts dibagikan bersama pengumuman Claude 3.5 Sonnet, sehingga sulit terlihat sebagai target tautan yang jelas khusus untuk Artifacts
  • GitHub menyediakan halaman landing terpisah untuk tiap fitur
  • Jika sebuah fitur memiliki halaman khusus tersendiri, akan ada titik acuan penjelasan saat orang menautkan dan membagikannya

Boring Technology: contoh konsep yang menjadi situs web

  • Dan McKinley menciptakan istilah Boring Technology dalam esai tahun 2015, Choose Boring Technology
  • Gagasan intinya adalah bahwa kapasitas tim pengembang untuk menyelesaikan masalah baru itu terbatas, jadi kapasitas itu seharusnya dipakai pada bagian yang membuat produk unik
  • Untuk area lainnya, sebaiknya pilih teknologi yang paling membosankan dan paling dikenal, yang bug serta keterbatasannya telah lama dipahami dan didiskusikan secara online
  • Ide ini juga dirangkum dalam situs web boringtechnology.club
  • Jika seseorang belum mengenal istilah ini, cukup bagikan satu tautan dan dalam beberapa menit mereka bisa mengikuti konteksnya

Ide pribadi pun membutuhkan halaman yang bisa dibagikan

  • Ide seperti baked data, git scraping, dan prompt injection juga telah dirangkum dalam halaman yang bisa sering dibagikan
  • Namun, tanpa domain terpisah, pesan bahwa “inilah halaman inti yang harus ditautkan” bisa menjadi lebih lemah
  • Target tautan yang jelas meningkatkan kemudahan sebuah ide untuk dibagikan dan dibicarakan

Nilainya lebih besar dalam percakapan daripada sekadar SEO

  • Salah satu tujuan paling jelas dari halaman khusus adalah SEO
    • Saat pengguna mencari fitur produk, mereka harus diarahkan ke situs Anda, bukan ke halaman buatan orang lain
  • Namun nilai yang lebih besar muncul dalam percakapan
    • Saat menjelaskan sebuah konsep, Anda bisa membagikan tautan yang berisi penjelasan paling menentukan alih-alih menulis ulang satu paragraf setiap kali
  • Jika Anda ingin orang memahami dan mendiskusikan ide, proyek, atau fitur, Anda perlu membuat halaman web yang layak untuk itu

Bacaan terkait

1 komentar

 
GN⁺ 2024-07-14
Komentar Hacker News

  • rsync.net adalah layanan yang sangat bagus dalam hal seperti ini. Misalnya, saya belum pernah melihat sesuatu seperti halaman CEO di layanan lain.
    Saya tidak tahu apakah ini benar-benar berguna, dan saya juga belum pernah perlu menyampaikan sesuatu kepada CEO, tetapi meski bukan pelanggan, halaman itu langsung terlintas di benak saya begitu membaca tulisan ini
    [1]: https://www.rsync.net/products/ceopage.html

    • Beberapa konferensi punya halaman “Mengapa karyawan Anda harus menghadiri KimchiBurgerConf”.
      Halaman itu dirancang agar peserta bisa langsung mengirimkannya ke atasan, tanpa harus mengarang alasan kerja yang terdengar meyakinkan sendiri

  • Untuk perusahaan sebesar OpenAI, saya kira mereka pasti sudah mempekerjakan technical writer, tetapi dari LinkedIn sepertinya tidak. Jadi kondisi dokumentasinya yang seburuk ini juga tidak terlalu mengejutkan.
    Saya benar-benar tidak paham kenapa mereka tidak merekrut peran khusus dokumentasi. Mungkin mereka menganggapnya tidak penting, atau secara dingin memprioritaskan pertumbuhan dibanding dokumentasi, tetapi apa pun alasannya, pada akhirnya mereka merugikan diri sendiri

    • Dokumentasi OpenAI belakangan sedikit membaik, tetapi saat ini masih jauh tertinggal dari Anthropic. Panduan prompt Anthropic benar-benar salah satu yang terbaik yang pernah saya lihat: https://docs.anthropic.com/en/docs/build-with-claude/prompt-...
    • Mempekerjakan technical writer berarti mengakui adanya keunggulan manusia di ranah dokumentasi teknis. Seolah-olah, terlepas dari dampaknya bagi engineer dan pengguna, memakai dokumentasi hasil GPT terlihat lebih baik dari luar

  • Tulisan itu merujuk ke https://boringtechnology.club/, sebuah slide deck yang sangat bagus tentang menyisakan upaya inovasi hanya untuk solusi yang benar-benar unik.
    Selebihnya sebaiknya memakai boring technology sebanyak mungkin. Terlalu sering saya melihat tim pengembang mencoba berinovasi sampai ke lapisan paling bawah, lalu kehilangan fokus pada nilai apa yang sebenarnya mereka berikan. Saya ingin menanamkan slide deck ini ke dalam cara pandang saya

  • Ini lagi-lagi tulisan Simon yang bagus. Tadi malam saya langsung memasukkan konsep ini ke proyek baru saya. Saya ingin menunjukkan bukti bahwa Google Gemini App menyensor yt-dlp, tetapi Gemini API tidak, dan sekaligus menciptakan jalur masuk proyek serta alasan bisnis yang Simon bicarakan
    https://topicalsource.dev/chat/84a0d6dd-f66f-4f12-af17-5e99c...
    Saya juga memakai localStorage untuk menyimpan daftar chat publik yang pernah dikunjungi. Saat kembali lagi, kita bisa melihat chat lain yang pernah dibaca, dan lebih mudah menemukannya daripada mengorek riwayat pesan untuk mencari dari mana tautan aslinya didapat

    • Sebagai catatan, sebaiknya jangan buka tautan YouTube contoh itu. Gemini memunculkan meme troll yang umum

  • Tautan mati adalah yang paling parah. Tidak adakah yang bisa membuat ekstensi browser yang memakai GPT untuk menghalusinasikan situs dari tautan mati?

    • Mungkin sudah ada beberapa generasi yang tidak sadar bahwa link rot bukan hanya terjadi pada URL “internal”, misalnya tautan gambar Discord, tetapi pada semua tautan.
      Para seniman sering hanya menautkan situs media sosial, padahal akun bisa ditangguhkan dan username bisa berubah. Pengembang juga “menautkan” dependensi tanpa memikirkan bahwa repositorinya bisa hilang, dan jika tidak ada yang membackup, source code untuk versi itu juga ikut lenyap; versi paket bisa dihapus dari registry, atau dokumentasi online dari dependensi itu bisa menghilang
      [1]: Sekadar menambahkan nama+versi ke file manifest lalu melupakannya selamanya. Bahkan jika menambahkan cache, itu pun belum menjadi mirror yang layak, apalagi cara untuk membangun dependensi sendiri saat bencana terjadi
    • https://websim.ai/
    • Akan menarik juga jika ada metode kompresi yang hanya menyajikan cukup informasi agar versi LLM yang tetap bisa menghasilkan halaman yang memenuhi tujuan penulis.
      Jika orang-orang mendeskripsikan satu per satu seperti apa halaman itu dulu, atau merayapi web untuk mencari petunjuk, itu akan jadi ide yang cukup menarik. Bahkan banner “under construction” pun bisa kembali
    • Dulu ini disebut imajinasi. Di era digital, rasanya kita kehilangannya :3
    • Saya tidak tahu soal ekstensi browser, tetapi ada situs bernama websim AI yang menghasilkan halaman palsu secara real-time dengan LLM. Sejujurnya hasilnya bekerja sangat baik sampai mengejutkan

  • Saya suka blog Simonw. Sejak September tahun lalu saya membacanya memakai Python interpreter. Dia bilang dia mulai melakukan itu sendirian untuk mencoba membangun seluruh aplikasi secara spontan.
    Namun saya masih belum jelas bagaimana caranya. Saya kira akan ada opsi atau tombol yang mudah, tetapi saya tidak menemukannya. Mungkin saya bisa berusaha lebih keras untuk mencari tahu, tetapi kalau ada tautan yang mudah diakses atau tutorial, saya rasa saya akan terus memakainya dan tidak terlalu mengabaikan GPT

  • Dalam konteks ini, meme respons insiden milik Square tetap hidup di https://outage.party/

    • Bisa jelaskan konteksnya untuk orang-orang yang tidak ada di sana waktu itu?

  • Saya sangat membenci banyak produk Microsoft justru karena alasan ini. Produk yang sering berganti nama seperti VSTS/VSO/Dev Ops atau Sharepoint terasa sangat buruk. Satu deep link bisa sepanjang 700 karakter, dengan puluhan query string base64 dan path yang tidak masuk akal. Rasanya bikin gila karena sikapnya seperti, “Memangnya apa masalahnya? Pakai saja layanan pemendek URL. URL memang panjang, mau bagaimana lagi.”
    Pada 2014, ada alat internal tim yang menampilkan status resource sistem, dan semua resource beserta statusnya ada di database SQL. Namun web app-nya adalah SPA dari era sebelum ada router semacam itu, dan tidak memperbarui URL maupun mendukung deep link. Kalau ingin mengirim masalah resource tertentu lewat email atau messenger, kami harus menjelaskan, “Buka alat X, cari Y, lalu klik Z -> W -> M -> O -> K, nanti terlihat di sana.” Saya sangat kesal kenapa status yang bersarang sedalam itu tidak bisa dibagikan begitu saja lewat tautan https://X.com/Y/Z/W/M/O/K. Meski sudah berkali-kali dibicarakan, jawabannya selalu hanya, “Itu bukan prioritas dan bukan masalah sebesar itu.”
    Suatu kali saya mendapat kesempatan untuk mengerjakan sesuatu yang ingin saya perbaiki selama dua minggu, dan saya memutuskan membuat alternatif yang mendukung deep link. Saya juga membuat semua deep link mengembalikan isinya sebagai JSON jika diberi prefiks /api/. Ini jadi hit besar di tim dan perusahaan; meskipun alat saya jauh lebih sederhana dan fiturnya lebih sedikit, penggunaan alat X hampir turun dalam semalam. Pada akhirnya, kebanyakan orang memang menginginkan cara berbagi tautan dengan mudah, bukan “SPA kuat untuk menggali dan menyelidiki secara mendalam.”
    Sebulan kemudian, tim alat X mengumumkan lewat email ke seluruh perusahaan dengan gembar-gembor bahwa mereka kini mendukung deep link. Namun mereka menganggap kemampuan sederhana untuk mengembalikan data JSON lewat prefiks /api/ tidak penting. Lima tahun kemudian, UI alat saya memang sudah ketinggalan zaman, tetapi layanan nyatanya dipromosikan menjadi layanan internal inti karena banyak tim membangun otomasi di sekitar URL berprefiks /api/, dan pada akhirnya tim itu harus mengambil alih kode tersebut untuk memeliharanya

    • Di lingkungan kantor, saya sering melihat orang puas memakai alat dan prosedur yang sudah ditentukan begitu saja, dan tidak terlalu terpikir bahwa semuanya bisa dibuat lebih baik. Kalau ditanya, ya begitu saja, sampai diperlihatkan sesuatu yang lebih baik
    • Salah satu alasan React Server Components terasa tidak nyaman adalah karena itu mendorong pencampuran API dan lapisan presentasi. Memang ada kelebihannya, tetapi kita semua tahu lapisan presentasi selalu gagal jika harus dirancang untuk pengguna atau use case yang belum terbayangkan
    • Apa itu SPA?

  • Sebagai penggemar Simonw, ada satu hal yang menurut saya belum disorot siapa pun: contoh lain dari Simon yang menyediakan sesuatu untuk ditautkan orang juga sangat efektif di HN: https://hn.algolia.com/?dateRange=all&page=0&prefix=true&que...
    Orang-orang yang dekat dengan dunia AI biasanya sudah tahu, tetapi Simon sering sangat cepat merangkum kabar yang sedang berkembang yang belum diketahui khalayak yang lebih luas. Ia dengan cepat menautkan fakta-fakta relevan dan membuatnya mudah diakses, sehingga orang yang jauh dari isu itu pun bisa ikut berdiskusi

  • Saya setuju dengan ungkapan “hyperlink adalah hal terbaik dari web”. Lebih tepatnya, hyperlink dan URL.
    URL adalah landasan web. URL memungkinkan kita merujuk tulisan dan sumber daya lain dengan cara yang presisi, universal, dan diharapkan bertahan lama. Saya selalu frustrasi melihat orang tidak menyadari betapa hebatnya ini. Misalnya, alih-alih menempelkan tautan di pesan, mereka berkata “cari ini di YouTube”. Jika sebuah tulisan diberi tempat tinggal web yang permanen, visibilitasnya juga meningkat, dan penulis tidak perlu menulis ulang gagasan yang sama
    Esai klasik terkait: Cool URIs don't change. [0][1]
    [0] https://www.w3.org/Provider/Style/URI
    [1] https://news.ycombinator.com/item?id=23865484

    • Dua sifat URL yang kurang dimanfaatkan adalah bisa dibuat nyaris tak terbatas dan bisa dideklarasikan lebih dulu.
      Dampak praktisnya seperti ini. Saat sedang berbicara dengan seseorang atau dalam sesi tanya jawab presentasi, Anda mungkin ingin berkata, “ya, kami juga sudah memikirkan itu, dan ada informasi terkait di acmeinitiative.example.com/skub”, meskipun Anda belum menulis artikel /skub itu. Bahkan saat itu juga, Anda bisa langsung menetapkan /skub sebagai handle yang dituju untuk artikel tersebut. Artikelnya bisa ditulis nanti dan akan muncul di sana, sementara orang yang tertarik kapan pun bisa mencarinya lewat URL itu. Hal yang sama berlaku untuk artikel yang ditulis orang lain atau sumber daya eksternal; Anda bisa membuat URL dadakan di namespace Anda sendiri, lalu ketika ada waktu mengarahkannya dengan redirect ke tautan aslinya
      Saya terlalu sering mendengar rekaman, podcast, dan sebagainya yang menampilkan teknolog cerdas yang jelas memiliki domain sendiri, tetapi tidak memakai cara ini. Biasanya mereka malah menggumamkan deskripsi samar yang mungkin bisa dicari, atau mencoba mengingat judul lalu menyebutkannya setengah salah. Akibatnya, semua pendengar yang tertarik harus masing-masing membuang waktu dan perhatian untuk mencarinya, dan secara kolektif energi dalam jumlah besar terbuang percuma
    • Taman berpagar semakin sering memblokir URL.
      FB memblokir banyak situs, sampai blog acak sekali pun, dengan alasan berbagi konten berhak cipta; reddit memblokir semua .ru, berbagai situs arsip, tautan Telegram, dan lainnya. Twitter pernah memblokir beberapa platform blog, dan situs-situs yang lebih kecil pun sering memblokir Discord. Pemblokiran Discord mungkin bisa dibenarkan, tetapi saya berharap tren seperti ini mendorong orang untuk meninggalkan tempat-tempat itu
    • Saya tidak suka ungkapan “cari saja”.
      Pertama, itu langsung memicu kesan tidak enak seperti AOL Keyword. Kedua, itu sepenuhnya mengabaikan konsep gelembung pencarian. Meski memasukkan kata kunci yang sama, hasil yang Anda dan saya terima bisa sangat berbeda. Ketiga, ketika URL dan hyperlink sudah ada, tidak ada alasan membebankan pekerjaan tambahan kepada saya. Jika Anda menautkan langsung, saya bisa melihat persis apa yang Anda rujuk tanpa harus tersesat di antara banyak video reaksi
    • Mudah untuk mengatakan agar orang mengklik https://youtu.be/dQw4w9WgXcQ, tetapi di media khusus suara seperti telepon atau podcast, bagaimana URL itu disampaikan? Itu tidak mudah kecuali mengandalkan layanan pemendek URL yang sama-sama sulit dihafal
    • Bagian tentang penulis tidak perlu menulis ulang gagasan yang sama benar-benar sesuatu yang saya harap bisa terjadi.
      Tetapi banyak situs dan layanan tidak menyukai ini. Mereka menganggapnya sebagai pelanggaran terhadap wilayah perhatian mereka. Sebagai penulis, ketika saya menautkan ide yang sudah saya rumuskan dengan hati-hati di tulisan blog atau buku, komentar saya diturunkan atau disensor dengan alasan “promosi”. Belakangan ini di HN, untuk menghindari hukuman, saya lebih sering sekadar menyalin-tempel teks asli yang saya tulis daripada memberi tautan agar pembaca bisa menjelajah lebih jauh. Jelas ada jurang antara apa yang kita khotbahkan sebagai cara “akademis” yang baik untuk menyebarkan informasi dan kenyataan sistem yang mengendalikan ekspresi