Max Home IndustryMicrosoft объявила о предварительном выпуске docs.microsoft.com, новой службы документации, которая заменит MSDN и TechNet.
В сообщении блога, объявляющем docs.microsoft.com, Джефф Сэндквист объясняет, что новая служба была разработана в ответ на отзывы на форуме Microsoft UserVoice. Он написал:
Было ясно, что нам нужно внести изменения и создать современный веб-интерфейс для контента. Первое, что мы сделали, — это оценили нашу существующую инфраструктуру контента TechNet и MSDN. Оба сайта построены на хрупкой кодовой базе 10-15-летней давности с архаичной системой публикации и развертывания, которая никогда не была предназначена для работы в облаке.
Он также заявляет:
В течение многих лет клиенты говорили нам выходить за рамки текстовых стен с помощью функционального контента и помогать им реализовывать решения их бизнес-проблем. Мы знали, что поставляемый нами контент и созданная нами платформа должны облегчить клиентам изучение и развертывание решений.
Предварительная версия доступна только для корпоративной документации по мобильности, которая включает расширенную аналитику угроз, Azure Active Directory, удаленное приложение Azure, многофакторную аутентификацию, управление правами Azure, Intune и Microsoft Identity Manager. Однако эта же модель будет использоваться для другого контента.
Среди ключевых функций, представленных на выставке, — заданная ширина содержимого и увеличенный размер шрифта для панели навигации слева. Длина статьи намеренно сделана короткой, и есть также оценка того, сколько времени потребуется для чтения каждой статьи под именем автора.
Хотя контент для doc.microsoft изначально создавался Microsoft, идея документации с открытым исходным кодом заключается в том, что сообщество может сказать свое слово. Вы найдете инструменты, позволяющие комментировать, редактировать и публиковать контент рядом с тем, который переключается между светлой и темной темой.
Microsoft заключила партнерское соглашение с Livefyre, чтобы в каждой статье можно было делать комментарии и примечания. Для этого вам необходимо войти в систему, используя данные своей учетной записи Microsoft или учетные данные Twitter, Facebook, Google или Yahoo. После этого вы можете добавлять комментарии или примечания к каждому абзацу контента.
Кнопка «Изменить» переводит вас в исходный файл Markdown в GitHub, где вы можете отправить запрос на перенос, чтобы исправить или улучшить контент. Кнопка «Поделиться» позволяет делиться контентом в Twitter или Facebook.
Хотя никто не будет возражать, что документацию Microsoft можно было улучшить, это то изменение, которое мы хотели? Требуется то, что позволяет быстро и легко находить информацию. С другой стороны, мы не хотим терять доступ к непонятной информации, на которую полагаются лишь немногие. Существует много истории, и она может быть отвергнута, потому что ее значение не осознается. Также существует тот факт, что интересы меняются, и интересы Microsoft больше не связаны с Visual Basic и MFC, а с универсальными приложениями и всем остальным Azure. При воссоздании документации с нуля будет совершенно другой акцент на том, что это за технология. Вы также не можете избавиться от подозрений, которые всплывают на поверхность, что это может быть еще одним способом для Microsoft подтолкнуть нас к переходу на новое. Является ли эта документация маркетинговой?
Хотя мы полностью поддерживаем улучшенную обнаруживаемость, не позволяйте, чтобы это происходило за счет выброса информации, которую Microsoft теперь считает устаревшей. Существует множество отлично работоспособных систем, активно использующих старые технологии.