Buku Pegangan Developer Advocacy

Versi terbaru dari "Developer Evangelist Handbook" yang pertama kali dipublikasikan oleh Christian Heilmann 15 tahun lalu

• Apa itu Developer Advocacy / Evangelism?

→ Mendefinisikannya

→ Pola pikir yang benar: orang yang membawa perubahan bagi developer

→ Menjalankan peran dan memaksimalkan kekuatan

• Bekerja sama dengan perusahaan Anda

→ Bersiap menghadapi bias: peran unik yang mencakup banyak fungsi. Jangan patah semangat

→ Menghadapi perubahan di perusahaan: patuhi prosedur hukum. Tidak ada "off-the-record". Jangan bertindak emosional atau berasumsi

→ Mendampingi developer internal: dengarkan mereka

→ Berkolaborasi dengan PR dan marketing: bukan pesaing, teruslah berkomunikasi

→ Dipandang sebagai kanal eksternal: beri tahu anggota tim kanal apa saja yang terhubung dengan Anda

→ Mendidik Advocate lain dan developer: adakan pelatihan dan presentasi internal, serta bagikan umpan balik dari luar

→ Berbagi teknologi yang berguna: komunikasikan ke internal tentang teknologi yang Anda pelajari

→ Menyeimbangkan kanal pribadi dan kanal resmi

→ Menghapus branding dari diri sendiri: pisahkan diri Anda dari brand perusahaan. Fokus hanya pada membantu developer bereksperimen dengan produk

• Bekerja sama dengan kompetitor

→ Saat bekerja dengan kompetitor:

✓ Jadilah orang yang independen terhadap apa pun yang menarik, tanpa peduli produk perusahaan mana

✓ Selalu biasakan diri dengan hal-hal baru

→ Menghormati kompetitor: tidak mungkin menjadi DA yang hebat sekaligus tukang ribut.

→ Akui saat produk kompetitor lebih baik: jadilah orang yang menghargai teknologi bagus, yang tidak takut pada persaingan melainkan menyambutnya, dan juga bisa memberi umpan balik ke tim internal

→ Kenali kompetitor: jika ingin membandingkan, Anda harus memahaminya lebih dulu

→ Buat dan gunakan contoh dengan produk kompetitor: Anda bisa membandingkannya dan memahami perbedaannya

• Persiapan outreach

→ Pastikan fakta yang akurat: tanyakan detail spesifikasi dan fitur kepada tim produk, termasuk apa yang tidak termasuk

→ Kenali audiens dan kebutuhan mereka

→ Siapkan ahli pendukung:

✓ Catat pertanyaan yang tidak bisa dijawab lalu tindak lanjuti

✓ Jangan menjanjikan sesuatu yang Anda tidak yakin bisa disediakan oleh tim produk

→ Pilih media yang tepat: materi presentasi, video, audio, live coding, contoh langkah demi langkah online..

→ Bersiap untuk kegagalan:

✓ Simpan salinan materi presentasi secara lokal dan online.

✓ Simpan juga secara terpisah di USB.

✓ Siapkan agar acara bisa lanjut dengan sesi Q&A jika slide tidak bisa digunakan

✓ Online bisa saja selalu gagal, jadi siapkan lokal atau hotspot

• Mencari kesempatan berbicara

→ Ikut serta dalam podcast

→ Menjadi panelis: jadilah ahli pada topik tertentu, atau anggota sebuah grup

→ Hadir di barcamp/meetup: presentasi singkat

→ Menulis artikel untuk majalah online, dll.

→ Menyelenggarakan sesi brown bag: seminar saat jam makan siang

→ Mengajukan pertanyaan di konferensi

→ Jadilah pembicara yang ingin diundang: publikasikan dan posting topik presentasi Anda

✓ Informasi pribadi, bio terbaru, slide/video presentasi terbaru

✓ Topik yang ingin saya bahas, teknologi yang saya gunakan

✓ Hal-hal yang saya inginkan dari organizer konferensi, dll.

• Perjalanan dinas dan menghadiri konferensi

→ Tips perjalanan dinas: sisakan buffer satu hari, bepergian dengan hemat

→ Siapa yang menanggung biayanya?

→ Hadiri berbagai acara di lokasi konferensi dan bergaul dengan pembicara lain

→ Gunakan media sosial saat menghadiri acara:

✓ Cantumkan kontak media sosial di materi presentasi

✓ Beri tahu kehadiran Anda di konferensi dengan hashtag, dll.

✓ Bagikan hal-hal menarik atau presentasi yang bagus

✓ Bagikan ulang kabar dari organizer konferensi

✓ Posting materi presentasi secara online dan beri tahu orang-orang

→ Bangun jaringan melalui acara

→ Buat kalender untuk melacak kehadiran acara dan catat semuanya

→ Manfaatkan buzz konferensi

→ Jadilah bagian dari konferensi tempat Anda berbicara

→ Rilis presentasi dan materi terkait segera

→ Tulis tentang konferensi tersebut

• Menyampaikan presentasi dan workshop

→ Jadilah diri sendiri: aset terbaik adalah keyakinan pada diri sendiri.

→ Undang orang untuk berkomunikasi

→ Siapkan materi yang bisa dibawa pulang peserta (takeaways)

→ Siapkan sesi Q&A dan kendalikan dengan baik

→ Jujur, dan sampaikan hanya yang benar: jangan menebak saat tidak tahu jawabannya

→ Lakukan komunikasi tindak lanjut setelah presentasi

• Tips presentasi: menjaga waktu dan hal lainnya

→ Bagaimana memasukkan semua ini ke dalam X menit

→ Less is More: mulai dari satu hal penting (insight, hasil riset, kondisi terkini X, fitur baru produk X). Apa yang ingin Anda buat orang ingat dari presentasi ini?

→ Presentasi Anda sangat penting hanya bagi Anda sendiri

✓ Presentasi Anda hanyalah salah satu dari banyak hal

✓ Presentasi Anda akan direkam dan menyebar ke mana-mana

✓ Orang tidak akan mengingat seluruh isi presentasi

✓ Orang tidak membutuhkan Anda untuk mendapatkan informasi itu. Informasi tersebut mudah ditemukan secara online

→ Rapikan informasi tambahan

→ Live coding? Hal-hal yang harus diwaspadai

→ Menghindari pertanyaan

→ Hal-hal yang sebaiknya dipangkas: slide daftar isi, informasi perusahaan, perkenalan pribadi, lelucon dan meme

→ Hal-hal yang bisa dijadikan filler saat presentasi: lokasi materi, cara menghubungi, rekan dan ahli lain yang bisa dihubungi selain saya..

→ Siapkan ringkasan presentasi

• Hal-hal yang sebaiknya tidak diucapkan di atas panggung dan alternatifnya

→ "Ini mudah": "Untuk melakukan ini, Anda hanya perlu melalui beberapa langkah", "Tool ini terdokumentasi dengan baik, jadi Anda juga bisa.."

→ "Bagi yang mungkin belum tahu, saya ulangi sebentar": "Dengan kata lain, X adalah..", "Seperti yang Anda tahu, X adalah..."

→ "Siapa pun bisa melakukannya": "Dengan cara ini, sisa pekerjaan akan jadi lebih menyenangkan" "Karena ini sangat efektif, cobalah dan beri tahu orang lain juga"

→ "X akan menyelesaikan masalah ini jadi jangan khawatir": "Karena X menyelesaikan masalah terkait Y, Anda bisa membuat Z"

"X dibuat untuk mempermudah Y, dan sudah digunakan di dunia nyata. Hasilnya juga menggembirakan"

→ "Seperti yang semua orang tahu": "Akhir-akhir ini ini banyak dibicarakan, dan dijelaskan dengan baik di X(link)"..

→ "Seperti yang kita pelajari di sekolah": "Ini adalah bagian dari kurikulum ilmu komputer, dan memang ada alasannya"

→ "Y (produk kami) jauh lebih baik daripada X (kompetitor).": "Begini cara melakukannya dengan X. Kami mengambil pendekatan berbeda, dan alasannya adalah sebagai berikut."

"Ada beberapa solusi untuk ini. Kami tahu bahwa X tidak memiliki beberapa fitur yang bisa membuatnya lebih efisien.."

→ "Ini bisa dilakukan hanya dengan beberapa baris kode": "Seperti yang Anda lihat, Anda bisa mulai dengan beberapa baris kode. Saya menyederhanakannya untuk ditunjukkan di sini, dan source code ada di X"

→ "Kalau ingin jadi expert/professional, lakukan X": "Kelebihan X adalah Y, sehingga menjadi tool profesional untuk digunakan.

→ Selain itu, tonton presentasi/video Anda sendiri lalu pikirkan, "Jika saya tidak tahu ini, bagaimana rasanya mendengar kalimat ini?", kemudian hapus atau ucapkan ulang bagian tersebut

• Menulis tulisan dan artikel yang bagus

→ Simple is not stupid: menulis agar mudah dipahami dan sederhana itu sangat sulit. Gunakan kata-kata yang mudah, istilah yang mudah dipahami audiens luas, dan kalimat yang ringkas

→ Sampaikan inti persoalannya. Jangan sugar-coat

→ Panjang tulisan itu penting. Tulisan teknis untuk online harus pendek dan langsung ke inti. Jika terlalu panjang, pecah menjadi beberapa tulisan

→ Tambahkan berbagai media terkait. Video, audio, slide, gambar, dll.

→ Strukturkan konten dengan heading bertingkat, dll.

→ Konten juga perlu memiliki masa berlaku.

→ Kutip materi lain untuk membuktikannya

→ Penulisan pre-emptive - buat produk Anda menarik perhatian developer. Yang melakukan "penjualan" adalah tim sales

• Menulis contoh kode yang unggul

→ Selesaikan masalah melalui contoh

→ Tunjukkan contoh yang benar-benar berjalan

→ Jelaskan environment yang dibutuhkan

→ Tulis kode yang bisa di-copy & paste

→ Sediakan unduhan contoh

→ Tulis contoh yang rapi dan cerdas

→ Hosting kode dan demo

✓ Version control adalah teman Anda

✓ Gunakan hosting otomatis

✓ Gunakan code sandbox

✓ Environment live coding

• Menyiapkan materi presentasi yang bagus

→ Pahami dengan jelas apa yang Anda ketahui

→ Mulai dari kontennya sendiri, bukan dari slide

→ Mulai menulis dalam format teks yang portabel

→ Tips cepat membuat materi presentasi: pecah bullet-bulletnya

→ Pilih dan siapkan tool presentasi yang baik untuk membawakan presentasi

✓ Harus bisa menyesuaikan baik 16:9 maupun 4:3

✓ Harus mudah memotong dan resize gambar

✓ Bisa memindahkan objek di layar dengan bebas

✓ Bisa dikendalikan dari jarak jauh

✓ Perpindahan ke materi presentasi lain harus mulus

✓ Mendukung layar penuh

✓ Bisa menampilkan elemen satu per satu

• Membuat slide presentasi yang bagus

→ Jangan merekam dalam bentuk ucapan, jelaskan dengan kalimat pendek/gambar/screenshot/grafik

→ Temukan dan gunakan gambar yang bagus

→ Buat contoh kode mudah dilihat

→ Tips memanfaatkan suara dan video

→ Gunakan animasi hanya di tempat yang diperlukan (jangan terlalu berkilau)

→ Ringkas - kalau bisa hanya membahas satu topik

→ Pertimbangkan audiens

→ Jika ada template perusahaan dan konferensi

→ Personalisasi dan internalisasi semua materi sebelum digunakan: jangan pakai ulang mentah-mentah materi dari orang lain

→ Bagikan dan nikmati

→ Tips presentasi tambahan

✓ Perkenalkan diri: mengapa saya orang yang tepat untuk membawakan ini, dan mengapa/apa yang ingin saya bicarakan

✓ Menggunakan humor: hati-hati agar tidak menyerang orang lain

✓ Buat kaitan dengan dunia nyata

✓ Atur kecepatan agar tidak terlalu cepat: jeda sejenak itu baik untuk audiens

✓ Hindari "Hello World"

✓ Jika memungkinkan gunakan materi presentasi baru. Perbarui ke versi terbaru

• Checklist untuk presentasi yang lebih mudah dipahami, mudah diakses, dan bisa ditindaklanjuti

→ Materi presentasi

✓ HTML/PPTX/PDF?

✓ Apakah kodenya ada online?

✓ Apakah video/audio tertanam bisa diputar lintas OS, dan juga saat offline?

→ Format

✓ Apakah media tertanam mendukung aksesibilitas? (caption, alt text, transkrip, dll.)

✓ Apakah ukuran font cukup besar?

✓ Apakah ukurannya sesuai konferensi? 16x9, 4x3

✓ Apakah kontrasnya cukup sehingga tetap terlihat meski proyektor bermasalah?

✓ Apakah ada margin aman jika proyektor memotong sebagian tampilan?

✓ Apakah perlu font pengganti saat presentasi di komputer selain milik Anda?

→ Konten

✓ Apakah ada isi yang ofensif atau bisa memicu orang?

✓ Apakah bisa dipahami tanpa latar belakang khusus?

✓ Istilah apa yang perlu diketahui penerjemah/juru bahasa sebelumnya?

✓ Jika hanya sebagian/sekeping slide yang dibagikan, apakah ada potensi disalahpahami?

✓ Apakah semua media dan materi sudah mencantumkan sumber serta hak cipta sudah diperiksa?

→ Pelacakan

✓ Apakah Anda bisa mengetahui siapa yang mengunduh materi presentasi?

✓ Apakah ada call-to-action di slide terakhir, dan link yang bisa diunduh?

→ Asuransi

✓ Apakah semua materi bisa diakses secara offline terlepas dari komputer yang dipakai? (termasuk materi presentasi/contoh/media semuanya di USB)

✓ Jika video/audio tidak berfungsi dengan baik, apakah ada materi penjelasan yang sudah disiapkan?

• Catat semua pekerjaan

→ Rekam semua presentasi dalam bentuk audio

→ Jika memungkinkan, rekam juga dalam bentuk video

→ Kumpulkan dan catat semua link yang digunakan dalam presentasi di satu tempat

→ Catat daftar semua konferensi yang pernah/sudah akan saya hadiri: termasuk slide/blog/link/link video

• Kenali dan gunakan web (social)

→ Temukan konten web yang bagus

→ Distribusikan ulang konten web: tulis blog, simpan di situs social bookmarking, gunakan di materi presentasi, kutip di mailing list atau forum, tweet tentangnya

✓ Selalu beri atribusi kepada pembuat asli

→ Perkenalkan diri Anda di web

→ Gunakan situs dan produk social web yang kuat: Flickr, YouTube, Vimeo, Archive.org, GitHub, LinkedIn, Facebook, Meetup, Twitter

→ Gunakan web sebagai repositori, kanal distribusi, dan alat cross-promotion

→ Beri petunjuk tentang produk, lakukan teasing, dan buka preview

→ Lacak efektivitas: tambahkan telemetry ke dokumen/blog, subscribe feed komentar, gunakan URL shortener yang bisa dilacak

→ Bangun jaringan

→ Buat atau ikuti newsletter

→ Buat atau ikuti podcast

• Bekerja di komputer saya

→ Peralatan: mikrofon eksternal, monitor, kamera, pencahayaan

→ Buat screencast dan screenshot

→ Streaming

→ Ikut percakapan online real-time

→ Hal-hal yang perlu diperhatikan dan tips saat mengikuti acara online real-time

• Tips merekam presentasi online saya

[xguru]

Judul versi sebelumnya adalah Developer Evangelist Handbook, tetapi belakangan ini kata Advocacy lebih sering digunakan daripada Evangelist/Evangelism, jadi hal itu saya refleksikan.

Ini juga merupakan buku yang dulu saya jadikan rujukan layaknya kitab saat bekerja sebagai developer evangelist pada 2010.

Penulisnya telah bekerja sebagai developer selama 20 tahun, dan selama sekitar 10 tahun terakhir merupakan veteran yang menjalankan pekerjaan ini di Yahoo, Mozilla, dan Microsoft.

Istilahnya memang beragam seperti Developer Advocate/Evangelist/Relations, tetapi saya rasa buku ini layak dijadikan referensi bagi semua yang menekuni pekerjaan terkait, serta para developer yang sering melakukan presentasi eksternal.

Dalam hal membuat materi presentasi, poin "jangan gunakan ulang tanpa personalisasi - Don't reuse without personalising" juga merupakan hal yang sangat saya tekankan.

Jika memakai gambar/diagram yang diambil dari tempat lain, sering kali ada bagian yang tidak cocok, dan tidak jarang orang yang mempresentasikan pun sebenarnya tidak sepenuhnya memahami diagram tersebut.

Sebisa mungkin, saya merekomendasikan untuk menggambarnya ulang sesuai interpretasi Anda sendiri dan menyesuaikannya dengan konsep materi presentasi Anda.

[sangkyoonnam]

Terima kasih atas rangkumannya yang bagus. Ungkapan personalisasi, jangan digunakan ulang - Don't reuse without personalising terasa terlalu harfiah, jadi dalam konteks yang Anda sampaikan, mungkin ungkapan seperti "internalisasi lalu gunakan ulang" akan lebih mudah dipahami.

[xguru]

Setelah saya tulis, ternyata memang begitu ya ^^; saya sudah sedikit mencerminkannya. Terima kasih

[sangkyoonnam]

@_@)b