> For the complete documentation index, see [llms.txt](https://dev.pgteam.org/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.pgteam.org/main/guides/gaidy/dopolnitelno/ispolzovanie-github.md).

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

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

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

* BitBucket – аналог GitHub, но от другой компании.
  {% endhint %}

{% hint style="success" %}
**Хотите быстро найти нужное homebrew?** 

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

* В 99% случаев первым же ответом в поисковой системе будет искомая ссылка. 
  * Например: decky github или elevenmpv github
* Если Вы знаете автора homebrew – это значительно сузит и ускорит поиск.
  * Например: theofficialflow github или Andy Nguyen github.
* **Используйте полное название homebrew** при поиске.
  {% endhint %}

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

<figure><img src="/files/tEZRW6LyJyU7rOkAlI4S" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
В строке **отображается Автор / Название репозитория.**

* Репозиторий – это хранилище данных (исходный код, приложение и т.д.)
* Иконка **Public** показывает доступность репозитория для пользователей.
  * Бывают разные статусы, в том числе и Archived, Private и т.д.
* Под названием репозитория может быть информация, является ли это форком или нет. Полезно при поиске актуального homebrew.
  {% endhint %}

#### 2. Issues

<figure><img src="/files/phwDN5QeaHTLgxY6EC14" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
В данном разделе отображаются **все заведенные "проблемы"** пользователями.

* Прежде чем заводить issue, ознакомьтесь с уже существующим списком. Возможно Ваша проблема не уникальна, и имеет ответ.
* Если проблема решена, она получает статус "**Closed**". Если проблема не решена, или имеет обходное решение, то она остается в статусе "**Open**". Не ленитесь, откройте проблему и прочитайте комментарии, если нашли аналогичную вашей.&#x20;
* Для создания новой проблемы **нажмите зеленую кнопку** "**New issue**".
  {% endhint %}

{% hint style="warning" %}
**В некоторых репозиториях раздел "Issues" может быть отключен.**&#x20;

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

#### 3. Forks

{% hint style="info" %}
Отображает общее количество форков данного приложения. Позволяет перейти в нужную ветку конкретного разработчика.

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

#### 4. Releases

<figure><img src="/files/IRKJMSF98jCCtafGyKk9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Интересующий Вас раздел.** В нем появляются релизы homebrew, отсортированные по дате выхода (наверху самый "свежий" релиз).

* **Все загружаемые файлы** разположены под спойлером "**Assets**".
* **Не загружайте архив "Source code"** без нужды.&#x20;
  * Это исходный код программы, он нужен для разработки и компилирования приложения.
    {% endhint %}

#### 5. README.md

{% hint style="info" %}
Раздел, в котором разработчики **указывают всю важную информацию** по приложению. Является прямой документацией homebrew.

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

* Информацию об использовании приложения.
* Особенности установки приложения.
* FAQ&#x20;
* Известные Issues и их решение.
* Дополнительные ссылки.
* Как самостоятельно собрать приложение.
* Авторов.
* и т.д. и т.п.
  {% endhint %}

<details>

<summary>Полезное</summary>

* Для того, чтобы загружать релизы с **GitHub не требуется регистрация**. А вот для комментариев или создания issue – необходимо зарегистрироваться.
* Если вы не знаете автора приложения, и вдруг натыкаетесь на десятки форков (веток) одной программы, то **сверяйте актуальность по последней дате релиза** приложения. Та дата, что будет последней – и есть искомый вариант.&#x20;
* **Не ленитесь изучать README.md** на странице релиза. Разработчик писал этот раздел не просто так. Там указывается наиболее важная информация по приложению, от использования вплоть до самостоятельной сборки.
* С разработчиками из любой страны принято общаться на английском языке. Если Вы не владеете языком, то для формирования вопроса используйте [Google Translate](https://translate.google.com).
  * Старайтесь писать вежливо, емко и по делу. Прикладывайте максимум информации для решения Вашего вопроса связанного с программой (описание, скриншоты, файлы если потребуются). В противном случае Вы просто получите игнор по вашей проблеме.

</details>