Skip to main content

Написание описания для вашего приложения

Чтобы включить приложение в GitHub Marketplace, необходимо создать для приложения описания и предоставить изображения, которые соответствуют рекомендациям GitHub.

Ниже приведены рекомендации по полям, которые необходимо заполнить в разделе Описание черновика вашего описания.

Именование и ссылки

Название описания

Название вашего описания появится на главной странице GitHub Marketplace. Имя ограничено 255 символами и может отличаться от имени вашего приложения. Имя вашей учетной записи не может совпадать с именем существующей учетной записи в GitHub.com, если имя не является вашим именем пользователя или организации.

Очень краткое описание

Сообщество увидит "очень краткое" описание под названием вашего приложения на главной странице GitHub Marketplace.

Краткое описание приложения GitHub Marketplace

Длина

Мы рекомендуем краткие описания длиной до 40–80 символов. Хотя вам разрешено использовать больше символов, клиентам легче быстро читать и понимать краткие описания.

Содержимое

  • Опишите функциональность приложения. Не используйте это пространство для призыва к действию. Пример:

    ПРАВИЛЬНО. Упрощение управления проектами для проблем GitHub

    НЕПРАВИЛЬНО. Управляйте своими проектами и проблемами в GitHub

    Совет. Измените окончание глагола в призыве к действию таким образом, чтобы превратить его в приемлемое описание: Управляет вашими проектами и проблемами на GitHub

  • Не повторяйте название приложения в описании.

    ПРАВИЛЬНО. Встроенный в контейнер инструмент непрерывной интеграции

    НЕПРАВИЛЬНО. Skycap – это встроенный в контейнер инструмент непрерывной интеграции

Форматирование

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

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

  • Делайте заглавными только имена собственные. Пример:

    ПРАВИЛЬНО. Автоматизация доставки одним щелчком для веб-разработчиков

    НЕПРАВИЛЬНО. Автоматизация доставки одним щелчком для Веб-Разработчиков

  • Всегда используйте запятую в списках.

  • Не называйте сообщество GitHub "пользователями".

    ПРАВИЛЬНО. Автоматическое создание задач для сотрудников вашей организации

    НЕПРАВИЛЬНО. Автоматическое создание задач для пользователей организации

  • Используйте аббревиатуры, только если они широко используются (например, API). Пример:

    ПРАВИЛЬНО. Доски задач, оценки и отчеты Agile непосредственно в GitHub

    НЕПРАВИЛЬНО. Доски задач, оценки и отчеты Agile непосредственно в UI GitHub

Категории

Приложения в GitHub Marketplace можно отображать по категориям. Выберите категорию, которая лучше всего описывает основные функции вашего приложения, в раскрывающемся списке Основная категория и при необходимости выберите Дополнительную категорию, подходящую вашему приложению.

Поддерживаемые языки

Если ваше приложение работает только с определенными языками, выберите до 10 языков программирования, которые поддерживает ваше приложение. Эти языки отображаются на странице с описанием GitHub Marketplace вашего приложения. Это поле является необязательным.

URL-адреса описания

Необходимые URL-адреса

  • URL-адрес службы поддержки клиентов. URL-адрес веб-страницы, на которую будут переходить ваши клиенты, когда у них возникнут вопросы о технической поддержке, продуктах или учетных записях.
  • URL-адрес политики конфиденциальности. Веб-страница, на которой отображается политика конфиденциальности вашего приложения.
  • URL-адрес установки. Это поле отображается только для приложений OAuth. (Приложения GitHub не используют этот URL-адрес, так как вместо этого они используют необязательный URL-адрес установки со страницы настроек приложения GitHub.) Когда клиент покупает ваше приложение OAuth, GitHub перенаправляет клиентов на URL-адрес установки после того, как они установят приложение. Вам нужно будет перенаправить клиентов по адресу https://github.com/login/oauth/authorize, чтобы начать процесс авторизации OAuth. Дополнительные сведения см. в статье Новые покупки приложений OAuth. Пропустите это поле, если вы публикуете приложение GitHub.

Необязательные URL-адреса

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

Логотип и карточка функции

GitHub Marketplace отображает все описания с квадратным изображением логотипа внутри круглой метки, чтобы визуально различать приложения.

Логотип GitHub Marketplace и изображения значков

Карточка функции состоит из логотипа вашего приложения, названия и пользовательского фонового изображения, которое отражает индивидуальность вашего бренда. GitHub Marketplace отображает эту карточку, если ваше приложение является одним из четырех случайно выбранных приложений в верхней части главной страницы. Под карточкой функции каждого приложения отображается очень краткое описание.

Карточка функции

По мере передачи изображений и выбора цветов в вашем черновом описании GitHub Marketplace будет отображаться предварительная версия вашего логотипа и карточки функции.

Рекомендации по логотипам

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

  • Передайте изображение логотипа размером не менее 200 x 200 пикселей, чтобы логотип не нужно было масштабировать при публикации описания.
  • Логотипы будут обрезаны до квадрата. Рекомендуем передать квадратный файл изображения с вашим логотипом в центре.
  • Для достижения наилучших результатов передайте изображение логотипа с прозрачным фоном.
  • Чтобы значок идеально вписался, выберите для него цвет фона, который соответствует цвету фона (или прозрачности) изображения вашего логотипа.
  • Старайтесь не использовать логотипы со словами или текстом. Логотипы с текстом плохо масштабируются на маленьких экранах.

Рекомендации по карточкам функций

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

  • Используйте шаблон или текстуру на фоновом изображении, чтобы придать вашей карточке визуальную идентичнность и чтобы она выделялась на темном фоне главной страницы GitHub Marketplace. Карточки функций должны отражать индивидуальность бренда вашего приложения.
  • Фоновое изображение имеет размеры 965 x 482 пикселей (ширина x высота).
  • Выберите цвет текста для названия вашего приложения, который четко выделяется на фоновом изображении.

Listing Details (Сведения списка)

Чтобы перейти на целевую страницу приложения, щелкните имя своего приложения на главной странице GitHub Marketplace или на странице категории. На целевой странице отображается более подробное описание приложения, состоящее из двух частей: "Вводное описание" и "Подробное описание."

Ваше "Вводное описание" отображается в верхней части целевой страницы GitHub Marketplace вашего приложения.

Вводное описание GitHub Marketplace

При нажатии Подробнее... отобразится "Подробное описание."

Подробное описание GitHub Marketplace

Следуйте этим рекомендациям для написания этих описаний.

Длина

При публикации описания вашего приложения мы рекомендуем написать краткое изложение из 1–2 предложений длиной от 150 до 250 символов в обязательном поле "Вводное описание." Хотя разрешено использовать больше символов, клиентам легче быстро читать и понимать краткие сводки.

Вы можете добавить дополнительные сведения в необязательное поле "Подробное описание." Вы увидите это описание, щелкнув Подробнее... под вводным описанием на целевой странице вашего приложения. Подробное описание состоит из 3–5 ценностных предложений, каждое из которых описывается 1–2 предложениями. Для этого описания можно использовать до 1000 символов.

Содержимое

  • Всегда начинайте вводные описания с названия вашего приложения.

  • Всегда пишите описания и ценностные предложения, используя живую речь.

Форматирование

  • Всегда используйте заглавные буквы в заголовках вашего ценностного предложения. Делайте заглавными только первую букву и имена собственные.

  • Используйте точки в описаниях. Избегайте восклицательных знаков.

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

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

    Освойте необходимые вам навыки

    GitHub Skills поможет вам научиться пользоваться GitHub, более эффективно применять Markdown, устранять конфликты слияния и делать многое другое.

  • Делайте заглавными только имена собственные.

  • Всегда используйте запятую в списках.

  • Не называйте сообщество GitHub "пользователями".

    ПРАВИЛЬНО. Автоматическое создание задач для сотрудников вашей организации

    НЕПРАВИЛЬНО. Автоматическое создание задач для пользователей организации

  • Используйте аббревиатуры, только если они широко используются (например, API).

Снимок экрана продукта

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

Рекомендации по снимкам экрана

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

Изображение снимка экрана GitHub Marketplace