Bagikan melalui

Pembaruan pada Migrasi MSDN dan TechNet ke docs.microsoft.com

Posting ini ditulis oleh Jeff Sandquist, Wakil Presiden Perusahaan, Hubungan Pengembang.

Hari ini, kami sangat senang untuk memberi Anda pembaruan penting tentang migrasi konten MSDN dan TechNet ke docs.microsoft.com. Posting blog ini mendokumentasikan beberapa langkah terakhir dari upaya seluruh perusahaan untuk meromahkan struktur konten, format dan infrastruktur yang mendasar, dan memusatkan dokumentasi teknis Microsoft di sekitar satu situs.

Dari MSDN dan TechNet ke docs.microsoft.com

Pada tahun 1992, Microsoft Developer Network lahir sebagai layanan langganan pelanggan untuk memberikan informasi teknis tentang pemrograman untuk Windows. Enam tahun kemudian, pada tahun 1998, situs MSDN Online diluncurkan, menghosting lebih dari 250.000 halaman konten.

Cuplikan layar MSDN Online pada tahun 1999

Saat itu, proses penerbitan terdiri dari pembuatan konten di Microsoft Word, mengonversinya menjadi HTML, dan menerbitkan melalui alat yang disebut pubwiz (Wizard Penerbitan). Selama lebih dari 20 tahun, proses ini mendukung rilis produk, layanan, dan pembaruan baru, menghasilkan 45 juta halaman konten teknis yang mengejutkan!

Ketika siklus rilis produk bergeser dari tahun ke bulan, permintaan untuk dokumentasi up-to-tanggal yang dapat diakses tumbuh. Sistem penerbitan diperlukan untuk mencocokkan kecepatan rekayasa, sehingga kami memutuskan untuk menemukan kembali cara kami mengelola dokumentasi di Microsoft di era cloud. Pada Bulan November 2015, anggota pendiri tim docs.microsoft.com - Dan Fernandez, Mary McHale, Carol Zeumault, dan Jeff Sandquist menulis dokumen bernama "A New Hope" (penghormatan kepada Star Wars Episode IV), yang menguraikan visi untuk situs baru. Ini termasuk sekumpulan prinsip panduan utama:

  • Dokumentasi teknis terpadu. Situs baru harus mengonsolidasikan puluhan situs web dokumentasi yang dihosting oleh Microsoft. Pengembang yang mempelajari cara membuat aplikasi web berbasis data hanya perlu mengunjungi satu situs untuk menemukan semua konten yang relevan di ASP.NET, Azure, Entity Framework, atau teknologi Microsoft lainnya.
  • Peningkatan pengalaman pengguna. Faktor utama dalam menentukan keberhasilan situs web adalah pengalaman yang diberikannya kepada pelanggannya. Situs baru harus memiliki performa pemuatan yang lebih baik, font yang dapat dibaca, daftar isi yang dapat diakses, URL yang dapat dibaca manusia, dukungan untuk penerapan versi, kompatibilitas dengan browser seluler, dan mengikuti praktik desain inklusif melalui fitur yang dapat diakses dan dukungan untuk internasionalisasi.
  • Demokratisasi penulisan dan keterlibatan komunitas. Situs baru harus didukung oleh standar dan alat sumber terbuka, yang memberdayakan siapa pun untuk membuat dan mengedit dokumentasi. Ini harus menggunakan Markdown untuk konten, YAML untuk dokumentasi API yang dihasilkan secara otomatis dan mengandalkan GitHub sebagai lapisan konten yang mendasar, yang akan memungkinkan penggunaan pemeriksaan kualitas otomatis. Organisasi MicrosoftDocs GitHub telah berkembang menjadi lebih dari 7.400 anggota, dan repositori dokumentasi Azure adalah salah satu proyek sumber terbuka dengan pertumbuhan tercepat (470% tahun ke tahun) dan yang ke-5 paling berkontribusi untuk repositori di semua GitHub, seperti yang terlihat di Negara Bagian Octoverse 2018!
  • dokumentasi API Dukungan . Situs baru harus memiliki dukungan kelas satu untuk dokumentasi API yang ditulis untuk bahasa pemrograman dan platform yang digunakan pelanggan kami termasuk .NET, Java, Python, JavaScript dan TypeScript , PowerShell, Azure CLI, Q#, OpenAPI dan banyak lagi. Pengalaman harus didukung oleh otomatisasi, memiliki cakupan API yang andal dan dapat menerbitkan dokumentasi API dalam hitungan menit daripada minggu.
  • Memodernisasi infrastruktur rekayasa. docs.microsoft.com harus berjalan di Azure, memungkinkan kami mengurangi biaya pemeliharaan (lebih dari $7MMyang disimpan ), meningkatkan waktu penyebaran dari setiap tiga minggu menjadi harian (ataulebih cepat ) dan mengurangi duplikasi rekayasa.
  • Dapat Diperluas secara default. Seiring berkembangnya situs, situs harus dapat memenuhi kebutuhan pelanggan kami dengan cara yang paling efisien. Dengan membuat komitmen ini, kami dapat membangun dan mengintegrasikan pengalaman pembelajaran interaktif baru - Microsoft Learn, serta browser kode sampel kami.

Dengan platform modern di tempat, kami berangkat untuk memastikan bahwa kami tidak kehilangan konten berharga dengan memigrasikannya ke situs baru. Di bawah ini Anda akan menemukan informasi lebih lanjut tentang kemajuan kami.

Pustaka MSDN dan TechNet

Status: ✅ Selesai

Kami memulai migrasi Pustaka MSDN dan TechNet Library ke docs.microsoft.com pada akhir 2017, dan menyelesaikan migrasi tahun ini.

Pustaka yang sebelumnya menyediakan dokumentasi untuk produk Microsoft, termasuk dokumentasi API, kode sampel, dan artikel teknis. Awalnya tersedia melalui CD, konten kemudian dipindahkan secara online dengan peluncuran situs web MSDN dan TechNet.

Migrasi memerlukan konversi berbagai format berbasis XML ke Markdown untuk konten yang diedit manusia dan YAML untuk dokumentasi API yang dihasilkan secara otomatis, mencakup lebih dari seratus berbagai kumpulan konten. Kami telah memastikan bahwa pengalihan halaman tersedia untuk jutaan halaman web, mencegah tautan rusak yang dirujuk di luar situs kami, seperti blog dan forum.

Untuk memberi Anda sekilas volume konten yang kami kerjakan, berikut adalah beberapa statistik:

Jika Anda telah menandai konten MSDN atau TechNet apa pun, tautan akan dialihkan dengan mulus ke lokasi baru mereka di docs.microsoft.com.

Majalah MSDN

Status: ✅ Selesai

Edisi terakhir MSDN Magazine diterbitkan pada 1 November 2019. Kami mengirim pesan akhir kepada pembaca dan penulis dalam edisi Agustus MSDN Magazine.

Konten MSDN Magazine yang diterbitkan di MSDN telah dipindahkan ke learn.microsoft.com/archive.

Pelanggan MSDN Magazine yang membayar langganan mereka akan menerima pengembalian dana prorata, berdasarkan waktu yang tersisa pada langganan mereka. Pemeriksaan pengembalian dana akan dikirimkan setelah masalah November diterbitkan. Perubahan ini tidak berdampak pada Langganan Platform MSDN.

Microsoft Developer dan TechNet Flash Newsletters

Status: ✅ Selesai

Buletin yang diterbitkan di MSDN dan TechNet telah dipindahkan ke docs.microsoft.com/archive.

Pelanggan saat ini akan terus menerima buletin ini. Kami dapat mengembangkan dan mengubah format serta jadwal publikasi.

Jika Anda tidak lagi ingin berlangganan buletin kami, Anda dapat berhenti berlangganan dari email berikutnya yang Anda terima.

Blog MSDN dan TechNet

Status: ✅ Selesai

Kami telah membuat Blog MSDN dan Blog TechNet situs baca-saja pada Juli 2019. Blog MSDN dan TechNet telah dimigrasikan dan diarsipkan ke docs.microsoft.com/archive.

Jika Anda telah menandai blog MSDN atau TechNet apa pun, tautan ke blog tersebut akan dialihkan ke lokasi baru di docs.microsoft.com/archive, atau ke situs blog lain jika mereka secara aktif dikelola dan diperbarui blog.

Status: ✅ Selesai

Kami telah mengalihkan semua halaman Galeri Kode MSDN ke browser sampel dan sampel kunci yang diarsipkan ke GitHub di organisasi MicrosoftArchive. Baca selengkapnya tentang proses ini di posting blog terbaru kami.

Anda dapat menemukan sampel kode tanggal -up-topaling up-todi docs.microsoft.com/samples.

Status: 🚧 Sedang Berlangsung

TechNet Gallery akan dihentikan pada awal 2020. Pada bulan Desember 2019, situs ini akan dibuat baca-saja tidak lagi menerima kontribusi komunitas baru. Pengumuman dan informasi tambahan yang harus diikuti.

Gunakan docs.microsoft.com/samples untuk menemukan sampel kode tanggal up-topaling banyak. Jika sebelumnya Anda telah berkontribusi pada Galeri TechNet, pastikan Anda memigrasikan sampel ke lokasi yang dikelola secara pribadi, seperti repositori github Anda sendiri.

TechNet Wiki

Status: 🚧 Sedang Berlangsung

Kami sedang mengerjakan rencana dan jadwal migrasi yang lebih konkret untuk TechNet Wiki. Silakan periksa kembali nanti untuk detail tambahan. Anda dapat terus berpartisipasi dan berinteraksi dengan konten wiki saat ini.

Forum MSDN dan TechNet

Status: 🚧 Sedang Berlangsung

Kami mengumumkan rilis pratinjau Microsoft Q&A, yang menggantikan forum MSDN dan TechNet. Untuk memastikan transisi yang lancar dan meminimalkan gangguan, kami telah memecah migrasi menjadi beberapa fase. Kami berharap untuk menyelesaikan migrasi pada pertengahan 2020. Silakan periksa kembali nanti untuk detail tambahan.

Saluran 9

Status: 🚧 Sedang Berlangsung

Channel 9 terus menjadi investasi penting untuk konten video yang berfokus pada pengembang. Kami sedang mengerjakan jalur migrasi yang akan mengintegrasikan video dan konten teknis kami dengan lebih baik dari Channel 9. Silakan periksa kembali nanti untuk detail tambahan.

Kami ingin mendengar dari Anda

Kami sangat senang untuk terus berinvestasi di platform kami dan memastikan bahwa Anda mendapatkan dokumentasi teknis yang paling relevan dan andal untuk seluruh ekosistem Microsoft. Beri kami saran peningkatan dan pemikiran Anda tentang GitHub dan Twitter.