Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improved usage instructions in readme file #18

Merged
merged 4 commits into from
Feb 1, 2024

Conversation

gennadiylitvinyuk
Copy link
Contributor

Q A
Documentation yes

Description

Improved usage instructions
Fixed docker image name in local usage example

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@boesing boesing requested a review from weierophinney April 7, 2021 15:51
README.md Outdated
```yaml
name: "Continuous Integration"

on: [push, pull_request]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I should probably explain why I used the following:

on:
  pull_request:
  push:
    branches:
      - '[0-9]+.[0-9]+.x'
      - 'refs/pull/*'
      tags:

What I found (through a LOT of trial and error), was the following:

  • I started with just pull_request. When I did that, additional pushes to the PR branch would not trigger checks.
  • When I added "push", without qualifications, I would get TWO runs of checks on opening a PR, one for the PR, and one for the branch. This led to unnecessary builds.
  • If I added branches to the mix (as I did) to qualify which branch triggered a build... tags would not build.

Basically, I found on: [push, pull_request] was building too much, which led me to qualify the values.

If you can point to repos where you have rolled out a workflow with the simplified entry, please link me to it so I can see the build history and make sure it's working the way I would want it to; until then, I'm a bit wary of this change.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've thought that - '[0-9]+.[0-9]+.x' might be too much for projects which do not follow the branch strategy required by the laminas-automatic-releases GHA.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could demonstrate two variants, then, maybe:

  • The one we're using (and link to automatic-releases to detail the why aspect)
  • A more general one (and detail issues such as double-runs, if they're still valid)

@boesing boesing changed the base branch from 1.5.x to 1.14.x October 10, 2021 20:22
@Ocramius Ocramius requested a review from froschdesign November 8, 2022 09:17
@froschdesign froschdesign changed the title Update README.md Improved usage instructions in readme file Nov 8, 2022
@Xerkus Xerkus changed the base branch from 1.14.x to 1.38.x January 31, 2024 15:35
gennadiylitvinyuk and others added 3 commits February 1, 2024 02:55
Improved usage instructions
Fixed docker image name in local usage example

Signed-off-by: Gennadiy Litvinyuk <gennadiy@gmail.com>
Changed events

Signed-off-by: Gennadiy Litvinyuk <gennadiy@gmail.com>
…te CI runs

Signed-off-by: Aleksei Khudiakov <aleksey@xerkus.pro>
@Xerkus
Copy link
Member

Xerkus commented Jan 31, 2024

Rebased to resolve conflicts. Added example with reusable workflow. Added mention of potential duplicate CI runs.

@Xerkus Xerkus requested a review from weierophinney January 31, 2024 16:57
@Xerkus Xerkus added this to the 1.38.0 milestone Jan 31, 2024
Copy link
Member

@weierophinney weierophinney left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor suggestions, but changes look good, @Xerkus .

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
Co-authored-by: Matthew Weier O'Phinney <matthew@weierophinney.net>
Signed-off-by: Aleksei Khudiakov <aleksey@xerkus.pro>
@Xerkus Xerkus merged commit ead082d into laminas:1.38.x Feb 1, 2024
3 checks passed
@Xerkus
Copy link
Member

Xerkus commented Feb 1, 2024

@gennadiylitvinyuk thank you

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants