Skip to content

Commit a6c7540

Browse files
committed
tweaks to readme/setup
1 parent ab9cc7b commit a6c7540

File tree

2 files changed

+8
-6
lines changed

2 files changed

+8
-6
lines changed

Readme.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ I have an Umbraco (16) Cloud site running at https://opensourcecloud.lotte.dev.
44

55
I'm using this public GitHub repository as the "working" directory for that project: all development on the site should be done here, not committed directly to the Cloud git repo. There's a GitHub Action that gets everything it needs from GitHub Secrets to push to Cloud and update the live site!
66

7-
*BTW I've written [this blog post](https://dev.to/lottepitcher/open-sourcing-an-umbraco-cloud-site-mjj) explaining the background to this project*
7+
I've written [this blog post](https://dev.to/lottepitcher/open-sourcing-an-umbraco-cloud-site-mjj) explaining the background to this project and it's limitations.
88

9-
If you want to try it yourself then follow the steps defined in [Setup.md](Setup.md).
9+
If you want to try this on your own Umbraco Cloud site, then follow the instructions in [Setup.md](Setup.md).
1010

1111
But first we'd love people to try running the site locally and contributing back - see the steps below. Would a workflow like this enable the community to contribute to the new Umbraco Community site that we're currently building on Cloud?
1212

Setup.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@
33
> [!IMPORTANT]
44
> A quick Public Service Announcement before we start … please remember that you can’t just delete already committed sensitive data and make the repository public: that sensitive data will still be visible in the commit history! You knew this, right?! If you need to remove committed sensitive data, [GitHub has guidance on this](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository).
55
6+
## Steps To Follow
7+
68
1. Switch on the Umbraco CI/CD Flow for the site in the Umbraco Cloud Portal:
79

810
- Configuration > Advanced > Umbraco CI/CD Flow - toggle to Activate
@@ -95,15 +97,15 @@ We're using the Umbraco Deploy Import and Export features for this. There are in
9597

9698
## Version Upgrades
9799

98-
You can configure Cloud to not do minor version updates automatically. Patch updates however will always be done automatically. If this happens your next deployment would fail as your Umbraco version is out of sync. The solution to this is to manually update your working repository to use the latest packages, test locally (of course!) and try another deployment.
100+
You can configure Cloud to NOT automatically do minor version updates. Patch updates however will always be done automatically. If this happens your next deployment would fail as your Umbraco version is out of sync. The solution to this is to manually update your working repository to use the latest packages, test locally (of course!) and try another deployment.
99101

100102
> [!NOTE]
101-
> If you change the configuration of your environments via the Umbraco Cloud portal, Cloud will automatically update and commit those changes to the `umbraco-cloud.json` file. You must update your GitHub `UMBRACO_CLOUD_JSON` secret with the new value, otherwise future deployments will break!
103+
> If you change the configuration of your environments via the Umbraco Cloud portal, Cloud will automatically update and commit those changes to the `umbraco-cloud.json` file. You must update your GitHub `UMBRACO_CLOUD_JSON` secret value with the updated contents of that file, otherwise future deployments will break!
102104
103105
## A Final Disclaimer!
104106

105-
The above all worked on my machine, your mileage may vary…
107+
The above all worked on our machines, your mileage may vary…
106108

107109
As we are asking the community for feedback on this approach, things might have changed a bit since these instructions were posted. We’ll endeavour to keep them up-to-date as we go! Please raise an issue here if anything isn't clear or not working for you.
108110

109-
If you want to message us about any of this, why not post a message in the \#contact-devrel channel in the [Umbraco Discord server](https://discord.umbraco.com) . We’ll see it!
111+
If you want to message us about any of this, why not post a message in the \#contact-devrel channel in the [Umbraco Discord server](https://discord.umbraco.com). Or if you'd prefer, you can send us a message via https://umbra.co/contact-devrel.

0 commit comments

Comments
 (0)