platformsh / platformsh-docs

Platform.sh documentation. Templates available at https://github.com/platformsh-templates/
https://docs.platform.sh/
Creative Commons Attribution Share Alike 4.0 International
102 stars 332 forks source link

[Upsun] Resource initialization, git integration clarification #3807

Open gilzow opened 8 months ago

gilzow commented 8 months ago

Where on docs.platform.sh should be changed?

https://docs.upsun.com/manage-resources/resource-init.html#define-a-resource-initialization-strategy

What exactly should be updated?

Under the With a source integration tab, the included instructions are for how to set up a resource initialization strategy when creating a new git integration. But the title of this section is for when you have an existing integration. Therefore it seems odd we've included instructions for a new integration here, and especially odd that we show it before including the instructions on how to update an existing integration.

I would suggest moving this block from this page to the page on creating GitHub integrations.

In this same section, the instructions for creating an integration reference the platform CLI tool instead of upsun.

Same section, the link on "set up a GitHub integration" in the phrase

For example, if you set up a GitHub integration, use the following options:

Has no href attribute so doesn't link to anything.

Additional context

No response

gilzow commented 8 months ago

console does not allow you to set the resources-init strategy when creating a new github integration in the console, so having clear instructions on how to update the integration is important.

gilzow commented 7 months ago

Additionally, the link on "Upsun default resources" has an empty href attribute. See image.

image