Использование GitHub

Данный раздел поможет ориентироваться в GitHub на базовом уровне

GitHub – это веб-сервис для хостинга IT-проектов и их совместной разработки. Многие homebrew-разработчики используют его для публикации исходного кода проекта и последующего распространения программ.

В большинстве случаев homebrew-программы вы сможете так или иначе найти на GitHub. Иногда их можно найти на BitBucket, еще реже – на других ресурсах.

• BitBucket – аналог GitHub, но от другой компании.

Хотите быстро найти нужное homebrew?

Введите в поисковой строке конструкцию запроса "название_homebrew github".

• В 99% случаев первым же ответом в поисковой системе будет искомая ссылка.

  • Например: decky github или elevenmpv github

• Если Вы знаете автора homebrew – это значительно сузит и ускорит поиск.

  • Например: theofficialflow github или Andy Nguyen github.

• Используйте полное название homebrew при поиске.

Интерфейс ресурса

1. Репозиторий

В строке отображается Автор / Название репозитория.

• Репозиторий – это хранилище данных (исходный код, приложение и т.д.)

• Иконка Public показывает доступность репозитория для пользователей.

  • Бывают разные статусы, в том числе и Archived, Private и т.д.

• Под названием репозитория может быть информация, является ли это форком или нет. Полезно при поиске актуального homebrew.

2. Issues

В данном разделе отображаются все заведенные "проблемы" пользователями.

• Прежде чем заводить issue, ознакомьтесь с уже существующим списком. Возможно Ваша проблема не уникальна, и имеет ответ.

• Если проблема решена, она получает статус "Closed". Если проблема не решена, или имеет обходное решение, то она остается в статусе "Open". Не ленитесь, откройте проблему и прочитайте комментарии, если нашли аналогичную вашей.

• Для создания новой проблемы нажмите зеленую кнопку "New issue".

В некоторых репозиториях раздел "Issues" может быть отключен.

• В этом случае вам остается либо смириться с проблемой, либо поискать решение в интернете.

3. Forks

Отображает общее количество форков данного приложения. Позволяет перейти в нужную ветку конкретного разработчика.

• Используйте, только если Вы понимате для чего делаете эти переходы!

4. Releases

Интересующий Вас раздел. В нем появляются релизы homebrew, отсортированные по дате выхода (наверху самый "свежий" релиз).

• Все загружаемые файлы разположены под спойлером "Assets".

• Не загружайте архив "Source code" без нужды.

  • Это исходный код программы, он нужен для разработки и компилирования приложения.

5. README.md

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

Может содержать в себе:

• Информацию об использовании приложения.

• Особенности установки приложения.

• FAQ

• Известные Issues и их решение.

• Дополнительные ссылки.

• Как самостоятельно собрать приложение.

• Авторов.

• и т.д. и т.п.

Полезное

• Для того, чтобы загружать релизы с GitHub не требуется регистрация. А вот для комментариев или создания issue – необходимо зарегистрироваться.

• Если вы не знаете автора приложения, и вдруг натыкаетесь на десятки форков (веток) одной программы, то сверяйте актуальность по последней дате релиза приложения. Та дата, что будет последней – и есть искомый вариант.

• Не ленитесь изучать README.md на странице релиза. Разработчик писал этот раздел не просто так. Там указывается наиболее важная информация по приложению, от использования вплоть до самостоятельной сборки.

• С разработчиками из любой страны принято общаться на английском языке. Если Вы не владеете языком, то для формирования вопроса используйте Google Translate.

  • Старайтесь писать вежливо, емко и по делу. Прикладывайте максимум информации для решения Вашего вопроса связанного с программой (описание, скриншоты, файлы если потребуются). В противном случае Вы просто получите игнор по вашей проблеме.