Add help page for update detection

This commit is contained in:
rubenwardy
2021-01-29 22:50:18 +00:00
parent 53babc1113
commit f49da74c3a
4 changed files with 33 additions and 9 deletions

View File

@@ -13,6 +13,7 @@ title: Help
* [Package Inclusion Policy and Guidance](/policy_and_guidance/)
* [Package Tags](package_tags)
* [Automatic Update Detection](update_config)
* [Creating Releases using Webhooks](release_webhooks)
* [Package Configuration and Releases Guide](package_config)

View File

@@ -9,6 +9,10 @@ ContentDB offers the ability to automatically create releases using webhooks
from either Github or Gitlab. If you're not using either of those services,
you can also use the [API](../api) to create releases.
ContentDB also offers the ability to poll a Git repo and check for updates
without any web hooks, this is limited to once a day.
See [Automatic Update Detection](/help/update_config/).
The process is as follows:
1. The user creates an API Token and a webhook to use it.

View File

@@ -0,0 +1,27 @@
title: Automatic Update Detection
## Introduction
When you push a change to your Git repository, ContentDB can create a new release automatically or
send you a reminder. ContentDB will check your Git repository every day, but you can use
webhooks or the API for faster updates.
## Setting up
* Set "VCS Repository URL" in your package.
* Go to the Create Release page and click "Set up" on the banner.
* If the "How do you want to create releases?" wizard appears, choose "Automatic".
* Choose a trigger:
* New Commit - this will trigger for each pushed commit on the default branch, or the branch you specify.
* New Tag - this will trigger when a New Tag is created.
* Choose action to occur when the trigger happens:
* Create Release - A new release is created.
* Notification - All maintainers receive a notification under the Bot category, and the package
will appear under "Outdated Packages" in [your to do list](/user/todo/).
## Configuring
See the [Package Configuration and Releases Guide](/help/package_config/) for
documentation on configuring the release creation.
You can set the min/max Minetest version from the Git repository, and also
configure what files are included.