Заметки о выпуске за январь 2019 г.
Автор этой публикации — Дэн Делимарски (Den Delimarsky), программный руководитель в подразделении по облачным технологиям и искусственному интеллекту.
Встречайте новые заметки о выпусках на docs.microsoft.com впервые в 2019 г. Корпорация Майкрософт с радостью сообщает, что продолжает совершенствовать возможности, а именно добавлять новые средства, улучшать содержимое и знакомиться с новыми участниками сообщества.
Участники сообщества
Наше сообщество — это двигатель множества улучшений в размещенной документации. Каждая статья, которую вы читаете на docs.microsoft.com, — это вклад в нашу всеобщую цель по предоставлению точных и качественных документов. Сотни людей посвящают часы работы, чтобы совершенствовать их для всех. В этом месяце хотелось бы рассказать о некоторых из этих людей в записи блога.
Если вы хотели бы внести свой вклад в содержимое документации, для начала ознакомьтесь с руководством для участников разработки портала.
Валерий Новицкий
Валерий также известен под псевдонимом 01binary на сайте GitHub. Он проделал великолепную работу над документацией ASP.NET Core, улучшив примеры кода безопасности. Разработчики используют эти примеры в качестве начальных точек для проектов и исследований, и теперь шаблоны стали более полными и надежными.
Дейв Брок (Dave Brock)
Дейв активно участвовал в разработке документации по ASP.NET Core. В течение всего нескольких месяцев он отправил более 10 различных запросов на вытягивание, чтобы сделать документацию точнее и удобнее для пользователей. Дейва можно найти в Twitter по имени пользователя @daveabrock.
Линн Парк (Lynn Park)
Линн — новый участник разработки документации. Недавно она выполнила слияние содержимого с документацией Entity Framework по своему первому запросу на вытягивание. Линн постоянный читатель docs.microsoft.com, но впервые решила внести свой вклад в сведения об этом решении с открытым кодом. Линн можно найти в Twitter.
Выпуски содержимого
По мере развития ассортимента предлагаемых продуктов корпорация Майкрософт всегда стремится обеспечивать пользователей новой и актуальной документацией. В этом месяце мы пополнили библиотеку содержимого docs.microsoft.comновыми документами по API Java для Cлужб мультимедиа Microsoft Azure, по API .NET для Windows Server 2019, по REST API для Azure Data Lake Storage 2-го поколения и обновили документацию по Cognitive Services QnA Maker для Python.
Компоненты
Расширение markdownlint для поддержки настраиваемой разметки Markdown в Документации
Один из самых популярных компонентов в Docs Authoring Pack для VS Code — это markdownlint от разработчика из Майкрософт Дэвида Энсона (David Anson). Это решение помогает участникам проверить, отвечает ли рекомендациям содержимое Markdown. markdownlint теперь предусматривает возможность расширяться. Команда разработки Документации приступила к добавлению настраиваемых правил для поддержки специальных расширений Markdown для роботы с Документацией. Эти правила устанавливаются в составе Docs Authoring Pack. Если вы пользуетесь этим пакетом, дополнительные действия по запуску анализа кода Markdown для Документации не нужны.
Скоро ожидаются новые настраиваемые возможности для анализа кода, упрощающие разработку содержимого для docs.microsoft.com, такие как проверка безопасности ссылок (https://) и синтаксический анализ кода для оповещений Документации, например синтаксиса [!NOTE].
Примечания
В течение этого года многим областям документации предстоит масса изменений. Чтобы быть в курсе новостей, подпишитесь на наш блог и учетную запись Twitter. Сообщайте свои идеи и предложения по любым функциям, открывая вопросы на сайте GitHub.