Microsoft Docs
| Microsoft Docs | |
|---|---|
| Тип | База знаний |
| Владелец | Microsoft |
| Регистрация | необязательная |
| Языки | многоязычный |
| Текущий статус | работает |
| Коммерческий | да |
| Сайт | docs.microsoft.com |
Microsoft Docs — библиотека технической документации для конечных пользователей, разработчиков и IT-специалистов, работающих с продуктами Microsoft. Сайт Microsoft Docs содержит технические спецификации, статьи, руководства, обучающие материалы, справочники по API, примеры кода и другую информацию, относящуюся к программным продуктам и веб-сервисам Microsoft. Microsoft Docs был запущен в 2016 году и должен был стать заменой библиотек MSDN и TechNet, на которых ранее размещались подобные материалы.
Структура и возможности
Материалы на сайте сгруппированы по продуктам и технологиям, к которым они относятся, а также по этапам работы с ними: начало работы, планирование, развертывание, управление, диагностика и устранение неполадок и др. Панели навигации и страницы продуктов и служб показывают разбивку материалов по этим принципам. Для статей отображается приблизительное время, необходимое для прочтения. Имеется возможность загрузки целых разделов документации в виде PDF-файлов для чтения в автономном режиме. Большая часть материалов имеют открытый исходный код и у пользователей имеется возможность отправить предложение по внесению изменений в них. Каждая статья представлена файлом с разметкой Markdown в репозитории на GitHub.
Программное обеспечение для редакторов
Microsoft выпустили пакет расширений Visual Studio Code — Docs Authoring Pack, призванный облегчить редактирование статей на Microsoft Docs. В его состав входят: Docs Markdown — утилита для редактирования Markdown с поддержкой форматирования, создания списков и таблиц, вставки ссылок и изображений. В отличие от других редакторов, Docs Markdown поддерживает нестандартные расширения Markdown для docs.microsoft.com, например примечания и фрагменты кода. DocFX — средство предварительного просмотра с ограниченной поддержкой специфичных для docs.microsoft.com элементов Markdown. markdownlint — средство анализа разметки Markdown на соответствие стандартам и общепринятым соглашениям о стиле.
История
Предварительная версия Microsoft Docs была запущена в июне 2016 г., изначально она содержала только документацию по.NET.. Процесс переноса главный части материалов из библиотек MSDN и TechNet занял приблизительно два года. Ключевые события:
Ноябрь 2016: добавлена документация по Azure, Visual Studio 2017 RC, C++, ASP.NET Core, Entity Framework Core и SQL для Linux. Сентябрь 2017: документация по Office SharePoint, Windows 10, Windows Server 2016, и BizTalk Server ITPro перенесена с MSDN/TechNet. Февраль 2018: добавлена новая система отзывов, основанная на GitHub issues. Ноябрь 2018: техническая документация по OneDrive перенесена с TechNet на Microsoft Docs
См. также
Microsoft Developer Network Microsoft TechNet
Примечания
- https://books.google.ru/books?id=orkrDwAAQBAJ&pg=PA126&hl=ru&sa=X&ved=0ahUKEwjfpeDJov7gAhWS_CoKHTTVBHwQ6AEINDAB#v=onepage&q&f=false
- Mark J. Price: C# 7 and.NET Core: Modern Cross-Platform Development — https://books.google.ru/books?id=orkrDwAAQBAJ&pg=PA126&hl=ru&sa=X&ved=0ahUKEwjfpeDJov7gAhWS_CoKHTTVBHwQ6AEINDAB#v=onepage&q&f=false Packt Publishing Ltd, 2017, p. 126
- https://www.infoq.com/news/2016/05/docs-ms-com
- Jonathan Allen. MSDN/TechNet Being Replaced by Open Source Project docs.microsoft.com — https://www.infoq.com/news/2016/05/docs-ms-com Новости InfoQ
- Sergio Govoni. Microsoft Docs and Localization Community Platform — http://sqlblog.com/blogs/sergio_govoni/archive/2018/09/14/microsoft-docs-and-localization-community-platform.aspx
- http://sqlblog.com/blogs/sergio_govoni/archive/2018/09/14/microsoft-docs-and-localization-community-platform.aspx
- https://web.archive.org/web/20190318153610/http://sqlblog.com/blogs/sergio_govoni/archive/2018/09/14/microsoft-docs-and-localization-community-platform.aspx
- Introducing Microsoft Docs — https://docs.microsoft.com/en-us/teamblog/introducing-docs-microsoft-com
- https://docs.microsoft.com/en-us/teamblog/introducing-docs-microsoft-com
- https://web.archive.org/web/20190412172958/https://docs.microsoft.com/en-us/teamblog/introducing-docs-microsoft-com
- Microsoft Docs blog: Docs extension — https://docs.microsoft.com/en-us/teamblog/docs-extension
- https://docs.microsoft.com/en-us/teamblog/docs-extension
- https://web.archive.org/web/20180925221144/https://docs.microsoft.com/en-us/teamblog/docs-extension
- Chris Ward. DocFX: The Next Documentation Tool to Consider? — https://dzone.com/articles/docfx-the-next-documentation-tool-to-consider
- https://dzone.com/articles/docfx-the-next-documentation-tool-to-consider
- https://web.archive.org/web/20180414200235/https://dzone.com/articles/docfx-the-next-documentation-tool-to-consider
- Microsoft Docs November Update — https://docs.microsoft.com/en-us/teamblog/docs-november-update
- https://docs.microsoft.com/en-us/teamblog/docs-november-update
- https://web.archive.org/web/20190602191046/https://docs.microsoft.com/en-us/teamblog/docs-november-update
- Microsoft Docs September 2017 release notes — https://docs.microsoft.com/en-us/teamblog/september-release-notes
- https://docs.microsoft.com/en-us/teamblog/september-release-notes
- https://web.archive.org/web/20200316170826/https://docs.microsoft.com/en-us/teamblog/september-release-notes
- A New Feedback System Is Coming to docs.microsoft.com — https://docs.microsoft.com/en-us/teamblog/a-new-feedback-system-is-coming-to-docs
- https://docs.microsoft.com/en-us/teamblog/a-new-feedback-system-is-coming-to-docs
- https://web.archive.org/web/20190316233544/https://docs.microsoft.com/en-us/teamblog/a-new-feedback-system-is-coming-to-docs
- https://www.neowin.net/news/microsoft-is-moving-its-onedrive-technical-documentation-to-microsoft-docs/
- João Carrasqueira. Microsoft is moving its OneDrive technical documentation to Microsoft Docs — https://www.neowin.net/news/microsoft-is-moving-its-onedrive-technical-documentation-to-microsoft-docs/ Neowin News
Ссылки
- Microsoft Docs — https://docs.microsoft.com
- Docs Authoring Pack — https://marketplace.visualstudio.com/items?itemName=docsmsft.docs-authoring-pack
- Microsoft Docs
- Docs Authoring Pack — расширение VS Code для редактирования статей для Microsoft Docs