pages: add info about test delivery button not working for pages webhook verification (#853)

Added a warning about the test delivery button being misleading for verifying pages webhook setup.

When pressed on a correctly configured webhook, it results in an error: `401 ref refs/heads/main not in allowlist [refs/heads/pages]`. This is both confusing and misleading; changing the branch filter also doesn't fix it.

I was helping a friend set up a pages site and we ran into this and were stuck until we guessed that the test itself doesn't work.

The docs don't explicitly say to use the test delivery button, but it is *right there* so we assumed we should use it. I think a note about not using it would help.

ty codeberg ur great

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/853
Reviewed-by: Catherine <whitequark@whitequark.org>
This commit is contained in:
Dan Volchek 2026-07-21 16:03:53 +02:00 committed by Robert Wolff
parent 69c40e100a
commit 647637a7c6

View file

@ -43,6 +43,12 @@ There are two ways to get started with Codeberg Pages on git-pages:
This page documents the first method. See the [separate page on using Forgejo Actions](/codeberg-pages/forgejo-actions/) for information on the second method.
{% admonition "Warning" %}
Do not use the "Test delivery" button to verify the webhook is set up correctly. It will fail with an error - this is expected. Instead, push or upload your content to the branch and then verify the associated webhook delivery or visit your website URL.
{% endadmonition %}
### User/organization websites
1. Create a repository called `pages` under your own username or under the organization you want to create a website for