Заметки о выпуске за февраль 2018 г.

Автор этой записи — Дэн Фернандес (Dan Fernandez), старший директор подразделения Cloud + Enterprise.

Февраль подошел к концу, и настало время для очередной части заметок о выпуске docs.microsoft.com.

Новые выпуски документации

Недавно мы выпустили дополнительные материалы, которые помогут вам больше узнать о наших продуктах.

Мы продолжаем перенос материалов из MSDN на docs.microsoft.com. При этом мы обеспечиваем не только правильное перемещение, но и автоматическую переадресацию ссылок на новые материалы на сайте docs.microsoft.com. Если вы столкнетесь с неработающими ссылками, сообщите о них.

Новые функции и инструменты

Многие функции, реализованные в прошлом месяце, относились к внутренней инфраструктуре, например, мы повышаем стабильность и устойчивость служб, а также создаем новые конвейеры публикации для различных типов содержимого. Учитывая это, ниже описаны два ключевых нововведения.

Браузер API Python

Один из ключевых моментов при работе с документацией по API заключается в том, чтобы сделать ее комплексной и легко доступной. Нам известно, что браузер API .NET и браузер модуля PowerShell имели успех в сообществе, поэтому мы хотели упростить поиск API Python, предоставляемых корпорацией Майкрософт.

Недавно мы объявили о выпуске браузера API Python, который лучше всего подходит для поиска API от корпорации Майкрософт. Работаете ли вы с пакетом SDK Azure Python или Cognitive Toolkit, вы можете быстро найти нужные API, перейдя на страницу docs.microsoft.com/python/api.

Python API Browser in action

По мере увеличения числа предоставляемых нами API Python мы продолжим обновлять браузер API Python с помощью новых выпусков.

Отзывы о сайте на GitHub

Мы продолжаем воплощать в документации свое стремление к открытости и прозрачности. Мы рады, когда у сообщества есть возможность предоставлять подробные отзывы и предложения по улучшению работы с документацией. Поэтому мы перенесли свою систему комментариев, чтобы она основывалась исключительно на вопросах GitHub. Единственным компонентом, оказавшимся вне GitHub, были отзывы о сайте.

Ранее мы разместили все отзывы о сайте docs.microsoft.com в UserVoice, и на тот момент это было хорошим решением. Но в условиях повсеместного использования размещенных на GitHub документов мы хотели дать пользователям возможность оставлять отзывы там же, где шло обсуждение самого материала. Поэтому следующее решение было простым — переместить все отзывы о сайте на GitHub.

Add new issues on GitHub

Мы рассматриваем вопросы ежедневно, поэтому, поделившись мыслями, вы, вероятно, вскоре получите от нас сообщение. При этом точное состояние своего запроса вы можете узнать с помощью меток. Более того, теперь пользовательский интерфейс для вопросов GitHub позволяет вам узнать, какой руководитель программы будет отвечать за дальнейшее взаимодействие:

GitHub issue assigned to a docs PM

Выполняя переход, мы перенесли все открытые вопросы из UserVoice в GitHub, поэтому никакие ваши отзывы не были потеряны.

Примечания

На этот год запланировано еще много всего интересного, просто немного подождите!

А пока подпишитесь на наш блог и учетную запись Twitter, чтобы следить за новостями. Если у вас есть идеи или предложения по каким-либо функциям, откройте вопрос на GitHub.

Хотите улучшить условия труда для разработчиков? Присоединяйтесь к нашей команде!