docs(configuration options): Add a CodePen for validating whether a later.js schedule is valid or not.

[paulzakin]

Changes

• Add a CodePen for validating whether a later.js schedule is valid or not.

Context

I think for individuals who aren't familiar with later.js (like me!), it can be difficult to tell whether a schedule is valid. Plus, I found their documentation was missing some sort of "demo" feature. Hence, I made a quick CodePen to validate whether the proposed schedule is valid. It also lists the next two occurences in that schedule. I found this very helpful in reaching an intuitive understanding of how the schedules worked, and it may be helpful to other users as well.

Happy to transfer/surrender ownership of the CodePen to renovate as needed.

Documentation (please check one with an [x])

• I have updated the documentation, or
• No documentation update is required

How I've tested my work (please tick one)

I have verified these changes via:

• Code inspection only, or
• Newly added/modified unit tests, or
• No unit tests but ran on a real repository, or
• Both unit tests + ran on a real repository

[rarkins]

One challenge here - Renovate accepts only a subset of Later.js schedules. For example the default "every 5 minutes" is not a valid Renovate schedule. Can this codepen be made to mimic what Renovate considers valid?

[paulzakin]

@rarkins No promises but happy to take a look at modifying it!

Any pointers on where in the codebase should I look for that Renovate-flavored Later.js? Happy to look myself, but appreciate any points in the right direction!

[rarkins]

The logic is all in https://github.com/renovatebot/renovate/blob/main/lib/workers/repository/update/branch/schedule.ts

[paulzakin]

The logic is all in https://github.com/renovatebot/renovate/blob/main/lib/workers/repository/update/branch/schedule.ts

Awesome will take a look

[paulzakin]

Alright, updated with the rules - take a look:

https://codepen.io/rationaltiger24/pen/ZExQEgK

I do have a question through. For example, running "on Monday before 3am" with the date as 2022-07-07 with a local time in Chicago (UTC-5), will return the next two occurrences as:

7/11/2022, 12:00:00 AM
7/11/2022, 12:00:01 AM

By I assume Rennovate would not run every minute under this configuration? Or am I missing something?

[rarkins]

By I assume Rennovate would not run every minute under this configuration? Or am I missing something?

That's right. Schedules do not trigger Renovate to run. Instead, if Renovate is running AND the schedule matches at that time, then it will create branches/PRs.

[paulzakin]

By I assume Rennovate would not run every minute under this configuration? Or am I missing something?

That's right. Schedules do not trigger Renovate to run. Instead, if Renovate is running AND the schedule matches at that time, then it will create branches/PRs.

That makes sense, but what triggers Renovate to run, assuming it is a GitHub app that is installed

[viceice]

By I assume Rennovate would not run every minute under this configuration? Or am I missing something?

That's right. Schedules do not trigger Renovate to run. Instead, if Renovate is running AND the schedule matches at that time, then it will create branches/PRs.

That makes sense, but what triggers Renovate to run, assuming it is a GitHub app that is installed

It tries to run hourly by default and reduces cycles if no activity on repo. You can always trigger a run from dependency dashboard.

[paulzakin]

By I assume Rennovate would not run every minute under this configuration? Or am I missing something?

That's right. Schedules do not trigger Renovate to run. Instead, if Renovate is running AND the schedule matches at that time, then it will create branches/PRs.

That makes sense, but what triggers Renovate to run, assuming it is a GitHub app that is installed

It tries to run hourly by default and reduces cycles if no activity on repo. You can always trigger a run from dependency dashboard.

Perfect that makes sense to me!

[renovate-release]

🎉 This PR is included in version 32.108.0 🎉

The release is available on:

• GitHub release
• 32.108.0

Your semantic-release bot 📦🚀