Memperkenalkan docs.microsoft.com

Postingan ini ditulis oleh Jeff Sandquist, General Manager di Divisi Cloud + Enterprise.

Hari ini kami mengumumkan rilis pratinjau layanan https://docs.microsoft.comdokumentasi baru kami, menampilkan konten yang mendukung produk Enterprise Mobility kami.

Mengapa docs.microsoft.com?

Singkatnya, konten penting. Kami mewawancarai dan mensurvei ratusan pengembang dan Profesional TI dan menyaring umpan balik situs web Anda selama bertahun-tahun di UserVoice. Jelas bahwa kami perlu membuat perubahan dan menciptakan pengalaman web modern untuk konten. Hal pertama yang kami lakukan adalah mengevaluasi infrastruktur konten kami yang ada TechNet dan MSDN. Kedua situs dibangun di atas basis kode rapuh berusia 10-15 tahun dengan sistem penerbitan dan penyebaran arkea yang tidak pernah dirancang untuk berjalan di cloud.

Fokus kami tidak hanya pada pengalaman, tetapi juga pada konten yang kami buat dan bagaimana masing-masing dari Anda menggunakannya. Selama bertahun-tahun pelanggan telah memberi tahu kami untuk melampaui dinding teks dengan konten tingkat fitur dan membantu mereka menerapkan solusi untuk masalah bisnis mereka. Kami tahu bahwa konten yang kami kirimkan dan platform yang kami bangun harus memudahkan pelanggan untuk mempelajari dan menyebarkan solusi.

Kami menyadari bahwa untuk mendapatkan pengalaman keseluruhan yang kami butuhkan untuk memulai dari awal; dari upaya ini datang https://docs.microsoft.com - harapan baru untuk dokumentasi di Microsoft.

Catatan: Rilis pratinjau situs web ini mencakup konten *hanya* untuk Dokumentasi Mobilitas Perusahaan (yang terdiri dari Analitik Ancaman Tingkat Lanjut, Azure Active Directory, Aplikasi Jarak Jauh Azure, Autentikasi Multifaktor, Manajemen Hak Azure, Intune, dan Microsoft Identity Manager). Di masa depan, saat platform kami matang dengan bantuan umpan balik Anda, kami akan memigrasikan lebih banyak dokumentasi kami ke pengalaman ini.

Fitur Utama

Mari kita mulai dengan contoh halaman dokumentasi yang ditunjukkan di bawah ini dan kita akan menampilkan beberapa fitur baru di situs.

Mudah dibaca

Untuk meningkatkan keterbacaan konten, kami mengubah situs agar memiliki lebar isi yang ditetapkan. Studi pelacakan mata telah menunjukkan bahwa Anda dapat meningkatkan pemahaman dan kecepatan membaca dengan lebar konten yang ditetapkan karena sulit bagi mata untuk mengikuti bagian panjang kiri-ke-kanan. Untuk menampilkan tindakan ini, di bawah ini adalah contoh artikel Intune yang berjalan di docs.microsoft.com diikuti oleh artikel yang sama di TechNet. Kami juga telah meningkatkan ukuran font untuk navigasi kiri dan teks itu sendiri, sesuatu yang diminta pelanggan (UserVoice - Meningkatkan ukuran Font).

Estimasi Waktu Membaca

Peningkatan sederhana lainnya yang telah kami buat berdasarkan input Anda adalah memberikan perkiraan waktu membaca untuk artikel. Kami tahu banyak dari Anda belajar/mengevaluasi teknologi beberapa menit antara rapat dan Anda lebih mungkin membaca artikel jika Anda tahu berapa banyak komitmen waktu yang diperlukan. Kami juga menambahkan stempel tanggal ke konten untuk membantu pelanggan memahami seberapa segar informasi tersebut berdasarkan umpan balik UserVoice .

Navigasi Isi dan Situs

Salah satu area utama investasi berdasarkan wawancara pelanggan dan umpan balik UserVoice adalah peningkatan navigasi situs, arsitektur informasi, dan organisasi konten berdasarkan niat pelanggan. Kami merefaktor konten kami ke dalam pengelompokan logis sekeliling mengevaluasi, memulai, merencanakan, menyebarkan, mengelola, atau memecahkan masalah produk atau layanan. Anda dapat melihat konten ini dipecah di navigasi kiri dan halaman produk/layanan kami.

Di bawah ini adalah cuplikan layar halaman beranda dokumentasi Intune:

Kategorisasi yang sama ini juga ada di navigasi kiri artikel:

Panjang Artikel Dipersingkat

Bagian lain dari umpan balik umum adalah bahwa konten kami kadang-kadang dapat luar biasa karena panjangnya dan bahwa artikel panjang lebih sulit untuk dinavigasi dan menemukan apa yang Anda cari. Untuk mengatasi hal ini, kami telah memecah artikel yang lebih panjang menjadi langkah-langkah logis yang lebih kecil dan menyediakan tombol Sebelumnya dan Berikutnya di bagian bawah artikel untuk menavigasi di antara langkah-langkah dalam tutorial multi-bagian seperti yang ditunjukkan di bawah ini.

Meskipun banyak pelanggan menyukai kemampuan untuk memiliki tutorial multi-bagian, kami juga mendengar dari pelanggan yang menginginkan kemampuan untuk menggabungkan tutorial multi-langkah menjadi PDF tunggal yang ramah printer offline. Kami belum memiliki ini, tetapi akan segera hadir ke pratinjau.

Desain yang Responsif

Untuk membangun pengalaman hebat di perangkat seluler, tablet, dan PC seperti yang Anda minta di UserVoice, kami beralih ke tata letak responsif. Mengklik tombol Opsi akan memperluas/menciutkan untuk menampilkan opsi yang sama pada tampilan desktop.

Kontribusi Komunitas

Semua dokumentasi tentang docs.microsoft.com bersumber terbuka dan dirancang untuk memungkinkan kontribusi komunitas. Ini mengikuti jejak tim lain di Microsoft yang telah membuka sumber semua atau bagian dokumentasi mereka termasuk ASP.NET, Azure, .NET Core, dan Microsoft Graph.

Setiap artikel memiliki tombol Edit (ditunjukkan di bawah) yang membawa Anda ke file Markdown sumber di GitHub tempat Anda dapat dengan mudah mengirimkan permintaan pull untuk memperbaiki atau meningkatkan konten.

Mekanisme Umpan Balik

Pertanyaan, komentar, dan umpan balik Anda penting untuk kami. Kami telah bermitra dengan [Livefyre](https://web.livefyre.com/) untuk memberikan komentar dan Catatan Samping di semua artikel kami. Di bagian atas setiap artikel, Anda akan melihat tautan untuk komentar seperti yang ditunjukkan di bawah ini.

Mengklik komentar akan membawa Anda ke bagian bawah halaman tempat Anda dapat masuk (menggunakan kredensial Twitter, Facebook, Google, Yahoo, atau Microsoft) untuk menambahkan, mengikuti, atau menyukai komentar.

Anda juga bisa menambahkan Catatan Samping atau catatan pada setiap paragraf konten atau teks yang disorot secara khusus. Untuk melakukannya, dengan kursor mouse pada simbol komentar di sebelah kanan, klik untuk menambahkan komentar sebaris.

Berbagi di Media Sosial

Tombol berbagi di bagian atas halaman memungkinkan Anda berbagi dengan mudah dengan Twitter dan Facebook.

Anda juga dapat menggunakan kursor mouse untuk memilih konten pada artikel untuk menambahkan komentar atau berbagi di Twitter atau Facebook langsung dari menu konteks seperti yang ditunjukkan di bawah ini.

URL ramah

Kami peduli dengan pengalaman web kami, dan satu hal yang sering mengganggu kami sebagai pengguna TechNet dan MSDN adalah bahwa artikel tersebut tidak memiliki URL yang ramah dan dapat dibaca. Berikut adalah contoh artikel yang sama dengan URL baru kami.

• Sebelum:<https://technet.microsoft.com/library/dn646983.aspx>

• Setelah:<https://docs.microsoft.com/intune/get-started/start-with-a-paid-subscription-to-microsoft-intune>

Tema situs web

Kami juga menambahkan pemilih tema ke artikel sehingga Anda dapat mengubah antara tema terang dan gelap, sesuatu yang beberapa dari Anda minta di UserVoice.

Gambar di bawah ini menunjukkan perbedaan antara tema terang dan gelap.

Fundamental

Dasar-dasar seperti performa situs adalah fitur utama dan sesuatu yang banyak pelanggan telah meminta kami untuk meningkatkan userVoice. Waktu pemuatan halaman pada docs.microsoft.com antara 50-300% lebih cepat dalam hal waktu muat dan kami didistribusikan secara geografis lebih baik daripada sebelumnya. Kami juga telah membangun arsitektur yang berjalan 100% di Azure.

Kami ingin umpan balik Anda!

Kami harap Anda menikmati versi pratinjau docs.microsoft.com dan silakan kirimi kami umpan balik Anda ke https://aka.ms/sitefeedback. Di postingan mendatang, kami akan membahas rencana kami untuk secara dramatis meningkatkan pengalaman untuk konten referensi dan rencana kami untuk pelokalan konten.