Skip to content

Commit 191c9e6

Browse files
committed
more updates for browser build
1 parent 85cdefb commit 191c9e6

File tree

1 file changed

+24
-9
lines changed

1 file changed

+24
-9
lines changed

docs/browser/automatic.md

Lines changed: 24 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -52,30 +52,45 @@ You still need to **take these actions** to ensure a recent build of the *Loop*
5252

5353
### Modified Design for Build Action
5454

55-
The modified design for the build action found in `Loop v3.8.2` and newer is documented in this section. Most people do not need to know this.
55+
The modified design for the build action found in `Loop v3.8.2` and newer is documented in this section.
5656

57-
??? question "Do you want to know more? (Click to open/close)"
58-
**Build Action Redesign**
57+
#### Updated Build Features
5958

60-
When GitHub allowed the use of alive branches with automatic addition of commits to the branch, there was an extra step in the build yml files.
59+
The code that controls the build process was streamlined and enhanced to have these features:
6160

62-
This extra step committed any updates to the alive branch and if no updates were found, committed an extra commit to the alive branch if it had been 20 days since the last change.
61+
* build when updates are found on any Sunday
62+
* build on the second Sunday of the month regardless of update status
63+
* rearrange the order so the check whether to build takes a few seconds
64+
* longer processes are skipped when build is skipped
65+
* remove the concept of alive branches
66+
* remove the requirement that your fork name match the upstream repository name
67+
* enable any branch in your fork to be updated if the upstream repository has the same branch
68+
* if you choose to have a special branch in your fork set to default, the automatic check for updates works for that special branch
6369

64-
This kept your fork from getting stale. GitHub will disable your build actions if no commits have been added for 60 days.
70+
??? question "Do you want to know more? (Click to open/close)"
71+
**Build Action Redesign**
6572

66-
Because this trick is no longer allowed, the creation and use of alive branches was removed.
73+
When GitHub allowed the use of alive branches with automatic addition of commits to the branch, there were extra steps in the build yml file and limitations to which branches would be updated.
6774

68-
This removes an entire section of the build where the code is checked out multiple times to both update the alive branch and update the branch you are building. Now the code is checked out one time to update your branch if you are running main or dev, then later checked out to build if the logic indicates a build is warranted.
75+
* These steps kept your fork from getting stale
76+
* GitHub will disable your build actions if no commits have been added for 60 days
6977

78+
Because this trick is no longer allowed, the creation and use of alive branches was removed. That opened the door to streamline and enhance the build action capabilities.
79+
80+
If you want to follow the detailed design steps taken to reach this new version, see the following LoopFollow PR. (Most people do not need to know this).
7081

82+
* [LoopFollow PR 465: Shift GitHub to check for updates every Sunday and build 2nd Saturday of each month](https://github.com/loopandlearn/LoopFollow/pull/465)
83+
* [LoopFollow PR 470: Update the GitHub build schedule to every Sunday](https://github.com/loopandlearn/LoopFollow/pull/470)
84+
* [LoopFollow PR 477: Revise Browser Build to Remove Alive Branches](https://github.com/loopandlearn/LoopFollow/pull/477)
85+
* [LoopFollow PR 480: Expand and streamline build action](https://github.com/loopandlearn/LoopFollow/pull/480)
7186

7287
### Successful Weekly Action
7388

7489
Normally, you will see a successful `build action` once a week. This happens every Sunday (as soon as your version is 3.8.2 or newer).
7590

7691
> Previously the build action would run every Wed or the first of the month, when GitHub resources were impacted.
7792
78-
If there are no updates to the `main` branch, your actions show a very short, successful `build action` as shown in the graphic below. It only takes about a minute because the logic says - no update then skip the build.
93+
If there are no updates to the `main` branch, your actions show a very short, successful `build action` as shown in the graphic below. It only takes a few seconds because the logic says - if no update was detected and it is not the second Sunday, then skip checking the certificates and skip the build.
7994

8095
![normal weekly check for updates when there are no updates](img/normal-check-for-updates.png)
8196

0 commit comments

Comments
 (0)