Документация по Xamarin на сайте docs.microsoft.com

Автор записи — Крейг Данн (Craig Dunn), главный администратор программы в Xamarin.

Note

Это объявление опубликовано перекрестно из блога Xamarin.

Сегодня мы открываем новую главу в своем деле по предоставлению документации для разработчиков мобильных решений — теперь документация по Xamarin доступна в Интернете на странице docs.microsoft.com/xamarin! Ниже описаны некоторые новые особенности по работе с документацией:

Центр документации Xamarin

Чтобы перейти к нужной документации со страницы docs.microsoft.com/xamarin, достаточно сделать один или два щелчка. Щелкните элемент Xamarin в заголовке, чтобы вернуться сюда с любой страницы. Используйте ссылки на вкладке "Платформа", чтобы просмотреть документы для разработчиков мобильных решений, и перейдите на вкладку Графика и игры или Инструменты, чтобы подробнее узнать о соответствующих вещах, таких как SkiaSharp, книги и Xamarin Live Player.

Центр Xamarin на сайте docs.microsoft.com

Новые возможности навигации

Сайт docs.microsoft.com предоставляет несколько новых возможностей для навигации по документации Xamarin:

Страница документации по Xamarin на сайте docs.microsoft.com

  1. Домашняя страница "Платформа"  — обзор и краткое перечисление документов, доступных для каждой платформы. Используйте ссылки в синей панели заголовка, чтобы посетить страницу каждой из платформ: Android, iOS, Mac и Xamarin.Forms.
  2. Поиск — значок лупы справа от заголовка обеспечивает поиск по содержимому Xamarin.
  3. Строка навигации — располагается под заголовком и помогает найти связанные разделы.
  4. Дерево навигации — представление в виде дерева обеспечивает быструю детализацию.
  5. Фильтр навигации — позволяет отфильтровать дерево навигации, чтобы найти заголовок раздела.
  6. В этой статье — каждая статья имеет оглавление, включая удобный указатель вашего расположения в документе.
  7. Масштабирование изображений — изображения со значком лупы в нижнем правом углу можно щелкнуть для отображения дополнительных сведений.

Видео

Презентации и занятия, проводимые специалистами по пропаганде и Xamarin University, теперь доступны во встроенном виде, как в этом разделе Xamarin.Forms Layouts:

Видео, интегрированное в страницу документации docs.microsoft.com

Открытый исходный код

Каждая страница содержит ссылку Изменить, позволяющую сообществу участвовать в выпуске исправлений и обновлений. Комментарии к документации становятся вопросами GitHub, чтобы вы могли отслеживать работу по вашим отзывам. Ознакомьтесь с рекомендациями по участию, где приведены инструкции по отправке изменений.

На вашем языке

Благодаря использованию комбинации методик перевода сейчас документация по Xamarin для разработчиков доступна на 13 языках, не считая английского: китайский (упрощенное письмо), китайский (традиционное письмо), чешский, французский, итальянский, корейский, немецкий, японский, польский, португальский (Бразилия), русский, испанский и турецкий. Посетите блок по документации для получения дополнительных сведений о международных функциях.

Переключатель редактора

Иногда вам требуются инструкции, касающиеся используемого редактора кода — Visual Studio 2017 или Visual Studio для Mac. Теперь они находятся на вкладках внутри каждой страницы:

Вкладки в концептуальном содержимом на сайте docs.microsoft.com

Красивый код

Фрагменты кода выделяются с учетом синтаксиса. Кроме того, доступна кнопка Копировать, упрощающая использование фрагментов кода для приложений:

Фрагменты кода на сайте docs.microsoft.com

Браузер API

Документация по Xamarin BCL API уже доступна в браузере API .NET, а скоро будут выпущены и наши API для конкретных платформ.

Гибкий дизайн

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

Гибкий дизайн на сайте docs.microsoft.com

Темная тема

Появилась возможность читать документацию с использованием темной темы.

Темная тема на сайте docs.microsoft.com

Что дальше?

Вы заметите, что некоторое содержимое все еще размещается на старом сайте, включая документы по API, книги и примеры. Наша команда активно работает над их переносом, чтобы обеспечить единообразную работу.

Мы с грустью прощаемся со старым сайтом developer.xamarin.com, однако новые функции на сайте docs.microsoft.com/xamarin кажутся мне крайне интересными, и я надеюсь, что в будущем нам удастся создать более масштабную и удобную систему документации для разработчиков Xamarin. Вы можете поделиться своими мыслями на форумах.

P.S. Если вы добавили в заметки или опубликовали в блоке ссылки на старый сайт для разработчиков, не волнуйтесь, для них будет осуществляться автоматическое перенаправление на новый сайт.