Pembaruan november untuk docs.microsoft.com
Postingan ini ditulis oleh Jeff Sandquist, General Manager di Divisi Cloud + Enterprise.
Hari ini kami dengan bangga mengumumkan bahwa sekarang kami telah melakukan migrasi dokumentasi untuk Azure, Visual Studio 2017 RC, C++, ASP.NET Core, Entity Framework Core dan SQL di Linux to docs.microsoft.com!
Membawa semua konten kami bersama-sama, akan mendorong konsistensi pengalaman bagi pelanggan kami, untuk dukungan seluler, pelokalan, komentar, berbagi di media sosial, atau kontribusi komunitas.
Meskipun ini adalah rilis besar, kami akan terus memperbarui konten dan fitur situs ini secara berkala, jadi pastikan untuk mengirimkan masukan UserVoice pada pengalaman konten.
Anda juga dapat menantikan tambahan konten untuk Dynamics 365, Windows Server, SQL Server, System Center dan desktop Windows dalam beberapa bulan mendatang.
- Fitur Utama Dokumen
- Fitur Dokumen Baru
- Dokumentasi Azure
- Dokumentasi Visual Studio 2017 RC
- Dokumentasi CC+
- Dokumentasi ASP.NET
- Dokumentasi Entity Framework Core
- Dokumentasi SQL di Linux
Bagi Anda yang belum mengetahui docs.microsoft.com, inilah beberapa fitur utama dari pengalaman baru kami.
Penyempurnaan sederhana yang kami buat berdasarkan input Anda memberikan perkiraan waktu membaca untuk artikel. Kami tahu banyak dari Anda belajar dan mengevaluasi teknologi selama beberapa menit antara rapat dan Anda lebih mungkin membaca artikel jika Anda tahu berapa banyak komitmen waktu yang diperlukan.
Kami juga menambahkan stempel waktu konten untuk membantu pelanggan memahami bahwa ini merupakan konten baru - Anda tidak perlu lagi menebak kapan terakhir kali artikel diperbarui.
Untuk membangun pengalaman hebat pada perangkat seluler, tablet, dan PC, kami menerapkan tata letak yang responsif. Mengeklik tombol Opsi di bagian atas halaman pada perangkat layar kecil akan memungkinkan Anda mengakses opsi yang sama dengan di browser desktop.
Kami telah berulangkali mendengar dari pelanggan internasional mengenai pentingnya konten lokal. docs.microsoft.com saat ini mendukung 45 bahasa, termasuk cara baca dari kanan ke kiri, seperti bahasa Arab dan Ibrani, serta 63 lokal secara keseluruhan untuk konten Dynamics 365 dengan logika fallback dimana dokumen lokal mungkin tidak tersedia. Ini membuat dokumen kami benar-benar global, dan siap untuk konten tambahan di tahun baru.
Pertanyaan, komentar, dan umpan balik Anda penting untuk kami. Kami telah bermitra dengan Livefyre untuk memberikan komentar dan catatan samping di semua artikel kami. Di bagian atas setiap artikel, Anda akan melihat opsi untuk melompat langsung ke bagian komentar.
Kami ingin mendengar dari Anda dan kami berkomitmen untuk memantau dan menanggapi semua komentar dan pertanyaan yang tersisa di halaman Dokumen.
Untuk berkomentar, Anda dapat masuk menggunakan kredensial Twitter, Facebook, Google, Yahoo, atau Microsoft yang sudah ada.
Selain itu, Anda akan dapat mengikuti utas tempat Anda mengharapkan tindak lanjut - selalu mengetahui kapan salah satu tim atau anggota komunitas kami telah merespons Anda.
Anda juga dapat menambahkan catatan samping pada setiap paragraf konten atau teks yang disorot secara khusus. Untuk melakukannya, cukup pilih potongan teks dengan kursor mouse atau klik ikon komentar yang muncul di sisi kanan paragraf saat Anda mengarahkan kursor ke atasnya.
Tombol berbagi pada bagian atas halaman memungkinkan Anda membagikan konten dengan mudah kepada pengikut di Twitter dan teman Facebook Anda.
Anda juga dapat memilih konten secara langsung dengan mouse untuk membagikannya melalui widget kontekstual.
Kami juga menambahkan pemilih tema sehingga Anda dapat mengubah antara tema terang dan gelap, sesuatu yang beberapa dari Anda miliki [asked for on UserVoice](https://msdocs.uservoice.com/forums/364242-general-site-feedback/suggestions/14999211-komplete-dark-theme)
.
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.
https://technet.microsoft.com/library/dn646983.aspx3
https://docs.microsoft.com/intune/get-started/start-with-a-paid-subscription-to-microsoft-intune
Sebagian besar dokumen di situs kami dimungkinkan untuk kontribusi komunitas. Cukup klik pada tombol Edit di menu kanan atas untuk membuka halaman GitHub terkait, klik garpu pada repo, buat perubahan, dan kirimkan permintaan tarik Anda. Kami menerima pengeditan konten lokal dan juga masukan atas keseluruhan pengalaman kontribusi!
Meskipun banyak dari fitur tersebut telah ada sejak hari peluncuran kami di bulan Mei , kami juga menambahkan sejumlah fitur baru seperti diuraikan di bawah ini.
Kami telah menambahkan Daftar Isi agar mudah difilter. Artinya, Anda dapat dengan mudah mengetik beberapa karakter saja untuk memfilter teks yang sesuai untuk menemukan konten dicari.
Fitur utama lainnya yang kami tambahkan adalah mengatasi masalah konten di beberapa situs. Apakah artikel tentang penerapan aplikasi ASP.NET ke Azure App Service harus tercantum di bawah Azure atau ASP.NET? Jawabannya adalah keduanya, namun tanpa duplikasi konten di kedua bagian situs dengan alasan mudah dikenali dan konsistensi.
Untuk melakukan ini, kami membentuk tim konten untuk memilih konten apa pun di dokumen, dan membuat tampilan konten tersebut untuk pelanggan. Gambar di bawah ini menunjukkan kemungkinan tata letak hipotetis untuk .NET Developers menggunakan Docker yang memungkinkan konten dikirim dari Azure, ASP.NET, .NET Core, dan tim Visual Studio Azure SDK - semua dalam satu tampilan.
Salah satu fitur dokumentasi yang paling menyebalkan adalah ketika sampel yang disajikan atau ditautkan namun tidak berfungsi pada komputer Anda. Di Microsoft, kami memiliki ribuan contoh dan potongan kode, dan kami ingin memastikan bahwa pelanggan dapat memercayai sampel tersebut berfungsi pada platform dan konfigurasi yang didukung.
Untuk melakukannya, kami telah mengembangkan sistem Integrasi Berkelanjutan atau Continuous Integration (CI) yang dapat diperluas, untuk memastikan sampel disusun dan menghasilkan output yang diharapkan untuk rangkaian sistem operasi dan alat bantu yang ada. Selagi kami bekerja untuk menambahkan lebih banyak tim dalam hal ini, kami ingin memastikan bahwa pengguna yang mengunduh kode kami percaya bahwa kode ini telah melalui semua pemeriksaan kualitas yang diperlukan.
Kami telah mendesain ulang dasar mesin DocFX , komponen sumber terbuka yang mendayai docs.microsoft.com , untuk meliputi pengikatan bahasa untuk berbagai platform dan format. Ini meliputi dukungan untuk:
- Azure CLI (Python)
- PowerShell
- .NET and .NET Core
- Java
- Swagger / REST APIs
Artinya bagi pelanggan adalah bahwa dokumentasi seharusnya tidak lagi cenderung tidak selaras dengan kemampuan API, karena sekarang ada satu sumber tepercaya yang mendorong dokumentasi dan kode. Anda dapat membaca lebih lanjut tentang dukungan khusus untuk referensi API di bagian Azure dan ASP.NET/EF di bawah ini.
Fitur utama lain yang diminta pelanggan adalah dukungan PDF - Anda dapat mengunduh sekumpulan dokumen tertentu tanpa memerlukan ruang besar, dan membawanya ke manapun, baik menggunakan perangkat desktop atau seluler.
Untuk mengaktifkannya, kami telah mengaktifkan dukungan PDF untuk tabel konten kami. Kami memastikan bahwa file PDF telah diperbarui ketika konten diperbarui di situs secara langsung, sehingga Anda selalu mendapatkan konten terbaru dan terbaik dari konten kami.
<img alt="screenshot16]()
Kami telah mendengar umpan balik Anda tentang fragmentasi dan tantangan dengan pengalaman, jadi kami berada dalam perjalanan kami untuk memigrasikan dokumentasi teknis Azure kami dari azure.microsoft.com, MSDN, dan GitHub dan mengonsolidasikannya di https://docs.microsoft.com/azure/.
Kami juga telah berkesempatan untuk mengubah tampilan dan nuansa halaman arahan untuk konten Azure. Beberapa sorotan utama meliputi:
- Tab Layanan yang mengelompokkan layanan Azure menurut kategori.
- Tab Developer yang mendaftar semua konten Azure Reference untuk REST API, Azure .NET SDK, Azure Java SDK, Azure CLI dan Azure PowerShell.
- Tab Architecture untuk arsitek dan pengembang, untuk mempelajari pola desain skala cloud.
Kami memastikan halaman arahan kami konsisten dan terhubung ke sumber daya utama termasuk:
- Tautan Ikhtisar Layanan.
- Tutorial Memulai untuk semua platform dan bahasa pemrograman terkait.
- Tautan ke semua video tutorial untuk layanan yang disediakan.
- Tautan ke konten referensi API.
- Tautan untuk mengunduh semua dokumentasi untuk layanan tersebut.
Saat kami beralih ke docs.microsoft.com/azure, kami memanfaatkan kesempatan ini untuk meningkatkan konsistensi pada navigasi Daftar Isi. Sementara setiap layanan memiliki karakteristik unik, Anda sekarang akan melihat navigasi serupa saat Anda menjelajahi situs.
Untuk contoh kode yang mewakili Azure Command Line Interface (CLI), kami menambahkan warna untuk kata kunci dan parameter sehingga memudahkan Anda membaca dan memahami kode kami.
Salah satu poin masukan terbesar yang kami dapatkan adalah konten API, command-line, dan PowerShell kami tidak pernah diperbarui. Secepat perubahan Azure, panduan lama alur kerja kami tidak berfungsi.
Untuk rilis ini, kami telah mengubah sistem untuk membuat referensi langsung dari kode sumber. Saat build baru tersedia, konten baru juga akan dikirimkan. Selain Anda dapat berkontribusi pada konten Cara, Anda juga dapat melakukan hal yang sama di bagian dokumentasi yang dibuat secara otomatis.
Kami juga melakukan standarisasi penggunaan Spesifikasi API Terbuka (sebelumnya Swagger) untuk mendeskripsikan REST API kami, yang sekarang akan memberi kami representasi data konsisten untuk layanan REST yang dapat digunakan untuk dokumentasi sekaligus SDK klien. Di masa mendatang, kami juga dapat menambahkan fitur interaktif ke dokumentasi REST dan permintaan contoh/payload respons.
Untuk rilis ini kami menyediakan:
Kami mengenalkan semua dokumentasi Visual Studio yang terintegrasi langsung dengan pengalaman docs.microsoft.com baru dan diperbarui.
Halaman Visual Studio Hub menyertakan tautan utama untuk memulai dengan Release Candidate Visual Studio 2017.
Ini meliputi Panduan Penginstalan, Apa yang Baru, dan tutorial Memulai. Konten lokal akan segera hadir. Konten baru akan tersedia untuk topik seperti refactoring, bekerja dengan kode yang tidak ada dalam proyek, masalah kinerja penelusuran kesalah, kiat untuk mengoptimalkan waktu mulai Visual Studio, perrincian semua fitur produktivitas dan kode navigasi baru di editor, serta banyak lagi .
Sekarang Visual Studio mendukung proses penginstalan yang dapat disesuaikan sepenuhnya, di mana Anda hanya mendapatkan komponen yang ingin digunakan, Anda dapat mempelajari lebih lanjut tentang cara kerjanya untuk proyek pengembangan individual Anda, terlepas dari apakah beban kerja Anda melibatkan platform ASP.NET, Azure, Python, atau Windows.
Dokumentasi ASP.NET dan Entity Framework Core juga dimigrasikan dari docs.asp.net dan GitHub.
Karena Core ASP.NET dan Entity Framework Core adalah proyek sumber terbuka, kami telah mengintegrasikan secara mendalam kode sumber dan komentar triple-slash untuk membuat dokumentasi referensi API masing-masing. Artinya, API dan dokumentasi akan selalu sinkron, otomatis.
Sebagai tanggapan atas permintaan lama dari pelanggan, kami telah melakukan produksi ulang referensi C ++ ke dalam format lebih ringkas yang memerlukan lebih sedikit hubungan antar topik. Sekarang, Anda dapat menemukan semua dokumen untuk anggota kelas dalam topik yang sama dengan kelas.
Selain itu, pelajari lebih lanjut tentang perubahan kesesuaian standar C++ terbaru, dan opsi build baru seperti /fastlink
, gunakan panduan porting baru untuk meningkatkan kode Anda dari versi Visual Studio sebelumnya, dan temukan cara mencoba dukungan baru untuk membangun Sistem Linux dengan gcc
!
SQL Server di Linux (bagian dari SQL Server vNext Customer Technical Preview 1) telah tersedia dan siap untuk Anda coba! Halaman Hub meliputi tautan utama yang membawa Anda mulai dari pengelolaan dan pengembangan dengan SQL Server di Linux. Konten lokal segera hadir.
Kami sangat ingin menyediakan lebih banyak fitur ke situs dokumentasi baru, dan memastikan bahwa pengalaman tersebut konsisten dengan produk dan layanan kami. Karena Anda, pengguna, adalah bagian paling penting dalam proses dokumentasi, kami mendorong Anda untuk menjangkau kami dan memberikan umpan balik tentang bagaimana kami dapat membuat pengalaman ini lebih baik untuk Anda di Twitter.