docs(publish gitlab pages): Update publish comment on gitlab

[niclasheinz]

I have noticed that since a few GitLab releases, unique domains are used by default for GitLab Pages deployments, for example https://website-5c034c.gitlab.io/ instead of niclasheinz.gitlab.io/website. I have written a small blog post that helps users to use the desired domain.

[squidfunk]

Thanks for the PR. Is this also true for GitLab's hosted offering, or only for on-premise installations?

[niclasheinz]

I discouvered it on gitlab.com (SaaS)

[squidfunk]

Thanks! So if it's such a central thing, I think it would be a better idea to list the steps that you listed in your blog post directly on our publishing guide, so we can keep the AX better – less indirection. If and only if this is okay for you.

[niclasheinz]

Yes, sure! I just did this so that the site doesn't get too crowded with information. Should I make an extra page or is it enough if I just write it down under the CI codeblock?

[squidfunk]

Just under the code block is fine. I think we can limit it to something like (extracted from your article):

CODE BLOCK

${Insert 1 sentence explanation on domain names}. To switch from a unique domain to the traditional URL structure, follow these steps:

1. Locate Your Repository
2. Go to Settings > Pages in the repository menu.
3. In the Unique domain settings section, uncheck the box labeled Use unique domain.
4. Click Save changes to apply the update.

Now, you ...

And we should link to the release notes, as you did in your article.

[niclasheinz]

Should I use such a box to keep the content clearer?

[squidfunk]

No, please just use verbatim text. It's not a recommendation, but the expected outcome (= users will 99% want a proper URL, and not a random identifier), so it should be part of the normal flow.

[niclasheinz]

@squidfunk it's ready for review.

[squidfunk]

Only some minor changes related to formatting ☺️

[niclasheinz]

I solved the styling issues

[squidfunk]

Perfect, thanks for your work!

[niclasheinz]

You're welcome. Happy new year!

[squidfunk]

Happy new year to you too!