# Использование 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.pgteam.org/main/guides/gaidy/dopolnitelno/ispolzovanie-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.