Dash приносит документацию по кодированию на рабочий стол Mac

Если вы программист, вы уже сильно полагаетесь на документацию. Dash (бесплатно, $ 19,99 за полную версию) — это приложение для Mac, разработанное для того, чтобы сделать ваше чтение более приятным.

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

Черта и Документация

Dash — это приложение, которое локально кэширует документацию из Интернета и позволяет получить к ней доступ через определенное веб-приложение. Его можно скачать с сайта разработчика. Разница между бесплатной и платной минимальна, бесплатная версия поставляется с временем ожидания при запуске и всякий раз, когда вы переключаетесь между наборами документации (docsets) и заставляет вас покупать ее.

Если вы решите перейти на платную версию Dash, вы можете по крайней мере использовать ее на таком количестве компьютеров Mac, которое у вас есть (неограниченное количество, по словам разработчиков).

Ценность предложения Dash основана на количестве библиотек и языков, которые он поддерживает, и именно здесь он сияет.

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

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

Качество документации

Разработчики сами не создавали документацию, так что это не их вина. Как я уже говорил ранее, Dash кэширует только существующую документацию.

Проблема в том, что некоторые языки плохо документированы — например, упрощенное противоядие JavaScript CoffeeScript

, Их документация — это скорее руководство с практическими рекомендациями «Разве это не круто?», Показывающее примеры языка в действии, без реального объяснения того, как все работает.

Кроме того, в случае CoffeeScript он не очень хорошо выглядит в Dash. Это гораздо лучше подходит для веб-браузера.

При этом некоторые наборы документации работают очень хорошо, например, для Ruby. Это язык, который поддерживает инфраструктуру веб-приложений Ruby On Rails

, имеет полностью доступную для поиска документацию и хорошо вписывается в эстетику Dash.

Есть также шпаргалки, доступные для скачивания в Dash. Они сосредоточены не на языковых возможностях, а на расширенных возможностях Git, любимого штатным текстовым редактором Sublime Text 2

и 3, и другие популярные пакеты программного обеспечения.

Шпаргалки также доступны для функций HTTP, HTML и CSS Named Colours.

доступность

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

В Dash я не нашел каких-либо особых настроек специальных возможностей и не нашел способа увеличить размер текста. Это может быть нарушителем соглашения для некоторых пользователей с нарушениями зрения. Тем не менее, OS X поставляется с некоторыми функциями специальных возможностей (Системные настройки> Система> Специальные возможности), которые могут сделать Dash более удобным для использования.

Заключение

Должны ли вы получить платную версию Dash? Это зависит от. На самом деле не существует каких-либо привлекательных функций, которые оправдывают затраты на обновление, но вы будете поддерживать проект, принимая участие.

Я использую бесплатную версию Dash почти ежедневно. Если вы слинг-код для жизни и владеете Mac, вам нужно это приложение. Это не идеально, но это делает работу.

Скачать: Dash для Mac OS X (бесплатно, $ 19,99 за полную версию)

Как вы думаете? Загрузите его и сообщите нам свои мысли в комментариях ниже.

Кредит Фотографии: Кодекс (Майкл Химбо)