Selamat datang di tim. Ini orientasi Anda. Semoga nasib menguntungkan Anda.

Perkenalan

Jade baru saja bergabung dengan tim Platform Anda.
Dia brilian, termotivasi, sedikit terkesan dengan tumpukan itu.
Dia mengajukan diri sebagai penghargaan untuk bekerja di lingkungan pengembang internal.
Dia berharap untuk belajar, berkontribusi, dan yang terpenting… tidak mati dalam tiga hari pertama.

Mari kita bayangkan dua skenario:

Garis Waktu 1

Dia membuka Confluence.
87 halaman. Beberapa di antaranya mutakhir.
Yang lainnya tampaknya ditulis pada masa pemberontakan pertama.

Ini mengkloning repositori Git. README berisi instruksi usang, komentar yang meragukan, dan langkah ‘TODO’ yang terlupakan sejak tahun 2021.

Dia menginstal apa yang diperintahkan… kecuali skripnya mogok.
Variabel lingkungan yang terlupakan, versi Python yang tidak kompatibel, dan alat untuk dipasang secara manual.
Selamat datang di arena.

Dia meminta bantuan.
Seseorang menjawab dengan samar: “Anda harus mengikuti langkah-langkahnya secara berurutan.”
Tapi ketertiban tidak ada dimanapun.

Pipeline CI gagal tanpa pesan yang berguna.
Vault tidak memberinya akses ke rahasia.
Dia tidak memiliki visibilitas tentang apa yang dia lakukan dengan benar.
Dan sepertinya tidak ada yang mengawasi para peserta.

Setelah tiga minggu, Jade sudah menginstal hampir semuanya.
Tapi dia masih tidak tahu apakah dia melakukan hal yang benar.
Atau apa yang harus dia lakukan selanjutnya.

Dia tidak tersingkir.
Tapi dia hampir tidak bisa bertahan.
Dia melepaskan diri. Lembam. Dalam mode ‘Saya akan menunggu untuk diberi tahu apa yang harus dilakukan’.
Atau lebih buruk lagi: “Saya akan melakukan seperti sebelumnya”.

Garis Waktu 2

Dia menerima pesan ucapan:
“Selamat datang di tim Platform. Inilah perjalanan orientasi Anda.”

Itu klik.
Dasbor kecil terbuka, bersih dan ramah.
Tidak ada jebakan, tidak ada gangguan.

• Langkah 1: Buat namespace pribadi
• Langkah 2: Luncurkan alur pengujian
• Langkah 3: Amati penerapan di dasbor tim (Grafana)
• Langkah 4: Konfirmasikan semuanya berwarna hijau → divalidasi

Setiap langkah dipandu dan dikontekstualisasikan.
Kesalahan diperkirakan terjadi. Umpan baliknya jelas.
Dan yang terpenting: dia memahami apa yang dia lakukan.

Jade menerapkan aplikasi pengujian dalam 2 hari.
Keesokan harinya, dia menanyakan pertanyaan yang relevan.
Dua hari kemudian, dia mengirimkan PR untuk meningkatkan pengalamannya.

Dia tidak lagi berlari untuk hidupnya.
Dia membangun. Dia berkontribusi.
Itu menjadi aset.

Apa yang telah terjadi?

Bahkan Giok.
Tim yang sama.
Platform yang sama.

Tapi dua pengalaman yang sangat berbeda.

Dan apa yang mengubah segalanya…
Itu bukan motivasinya.
Itu bukan keahliannya.
Itu bahkan bukan tumpukannya.

Yang mengubah segalanya adalah orientasi.
Inilah perbedaan antara dijatuhkan ke arena tanpa busur,
dan mulailah dengan seorang mentor, rencana, dan peluang nyata untuk sukses.

Selamat datang di tim. Ini orientasi Anda.
Semoga nasib menguntungkan Anda.

Mengapa orientasi itu strategis?

Di distrik-distrik, arena dibangun dengan hati-hati.
Setiap jebakan, setiap sumber daya, setiap tepian tebing dipasang dengan niat.
Untuk apa ? Karena pertunjukannya harus dikontrol.

Dalam sebuah tim, orientasi Anda adalah arenanya.
Ini adalah pertemuan pertama antara pengguna dan tumpukan Anda.
Dan jika terjadi kekacauan total, jangan heran jika tidak ada yang mau kembali.

Terlalu sering, orientasi dipandang sebagai sebuah detail.
Sebuah dokumen. Daftar periksa. Sebuah ritus peralihan.

Namun pada kenyataannya, ini adalah komponen strategis dari arsitektur manusia Anda.
Di sinilah hasilnya:

• Mengadopsi alat Anda
• Bangkitnya otonomi
• Percaya pada tim

Orientasi yang diabaikan seperti arena yang dibuat secara acak:
tanpa aturan yang jelas, tanpa landasan yang stabil, tanpa jalan keluar yang terlihat.
Dan para peserta… eh, para pengembang, menghabiskan lebih banyak waktu untuk bertahan hidup daripada membangun.

Karena ya:
orientasi bukanlah hal yang paling penting dalam DevEx.
Ini adalah pintu gerbang menuju keseluruhan strategi Anda.

Kesalahan klasik yang harus dihindari

Bukan jebakan paling mematikan yang membunuh terlebih dahulu.
Ini adalah kesalahan-kesalahan bodoh. Air yang terkontaminasi. Buah beri beracun.
Dan yang terpenting: tidak adanya informasi!

Di platform arena Anda, sama saja.
Berikut adalah kendala paling umum yang mematikan orientasi Anda… secara perlahan.

L’instalasi-puzzle

Sebuah skrip untuk dijalankan… tetapi hanya setelah mengekspor tiga variabel.
Alat dalam versi 2.4.1, tetapi khususnya bukan versi 2.5.
Dan tentu saja: token dihasilkan secara manual melalui alat yang tidak dijelaskan oleh siapa pun.

Hasil ?
Jade menghabiskan beberapa hari pertamanya dengan menumpuk artefak seperti ranting basah.
Tidak ada yang menyala. Semuanya merokok.

Makamnya dok

Wiki ini berasal dari Zaman Api.
Itu ditulis untuk cluster lain, alat lain, dunia lain.

Ada dokternya ya.
Tapi itu terlihat seperti peta yang dibuat oleh Capitol: peta itu mengirimmu ke dinding sambil tersenyum lebar.

Le mentor suku

“Ah, kamu harus menanyakan hal itu pada Haymitch. Dialah yang tahu.”
Haymitch sudah mengetahui semuanya. Dia adalah orang yang selamat.
Tapi dia sedang berlibur. Dan para sponsor tidak meninggalkan kebutuhan bisnis yang terlewat!

Informasinya ada di sana.
Namun hal ini ditularkan melalui tradisi lisan.
Cukuplah untuk mengatakan: tidak berguna bagi pendatang baru.

Ketidakjelasan fungsional

Jade menginstal semuanya.
Tapi sekarang? Apa yang harus dia lakukan?
Terapkan aplikasi? Integrasikan layanan? Dorong PR?

Dia menunggu… sinyal. Sebuah misi. Sebuah validasi.
Tapi tidak ada apa-apa.
Hanya kekosongan.

Pipa yang sunyi

Komitmen utama. Dorongan utama.
Dan di sana… saluran pipanya rusak.
Tapi tanpa pesan.
Tanpa log.
Tanpa indeks.

Itu tidak lagi masuk.
Ini adalah penyelidikan yudisial. Dan Jade tidak memiliki lencana Penjaga Perdamaian.

Jadi?

Ini bukan masalah dokumentasi.
Ini adalah sinyal lemah bahwa platform Anda tidak layak huni.
Atau lebih buruk lagi: dirancang tanpa memikirkan manusia.

Tiga pola yang menyelamatkan hari ini

Beberapa peserta tidak dapat bertahan hanya karena mereka kuat.
Mereka bertahan karena telah memahami aturan-aturan arena yang tidak kasat mata.
Karena mereka mengamati.
Karena mereka menggunakan mekanisme permainan…untuk keuntungan mereka.

Pengungkapan Progresif

Jangan membuang seluruh tumpukan pada hari pertama.
Jangan berikan 19 alat, 42 parameter, 12 templat, dan satu cluster pengujian dalam satu jam pertama.

Mulailah dari yang kecil.
Saluran demo.
Ruang nama yang hilang.
Rahasia untuk menyuntik.
Dasbor untuk diamati.

Kemudian, kemudian, Anda mengungkapkan:

Aliran GitOps yang sebenarnya

Strategi penerapan

Konvensi tim

Ini setara dengan menemukan arena sedikit demi sedikit,
alih-alih jatuh ke dalam labirin jebakan dari kotak pertama.

Sedikit demi sedikit, Jade mengetahuinya.
Dia tidak kewalahan.
Dia dibimbing.

FTUE — Pengalaman Pengguna Pertama Kali

Kami tidak cukup mengatakannya, tetapi yang pertama kali penting.
Di sinilah penilaian, emosi, koneksi terbentuk.

Jika orientasi Anda dimulai dengan ‘tidak berfungsi’,
Anda telah kehilangan kepercayaan modal. Mungkin selamanya.

FTUE (Pengalaman Pengguna Pertama Kali) yang baik adalah:

Jalan yang jelas
Langkah-langkah yang memvalidasi sesuatu
Kemenangan cepat (untuk suntikan dopamin)

Pada dasarnya, ini bukan wiki.
Itu sebuah pengalaman.
Dirancang sebagai fitur produk.

Dan ingat:
kemenangan pertama harus datang dengan cepat.
Jika tidak, masalah akan terjadi.

Di timeline B, Jade melihat penerapan pertamanya berhasil.
Dia melihat lognya.
Dia memahami ‘mengapa’ di balik ‘bagaimana’.
Dan dia merasa bisa memenangkan permainan ini.

Lingkaran umpan balik

Arena yang tidak pernah berubah adalah arena mati.
Itu selalu menguntungkan orang yang sama.
Hal ini menjadi dapat diprediksi, tidak efisien, tidak adil.

Orientasi Anda harus berkembang.
Dan untuk itu, dia membutuhkan umpan balik.

Tanyakan pada diri Anda pertanyaan ini:
Kapan terakhir kali Anda memperbarui orientasi Anda?
Dan bagaimana Anda tahu itu masih berguna?

Buat lingkaran nyata:

Formulir cepat di akhir proses

Tabel penyelesaian langkah (dan di mana ia terhenti)

Apakah Anda melacak kesalahan di saluran pipa Anda?
Lacak juga titik-titik kendala dalam perjalanan pengguna.

Karena orientasi tanpa umpan balik,
ini seperti arena tanpa kamera.
Anda tidak melihat apa pun. Anda tidak belajar apa pun.
Dan Anda mengutuk orang berikutnya untuk mengulangi kesalahan yang sama.

Tingkatkan orientasi Anda

Kami tidak memerlukan perombakan orientasi secara menyeluruh.
Kami hanya perlu menerima bahwa orientasi adalah fitur produk yang nyata.
Dengan desain.
Dengan tes.
Dengan umpan balik pengguna.

Dan seperti semua fitur platform, fitur ini dapat ditingkatkan dengan strategi yang terkenal.

Apa yang Anda lakukan saat menyadari bahwa orientasi Anda… katakanlah, sedikit beracun?
Kapan kita menyadari bahwa Jade menjalani garis waktu terkutuk dalam satu lingkaran?

Audit seperti Game Maker

“Jika Anda tidak bisa mengukurnya, Anda tidak bisa memperbaikinya.” (Tuan Kelvin)

Mulailah dengan mengamati arena.
Bukan tumpukan Anda. Bukan alat Anda.
Pengalaman pendatang baru.

Tanyakan pada diri Anda pertanyaan-pertanyaan ini:

• Berapa lama waktu antara “Saya memulai” dan “Saya menerapkan sesuatu yang berguna”?
• Berapa banyak langkah yang tersirat, bersifat kesukuan, dan tidak terdokumentasi?
• Berapa banyak alat yang dibutuhkan untuk melewati tembok pertama?
• Berapa banyak orang yang harus Anda ganggu agar bisa bertahan?

Ikuti tesnya sendiri. Atau lebih baik: lihat sesuatu yang baru, lakukanlah.
Tanpa membantunya.

Jika dia menemukan dirinya menggali terowongan dengan sendok berkarat… arena Anda bermasalah.

Versi sedang dalam proses orientasi

Kami tidak hanya menginginkan dokumen.
Kami menginginkan rute.

Secara konkret, hal itu dapat berupa:

• Repositori Git dengan panduan langkah demi langkah
• Dasbor orientasi interaktif (bahkan yang sederhana di React atau Markdown)
• PR startup sebagai misi pertama Anda

Tujuannya adalah agar kursus tersebut tidak tinggal di Confluence atau di kepala Haymitch.
Itu harus dapat diamati, dibuat versinya, dan dapat diuji.

Seperti komponen apa pun di platform Anda.

Instrumen rutenya

“Anda harus melihat apa yang terjadi. Bukan menebak-nebak.” (SRE apa saja)
Tempatkan penanda di arena Anda:

• Tingkat penyelesaian
• Langkah-langkah yang divalidasi
• Umpan balik kualitatif

Jika Jade menyerah di level 2, kamu perlu mengetahuinya.
Tidak dalam 6 bulan. Langsung! (Ini bisa menjadi peran mentor)

Kesimpulan

Jade tidak perlu dilatih selama tiga bulan.
Dia tidak membutuhkan ‘teman teknologi’ yang menjelaskan semuanya dengan tangan.

Dia hanya tidak perlu dikorbankan sejak hari pertama.
Jangan sampai kita melemparkannya ke arena dengan ‘hei, baca ini, semoga berhasil’

Platform yang secara teknis brilian namun tidak dapat dipahami,
ini seperti arena yang penuh jebakan dengan tanda selamat datang di pintu masuknya.

Anda dapat memiliki:

• Alat terbaik
• Niat terbaik
• Tim terbaik

Tetapi jika tidak ada yang mengerti cara masuk ke sistem Anda…
Kemudian sistem Anda mati. Perlahan-lahan. Dalam diam.
Dan pada akhirnya Anda akan mempertahankan sesuatu yang tidak digunakan lagi oleh siapa pun.
Kuburan ide-ide bagus.

Anda adalah Insinyur Platform.
Bukan menjebak desainer.

Tugas Anda bukan menguji ketahanan mental orang baru.
Ini tentang membangun jalan bagi mereka.
Padat. Jernih. Progresif.

Selamat datang di tim.
Ini orientasi Anda.
Dan semoga takdir… bukan satu-satunya hal yang menguntungkan.