зеркало из https://github.com/github/docs.git
Modify integration content in the 'Get started' docs set (#37623)
Co-authored-by: Jess Hosman <1183847+jhosman@users.noreply.github.com>
This commit is contained in:
Sarah Edwards
GitHub
Родитель
a89d5478ef
Коммит
6f9209dc69
|
|
@ -1,11 +1,12 @@
|
|||
---
|
||||
title: About GitHub Marketplace
|
||||
intro: 'Learn about {% data variables.product.prodname_marketplace %} where you can share your apps and actions publicly with all {% data variables.product.product_name %} users.'
|
||||
title: About GitHub Marketplace for apps
|
||||
intro: 'Learn about {% data variables.product.prodname_marketplace %} where you can share your apps publicly with all {% data variables.product.product_name %} users.'
|
||||
redirect_from:
|
||||
- /apps/marketplace/getting-started
|
||||
- /marketplace/getting-started
|
||||
- /developers/github-marketplace/about-github-marketplace
|
||||
- /developers/github-marketplace/github-marketplace-overview/about-github-marketplace
|
||||
- /apps/publishing-apps-to-github-marketplace/github-marketplace-overview/about-github-marketplace
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
|
|
@ -5,10 +5,11 @@ versions:
|
|||
fpt: '*'
|
||||
ghec: '*'
|
||||
children:
|
||||
- /about-github-marketplace
|
||||
- /about-github-marketplace-for-apps
|
||||
- /about-marketplace-badges
|
||||
- /applying-for-publisher-verification-for-your-organization
|
||||
shortTitle: Overview
|
||||
redirect_from:
|
||||
- /developers/github-marketplace/github-marketplace-overview
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@ topics:
|
|||
## Finding {% data variables.product.prodname_github_app %}s
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
You can discover {% data variables.product.prodname_github_app %}s on {% data variables.product.prodname_marketplace %}. For more information, see "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)."{% else %}You cannot install third-party applications on your enterprise. If you want to use the functionality of a third-party app, you can contact the app developer about creating an app from a manifest or from URL parameters. For more information, see "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/creating-a-github-app-from-a-manifest)" and "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/creating-a-github-app-using-url-parameters)."{% endif %}
|
||||
You can discover {% data variables.product.prodname_github_app %}s on [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). {% else %}You cannot install third-party applications on your enterprise. If you want to use the functionality of a third-party app, you can contact the app developer about creating an app from a manifest or from URL parameters. For more information, see "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/creating-a-github-app-from-a-manifest)" and "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/creating-a-github-app-using-url-parameters)."{% endif %}
|
||||
|
||||
You can also build your own {% data variables.product.prodname_github_app %}. For more information, see "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/about-creating-github-apps)."
|
||||
|
||||
|
|
|
|||
|
|
@ -58,6 +58,5 @@ If you cancel a free trial on a paid plan, your subscription is immediately canc
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)"
|
||||
- "[AUTOTITLE](/apps/using-github-apps)"
|
||||
- "[AUTOTITLE](/support/learning-about-github-support/github-marketplace-support)"
|
||||
|
|
|
|||
|
|
@ -0,0 +1,27 @@
|
|||
---
|
||||
title: About building integrations
|
||||
intro: "You can build integrations to extend {% data variables.product.company_short %}'s functionality."
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
---
|
||||
|
||||
Integrations are tools that extend {% data variables.product.company_short %}'s functionality. Integrations can do things on {% data variables.product.company_short %} like open issues, comment on pull requests, and manage projects. They can also do things outside of {% data variables.product.company_short %} based on events that happen on {% data variables.product.company_short %}. For example, an integration can post on Slack when an issue is opened on {% data variables.product.company_short %}.
|
||||
|
||||
Many integrations are {% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_actions %} workflows, or custom actions for {% data variables.product.prodname_actions %} workflows.
|
||||
|
||||
- {% data variables.product.prodname_github_app %}s are integrations that run on the app owner's server or on a user device. For more information, see "[AUTOTITLE](/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)."
|
||||
- {% data variables.product.prodname_actions %} workflows are workflows that run when specific events occur on {% data variables.product.company_short %}. For more information, see "[AUTOTITLE](/actions/learn-github-actions/understanding-github-actions)."
|
||||
- Custom actions are code that can be executed by a {% data variables.product.prodname_actions %} workflow. For more information, see "[AUTOTITLE](/actions/creating-actions/about-custom-actions)."
|
||||
|
||||
Your integration can use {% data variables.product.company_short %}'s API to fetch data and make changes to data on {% data variables.product.company_short %}. {% data variables.product.company_short %} has a REST API and a GraphQL API. For more information, see:
|
||||
|
||||
- "[AUTOTITLE](/rest/overview/about-githubs-apis)"
|
||||
- "[AUTOTITLE](/rest)"
|
||||
- "[AUTOTITLE](/graphql)"
|
||||
|
||||
Your integration can use webhooks to learn when specific events happen on {% data variables.product.company_short %}. For more information, see "[AUTOTITLE](/webhooks-and-events/webhooks/about-webhooks)."
|
||||
|
||||
{% ifversion fpt or ghec %} If your integration is a {% data variables.product.prodname_github_app %} or custom action, you can publish your integration on {% data variables.product.prodname_marketplace %}. For more information, see "[AUTOTITLE](/apps/publishing-apps-to-github-marketplace/github-marketplace-overview/about-github-marketplace)" and "[AUTOTITLE](/actions/creating-actions/publishing-actions-in-github-marketplace)."{% endif %}
|
||||
|
|
@ -1,36 +0,0 @@
|
|||
---
|
||||
title: About GitHub Marketplace
|
||||
intro: '{% data variables.product.prodname_marketplace %} contains tools that add functionality and improve your workflow.'
|
||||
redirect_from:
|
||||
- /articles/about-github-marketplace
|
||||
- /github/customizing-your-github-workflow/about-github-marketplace
|
||||
- /github/customizing-your-github-workflow/exploring-integrations/about-github-marketplace
|
||||
- /get-started/customizing-your-github-workflow/exploring-integrations/about-github-marketplace
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
---
|
||||
You can discover, browse, and install free and paid tools, including {% data variables.product.prodname_github_apps %}, {% data variables.product.prodname_oauth_apps %}, and {% data variables.product.prodname_actions %}, in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace).
|
||||
|
||||
If you purchase a paid tool, you'll pay for your tool subscription with the same billing information you use to pay for your {% data variables.product.product_name %} subscription, and receive one bill on your regular billing date. For more information, see "[AUTOTITLE](/billing/managing-billing-for-github-marketplace-apps/about-billing-for-github-marketplace)."
|
||||
|
||||
You may also have the option to select a free 14-day trial on some tools. You can cancel at any time during your trial and you won't be charged, but you will automatically lose access to the tool. Your paid subscription will start at the end of the 14-day trial. For more information, see "[AUTOTITLE](/billing/managing-billing-for-github-marketplace-apps/about-billing-for-github-marketplace)."
|
||||
|
||||
## Finding tools on {% data variables.product.prodname_marketplace %}
|
||||
|
||||
You can discover, browse, and install apps and actions created by others on {% data variables.product.prodname_marketplace %}, see "[AUTOTITLE](/search-github/searching-on-github/searching-github-marketplace)."
|
||||
|
||||
{% data reusables.actions.actions-not-verified %}
|
||||
|
||||
Anyone can list a free {% data variables.product.prodname_github_app %} or {% data variables.product.prodname_oauth_app %} on {% data variables.product.prodname_marketplace %}. Publishers of paid apps are verified by {% data variables.product.company_short %} and listings for these apps are shown with a marketplace badge {% octicon "verified" aria-label="Verified creator badge" %}. You will also see badges for unverified and verified apps. These apps were published using the previous method for verifying individual apps. For more information about the current process, see "[AUTOTITLE](/apps/publishing-apps-to-github-marketplace/github-marketplace-overview/about-github-marketplace)" and "[AUTOTITLE](/apps/publishing-apps-to-github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app)."
|
||||
|
||||
## Building and listing a tool on {% data variables.product.prodname_marketplace %}
|
||||
|
||||
For more information on creating your own tool to list on {% data variables.product.prodname_marketplace %}, see "[AUTOTITLE](/apps)" and "[AUTOTITLE](/actions)."
|
||||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/apps/using-github-apps)"
|
||||
- "[AUTOTITLE](/billing/managing-billing-for-github-marketplace-apps)"
|
||||
- "[AUTOTITLE](/support/learning-about-github-support/github-marketplace-support)"
|
||||
- "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/differences-between-github-apps-and-oauth-apps)"
|
||||
|
|
@ -1,43 +0,0 @@
|
|||
---
|
||||
title: About integrations
|
||||
intro: 'Integrations are tools and services that connect with {% data variables.product.product_name %} to complement and extend your workflow.'
|
||||
redirect_from:
|
||||
- /articles/about-integrations
|
||||
- /github/customizing-your-github-workflow/about-integrations
|
||||
- /github/customizing-your-github-workflow/exploring-integrations/about-integrations
|
||||
- /get-started/customizing-your-github-workflow/exploring-integrations/about-integrations
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
---
|
||||
You can install integrations in your personal account or organizations you own. You can also install {% data variables.product.prodname_github_apps %} from a third-party in a specific repository where you have admin permissions or which is owned by your organization.
|
||||
|
||||
## Differences between {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %}
|
||||
|
||||
Integrations can be {% data variables.product.prodname_github_apps %}, {% data variables.product.prodname_oauth_apps %}, or anything that utilizes {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIs or webhooks.
|
||||
|
||||
{% data variables.product.prodname_github_apps %} offer granular permissions and request access to only what the app needs. {% data variables.product.prodname_github_apps %} also offer specific user-level permissions that each user must authorize individually when an app is installed or when the integrator changes the permissions requested by the app.
|
||||
|
||||
For more information, see:
|
||||
- "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/differences-between-github-apps-and-oauth-apps)"
|
||||
- "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/about-creating-github-apps)"
|
||||
- "[AUTOTITLE](/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)"
|
||||
- "[AUTOTITLE](/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps)"
|
||||
- "[AUTOTITLE](/apps/using-github-apps/authorizing-github-apps)"
|
||||
- "[AUTOTITLE](/apps/using-github-apps/reviewing-your-authorized-integrations)"
|
||||
|
||||
You can install a preconfigured {% data variables.product.prodname_github_app %}, if the integrators or app creators have created their app with the {% data variables.product.prodname_github_app %} manifest flow. For information about how to run your {% data variables.product.prodname_github_app %} with automated configuration, contact the integrator or app creator.
|
||||
|
||||
You can create a {% data variables.product.prodname_github_app %} with simplified configuration if you build your app with Probot. For more information, see the [Probot docs](https://probot.github.io/docs/) site.
|
||||
|
||||
## Discovering integrations in {% data variables.product.prodname_marketplace %}
|
||||
|
||||
You can find an integration to install or publish your own integration in {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
[{% data variables.product.prodname_marketplace %}](https://github.com/marketplace) contains {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %}. For more information on finding an integration or creating your own integration, see "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)."
|
||||
|
||||
## Integrations purchased directly from integrators
|
||||
|
||||
You can also purchase some integrations directly from integrators. As an organization member, if you find a {% data variables.product.prodname_github_app %} that you'd like to use, you can request that an organization approve and install the app for the organization.
|
||||
|
||||
If you have admin permissions for all organization-owned repositories the app is installed on, you can install {% data variables.product.prodname_github_apps %} with repository-level permissions without having to ask an organization owner to approve the app. When an integrator changes an app's permissions, if the permissions are for a repository only, organization owners and people with admin permissions to a repository with that app installed can review and accept the new permissions.
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
---
|
||||
title: About using integrations
|
||||
intro: 'Integrations are tools and services that connect with {% data variables.product.product_name %} to complement and extend your workflow.'
|
||||
redirect_from:
|
||||
- /articles/about-integrations
|
||||
- /github/customizing-your-github-workflow/about-integrations
|
||||
- /github/customizing-your-github-workflow/exploring-integrations/about-integrations
|
||||
- /get-started/customizing-your-github-workflow/exploring-integrations/about-integrations
|
||||
- /articles/about-github-marketplace
|
||||
- /github/customizing-your-github-workflow/about-github-marketplace
|
||||
- /github/customizing-your-github-workflow/exploring-integrations/about-github-marketplace
|
||||
- /get-started/customizing-your-github-workflow/exploring-integrations/about-github-marketplace
|
||||
- /get-started/exploring-integrations/about-github-marketplace
|
||||
- /get-started/exploring-integrations/about-integrations
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
---
|
||||
|
||||
Integrations are tools that extend {% data variables.product.company_short %}'s functionality. Integrations can do things on {% data variables.product.company_short %} like open issues, comment on pull requests, and manage projects. They can also do things outside of {% data variables.product.company_short %} based on events that happen on {% data variables.product.company_short %}. For example, an integration can post on Slack when an issue is opened on {% data variables.product.company_short %}.
|
||||
|
||||
You can discover many integrations in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). {% data variables.product.prodname_marketplace %} includes {% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s, and custom actions that you can use in {% data variables.product.prodname_actions %} workflows. You can also get integrations directly from the integration creator.
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.7 %} For a list of featured {% data variables.product.company_short %} integrations, see "[AUTOTITLE](/get-started/exploring-integrations/github-extensions-and-integrations)."{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
If you want your {% data variables.product.prodname_ghe_server %} instance to use a third-party {% data variables.product.prodname_github_app %}, you can contact the app developer about making the {% data variables.product.prodname_github_app %} available for {% data variables.product.prodname_ghe_server %}. For more information, see "[AUTOTITLE](/apps/sharing-github-apps/making-your-github-app-available-for-github-enterprise-server)."
|
||||
|
||||
If you want your {% data variables.product.prodname_ghe_server %} instance to use third-party custom actions, you need to enable {% data variables.product.prodname_github_connect %}. For more information, see "[AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
For more information about using integrations, see:
|
||||
|
||||
- "[AUTOTITLE](/apps/using-github-apps/about-using-github-apps)"
|
||||
- "[AUTOTITLE](/apps/oauth-apps/using-oauth-apps)"
|
||||
- "[AUTOTITLE](/actions/learn-github-actions/finding-and-customizing-actions)"
|
||||
|
||||
You can also build your own integrations. For more information, see "[AUTOTITLE](/get-started/exploring-integrations/about-building-integrations)."
|
||||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
title: GitHub extensions and integrations
|
||||
title: Featured GitHub integrations
|
||||
intro: 'Use {% data variables.product.prodname_dotcom %} extensions to work seamlessly in repositories on {% data variables.location.product_location %} within third-party applications.'
|
||||
redirect_from:
|
||||
- /articles/about-github-extensions-for-third-party-applications
|
||||
|
|
@ -7,11 +7,12 @@ redirect_from:
|
|||
- /github/customizing-your-github-workflow/github-extensions-and-integrations
|
||||
- /github/customizing-your-github-workflow/exploring-integrations/github-extensions-and-integrations
|
||||
- /get-started/customizing-your-github-workflow/exploring-integrations/github-extensions-and-integrations
|
||||
- /get-started/exploring-integrations/github-extensions-and-integrations
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ghes: '>3.7'
|
||||
shortTitle: Extensions & integrations
|
||||
shortTitle: Featured integrations
|
||||
---
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
|
@ -14,9 +14,10 @@ versions:
|
|||
ghae: '*'
|
||||
ghes: '*'
|
||||
children:
|
||||
- /about-integrations
|
||||
- /about-github-marketplace
|
||||
- /github-extensions-and-integrations
|
||||
- /about-using-integrations
|
||||
- /about-building-integrations
|
||||
- /featured-github-integrations
|
||||
- /github-developer-program
|
||||
shortTitle: Exploring integrations
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -57,9 +57,3 @@ shortTitle: GitHub App managers
|
|||
1. Under "{% data variables.product.prodname_github_apps %}", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from.
|
||||
{% data reusables.organizations.app-managers-settings-sidebar %}
|
||||
1. Under "App managers", next to the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)"
|
||||
{% endif %}
|
||||
|
|
|
|||
|
|
@ -36,5 +36,8 @@ Anytime you search across all of {% data variables.product.prodname_dotcom_the_w
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)"
|
||||
- "[AUTOTITLE](/actions/learn-github-actions/finding-and-customizing-actions)"
|
||||
- "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account)"
|
||||
- "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations)"
|
||||
- "[AUTOTITLE](/apps/oauth-apps/using-oauth-apps/installing-an-oauth-app-in-your-personal-account)"
|
||||
- "[AUTOTITLE](/apps/oauth-apps/using-oauth-apps/installing-an-oauth-app-in-your-organization)"
|
||||
|
|
|
|||
|
|
@ -23,6 +23,5 @@ Every app in {% data variables.product.prodname_marketplace %} includes a link t
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)"
|
||||
- "[AUTOTITLE](/apps/using-github-apps)"
|
||||
- "[AUTOTITLE](/billing/managing-billing-for-github-marketplace-apps)"
|
||||
|
|
|
|||
|
|
@ -1 +1 @@
|
|||
{% data variables.product.prodname_marketplace %} contains integrations that add functionality and improve your workflow. You can discover, browse, and install free and paid tools, including {% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_actions %}, in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). For more information, see "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)."
|
||||
{% data variables.product.prodname_marketplace %} contains integrations that add functionality and improve your workflow. You can discover, browse, and install free and paid tools, including {% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_actions %}, in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace).
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@
|
|||
"/apps/managing-oauth-apps": "/en/apps/oauth-apps/maintaining-oauth-apps",
|
||||
"/apps/quickstart-guides": "/en/apps/creating-github-apps/writing-code-for-a-github-app",
|
||||
"/marketplace": "/en/apps/publishing-apps-to-github-marketplace",
|
||||
"/marketplace/getting-started": "/en/apps/publishing-apps-to-github-marketplace/github-marketplace-overview/about-github-marketplace",
|
||||
"/marketplace/getting-started": "/en/apps/publishing-apps-to-github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps",
|
||||
"/marketplace/integrating-with-the-github-marketplace-api": "/en/apps/publishing-apps-to-github-marketplace/using-the-github-marketplace-api-in-your-app",
|
||||
"/marketplace/listing-on-github-marketplace": "/en/apps/publishing-apps-to-github-marketplace/listing-an-app-on-github-marketplace",
|
||||
"/marketplace/selling-your-app": "/en/apps/publishing-apps-to-github-marketplace/selling-your-app-on-github-marketplace",
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче