Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: recommend users install the GitHub or Bitbucket Cloud hosted app #29457

19 changes: 19 additions & 0 deletions lib/modules/platform/bitbucket/readme.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,24 @@
# Bitbucket Cloud

Most of the information on this page is meant for users who want to self-host Renovate on Bitbucket Cloud.

## Easiest way to run Renovate
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved

For most users, the easiest way to get started is to install [the Mend Renovate app for Bitbucket](#).

Check failure on line 7 in lib/modules/platform/bitbucket/readme.md

View workflow job for this annotation

GitHub Actions / lint-docs

No empty links

lib/modules/platform/bitbucket/readme.md:7:62 MD042/no-empty-links No empty links [Context: "[the Mend Renovate app for Bit..."] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md042.md
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved
When you use the app, Mend will:

- authenticate the Renovate app to Bitbucket Cloud
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved
- keep the tokens safe
- update the Renovate program for you
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved

If you self-host Renovate you must do the things listed above yourself.
Self-hosting is meant for users with advanced use cases, or who want to be in full control of the bot and the environment it runs in.
We recommend most users install the Mend Renovate app.
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved

Read the [Security and Permissions](https://docs.renovatebot.com/security-and-permissions/) page to learn about the Security and Permissions needed for the Mend Renovate app.

Check failure on line 18 in lib/modules/platform/bitbucket/readme.md

View workflow job for this annotation

GitHub Actions / lint-docs

Trailing spaces

lib/modules/platform/bitbucket/readme.md:18:175 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md009.md
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved

After you installed the hosted app, please read the [reading list](https://docs.renovatebot.com/reading-list/) to learn how to use and configure Renovate.

## Authentication

First, [create an app password](https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/) for the bot account.
Expand Down
19 changes: 19 additions & 0 deletions lib/modules/platform/github/readme.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,24 @@
# GitHub and GitHub Enterprise Server

Most of the information on this page is meant for users who want to self-host Renovate on GitHub or GitHub Enterprise Server.

## Easiest way to run Renovate

For most users, the easiest way to get started is to install [the Mend Renovate app](https://github.com/marketplace/renovate) from the GitHub marketplace.
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved
When you use the app, Mend will:

- authenticate the Renovate app to GitHub or GitHub Enterprise
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved
- keep the tokens safe
- update the Renovate program for you
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved

If you self-host Renovate you must do the things listed above yourself.
Self-hosting is meant for users with advanced use cases, or who want to be in full control of the bot and the environment it runs in.
We recommend most users install the Mend Renovate app.

Read the [Security and Permissions](https://docs.renovatebot.com/security-and-permissions/) page to learn about the Security and Permissions needed for the Mend Renovate app.

Check failure on line 18 in lib/modules/platform/github/readme.md

View workflow job for this annotation

GitHub Actions / lint-docs

Trailing spaces

lib/modules/platform/github/readme.md:18:175 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md009.md
HonkingGoose marked this conversation as resolved.
Show resolved Hide resolved

After you installed the hosted app, please read the [reading list](https://docs.renovatebot.com/reading-list/) to learn how to use and configure Renovate.

## Authentication

First, create a [fine-grained](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token) _or_ a [classic](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token#creating-a-personal-access-token-classic) PAT.
Expand Down
Loading