Skip to content

Commit

Permalink
[sync] Updates from awesome-template
Browse files Browse the repository at this point in the history
Signed-off-by: kdeldycke <github-action@actions-template-sync.noreply.github.com>
  • Loading branch information
kdeldycke committed Mar 4, 2024
1 parent 9aca815 commit 19596d8
Show file tree
Hide file tree
Showing 10 changed files with 147 additions and 83 deletions.
14 changes: 8 additions & 6 deletions .github/ISSUE_TEMPLATE/new-link.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -40,13 +40,15 @@ body:
label: Self checks
options:
- label: >
I have [read the Code of
Conduct](https://github.com/kdeldycke/awesome-billing/blob/main/.github/code-of-conduct.md)
I have [read the Code of Conduct
](https://github.com/kdeldycke/awesome-template/blob/main/.github/code-of-conduct.md)
- label: >
I applied all rules from the [Contributing
guide](https://github.com/kdeldycke/awesome-billing/blob/main/.github/contributing.md)
I applied all rules from the [Contributing guide
](https://github.com/kdeldycke/awesome-template/blob/main/.github/contributing.md)
- label: >
I have checked there is no other [Issues](https://github.com/kdeldycke/awesome-billing/issues) or [Pull
Requests](https://github.com/kdeldycke/awesome-billing/pulls) covering the same topic to open
I have checked there is no other
[Issues](https://github.com/kdeldycke/awesome-template/issues) or [Pull
Requests](https://github.com/kdeldycke/awesome-template/pulls) covering the same topic
to open
validations:
required: true
108 changes: 106 additions & 2 deletions .github/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

Your contributions are always welcome! Here are some guidelines.

## Editorial line

The editorial line is [describe in the intro of the main list](https://github.com/kdeldycke/awesome-engineering-team-management#readme).

Items are roughly ordered like so:

1. At first we'll find content appealing to software developers or new managers. We're reaching for accessibility and targets the wider audience and provide a gentle introduction.
1. Then we can have a couple of real use-cases or anecdotes, which makes the subject more hands-on and relatable.
1. Third we might add a couple of reference material to generalize concepts, provide methodical solutions and expose broader thinking frameworks.
1. At the end comes the most cynical or bleak content, which have some utility as cautionary tales, or as warning signals of deteriorating conditions.

## Status

This repository has reached an equilibrium state. We are past its accumulation phase, and in the middle of the curation process. Meaning we're more into refining its concepts, smooth the progression and carefully evaluating the addition of new content.
Expand All @@ -24,7 +35,7 @@ This repository has reached an equilibrium state. We are past its accumulation p

Have your pull-request pass the [official Awesome List's linter](https://github.com/sindresorhus/awesome-lint).

No extra work is required here as it is [already integrated by the way of GitHub actions](https://github.com/kdeldycke/awesome-billing/tree/main/.github/workflows).
No extra work is required here as it is [already integrated by the way of GitHub actions](https://github.com/kdeldycke/awesome-template/tree/main/.github/workflows).

To run the linter locally, do:

Expand Down Expand Up @@ -69,7 +80,7 @@ If one of these rule conflict with the linter, the linter's rule should takes pr

- Try to provide an actionable TL;DR as a description, quoting the original text if it stands by itself.

- [Removes `TL;DR:` prefix in description](https://github.com/kdeldycke/awesome-billing/commit/d5496dda9ecb9c6aa1bc329c318caa07a7eeb020). Every description is a short summary anyway.
- [Removes `TL;DR:` prefix in description](https://github.com/kdeldycke/awesome-engineering-team-management/commit/da298ec1c39fe62fd4553e1a6de0ad4494602c57). Every description is a short summary anyway.

- Quotes should be properly delimited with the `` and `` curved quotation marks.

Expand Down Expand Up @@ -113,3 +124,96 @@ One-liners to fix-up some common formatting mistakes. Use with great caution and
```

[Other one-liners are available](https://kevin.deldycke.com/2006/12/text-date-document-processing-commands/) on my blog.

## FAQ

Some cases to illustrate the curation process.

### Can I rewrite your sentences and paragraphs?

Yes. I'm a non-native speaker, so some of my writings might be a little bit fancy. If you can propose a shorter, to the point, and accurate version of my initial text, go for it! These improvements [adds a lot of readability for both kind of readers](https://github.com/kdeldycke/awesome-falsehood/pull/105).

### Can I propose YouTube videos for the list?

Yes, but try to pin-point the start of the video to a relevant time. Like with the `&t=13m30s` parameter in YouTube URLs.

Better than a video: have a link to its written transcript. Or presentation slides if it doesn't dillute the point being made.

### Can I link to an X thread?

Yes, but try to search first in the content produced by the author: sometimes the said author edited its rant into a more digestible article elsewhere. We'll prefer to link to that.

### How to prevent link-rot?

[As pointed by a contributor](https://github.com/kdeldycke/awesome-engineering-team-management/issues/52#issue-1499417056):

> The links here have a tendency to go offline. For this to be a resource of long term value, link-rot can be avoided by archiving the pages.
Which is true.

I have no issue replacing the original URL with an alternative archived/cached link if the original is no longer reachable.

Broken URLs are frustrating. We will fix them one by one. Some have been moved to a new domain. Some have completely disappear, so we'll replace them with a `archive.org` link.

If you find a broken one, please propose a PR to fix it. Or just report it as an issue and I'll do the work.

### How are you going to archive articles that went offline?

This question points to the paradox that we need to archive them *before* they go offline.

There is no rush to pre-emptively archive content. Incentives exists for others to do it:

- This list is popular enough for its content to be picked up by regular archival crawlers.
- Popular content in this list are naturally archived by users who value them.
- Authors who cares about their content, or benefits from the SEO juice this list provides, have an incentive to keep them available at their original URL.

Despites these incentives, there is still a non-zero chance for content to disappear entirely from the web, with no archived copy in `archive.org`. That's not the end of the world. Maybe the content wasn't worth it, and not good for inclusion in the first place. Think of this edge-case as a natural selection process on content, which helps natural curation.

### Why removes inactive GitHub projects?

Unmaintained GitHub repositories are usually [archived by their owners](https://docs.github.com/en/repositories/archiving-a-github-repository/archiving-repositories). But some are de-facto unmaintained, or abandoned as-is by their author, without being explicitly archived.

Either way, if the space they addresses is crowded, and there are other repositories referenced in the list, the link is a good candidate for deletion to reduce noise.

On the other hand, if the project has been forked or rebooted elsewhere, we can now point out to the new location.

### Why my commercial project is not in the list?

Probably because the core content is behind a paywall. Especially if there are better resources online, which are more extensive, and freely accessible.

This is especially true for SaaS and other licensed software. If there is an open-source project available, we'd rather point to that instead of commercial solutions.

These alternatives don't need to be better. They qualify if they're good enough to derives inspiration from, or starts something without barriers to entry.

So for as set of multiple overlapping projects, we will consider commercial ones as duplicates and remove them, to keep the list lean.

### Why my link was rejected?

If your link was rejected, it must have been motivated and explained to the contributor as a comment to your PR.

Some reasons for rejection, which often overlaps, includes:

- deviance from these contribution guidelines
- violation of the [code of conduct](code-of-conduct.md)
- duplicate content
- lack of motivation in what the new link adds to the existing corpus
- lack of originality
- overcrowded section that [needs more curation than additional content](https://github.com/kdeldycke/awesome-iam/pull/76)
- [commercially-sponsored content only proposed for SEO](https://github.com/kdeldycke/awesome-falsehood/pull/31#issuecomment-407667679)
- lack of feedback from the contributor on raised questions

### How can I force a link into the list?

If your contribution has been declined, there is a way to bypass the curation rules. You can [purchase a sponsorship](https://github.com/sponsors/kdeldycke) and have your product, logo and link at the top of this repository! 🤗 Like [Descope did for a year](https://twitter.com/kdeldycke/status/1676963147104784386) on the [awesome IAM list](https://twitter.com/kdeldycke/status/1676963147104784386).

## FAQ (falsehoods)

This questions are specifics to the [Awesome Falsehood](https://github.com/kdeldycke/awesome-falsehood) project.

### Why don't you copy the falsehoods in the list?

This might be a good idea to compile all falsehoods in the repository. It would allow the community to maintain them, and enrich them. It could also improve the overall quality as most external articles don't make the effort to illustrate or explain why a falsehood is a falsehood.

But that is a big endeavor, so to keep things simple, we just make a collection of external articles in this list. In the mean time, if you'd like to add falsehoods, I will ask potential contributors to [host them elsewhere](https://github.com/kdeldycke/awesome-falsehood/issues/46).

Also, if we had to host the raw falsehoods in this repository, we might have to [check on the licence and seek permission from the original author](https://github.com/kdeldycke/awesome-falsehood/issues/24#issuecomment-354112401).
25 changes: 23 additions & 2 deletions .github/gitleaks.toml
Original file line number Diff line number Diff line change
@@ -1,11 +1,32 @@
[allowlist]
description = "False positives"
commits = [

### kdeldycke/awesome-billing
# Twitter status IDs.
"5b54ac1befb7a768a18b2abd4a7b091766ee7609",
"4607e5923f1889ce5136b1a6bdfbddd769cd7fc3",
"1cfd0513359a5ce20b538b6a637d40c4cc50a37f",


### kdeldycke/awesome-engineering-team-management
# Twitter status IDs.
"044ccf813c180d1b52fa550549f1e3ffe7ad3176",
"4ee04962090c60f9d2bd26e507584c95b2f039cb",
"e945e90fbcd4b610d71cbe766b1c909b51c674a5",
"bdae66b4dbc54fcf66aa2c5bf61598c894a6172d",
"6462b4a4b0335823f2a9e8412a1c10a38561900e",
"ac1dd92507ed071da3ac5270484a152bfef93aa2",
"e9eb3864157f504cb29fab33d4f63748302c963d",
"a43eef1b55fff47879fe671abbebc7e279d59999",
"1a5e33dd31d129a1335ae2418ec43bf1d43c3760",
"0e05ffafc90dd4ea337aca7372c983e143ba48a8",
"0e93d0ced146e4a32a1838b1aa4dbf2d20703964",
"df0e49b612e68b9389c671463640e5d17b479231",
"b743e4aecc5822c51aa088312b20d4965720aa7e",
"94c532529b78b20e9363bded9e2788dd03a59832",
"f0fe92563a14f93dbe07579ff735b844cfb69a7d",
"a804606fb0794615df5c078ab220b615796e1ba9",
"14d523e38ebe8f2859646c4cb9736b1843802476",
"36c488d8b52f66120d51b0fbb7b93667453461fe",
"1da97b40558cd6c5941edd2db9f9a58407d5a3bf",
"56f8e6771c88625ed82e6663961fc2874c53f874",
]
6 changes: 3 additions & 3 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,6 @@ This new link is special because...

### Self checks

- [ ] I have [read the Code of Conduct](https://github.com/kdeldycke/awesome-billing/blob/main/.github/code-of-conduct.md)
- [ ] I applied all rules from the [Contributing guide](https://github.com/kdeldycke/awesome-billing/blob/main/.github/contributing.md)
- [ ] I have checked there is no other [Issues](https://github.com/kdeldycke/awesome-billing/issues) or [Pull Requests](https://github.com/kdeldycke/awesome-billing/pulls) covering the same topic to open
- [ ] I have [read the Code of Conduct](https://github.com/kdeldycke/awesome-template/blob/main/.github/code-of-conduct.md)
- [ ] I applied all rules from the [Contributing guide](https://github.com/kdeldycke/awesome-template/blob/main/.github/contributing.md)
- [ ] I have checked there is no other [Issues](https://github.com/kdeldycke/awesome-template/issues) or [Pull Requests](https://github.com/kdeldycke/awesome-template/pulls) covering the same topic to open
2 changes: 1 addition & 1 deletion .github/workflows/autofix.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ name: Autofix
jobs:

autofix:
uses: kdeldycke/workflows/.github/workflows/autofix.yaml@v3.3.4
uses: kdeldycke/workflows/.github/workflows/autofix.yaml@v3.3.0
2 changes: 1 addition & 1 deletion .github/workflows/autolock.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ name: Autolock
jobs:

autolock:
uses: kdeldycke/workflows/.github/workflows/autolock.yaml@v3.3.4
uses: kdeldycke/workflows/.github/workflows/autolock.yaml@v3.3.0
67 changes: 2 additions & 65 deletions .github/workflows/docs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -9,68 +9,5 @@ name: Docs

jobs:

#docs:
# uses: kdeldycke/workflows/.github/workflows/docs.yaml@v3.3.4


awesome-template-sync:
name: Sync awesome template
if: >
startsWith(github.event.repository.name, 'awesome-')
&& github.event.repository.name != 'awesome-template'
runs-on: ubuntu-22.04
# We need custom PAT through the whole job so we get workflow permissions to update all the boilerplate .github
# files from awesome-template.
steps:
- name: Initial checkout
uses: actions/checkout@v4.1.1
with:
token: ${{ secrets.WORKFLOW_UPDATE_GITHUB_PAT || secrets.GITHUB_TOKEN }}
fetch-depth: 0

- name: Sync from template repo
id: template_sync
uses: AndreasAugustin/actions-template-sync@v1.8.1
with:
github_token: ${{ secrets.WORKFLOW_UPDATE_GITHUB_PAT || secrets.GITHUB_TOKEN }}
source_repo_path: kdeldycke/awesome-template
pr_title: "[sync] Updates from `awesome-template`"
pr_commit_msg: "[sync] Updates from awesome-template"
pr_branch_name_prefix: "sync-awesome-template"
pr_labels: "📚 documentation"

- name: Checkout new template sync branch
uses: actions/checkout@v4.1.1
with:
token: ${{ secrets.WORKFLOW_UPDATE_GITHUB_PAT || secrets.GITHUB_TOKEN }}
ref: ${{ steps.template_sync.outputs.pr_branch }}
fetch-depth: 0

# XXX We cannot rely on peter-evans/create-pull-request to manage the push of the new commit to the PR, as it
# ends up with a: "Unexpected error: fatal: could not open '.git/COMMIT_EDITMSG': Permission denied".
# See: https://github.com/AndreasAugustin/actions-template-sync/issues/484
# So we manage the next steps with bare git calls.

- name: Update repo URLs
# Replace "/kdeldycke/awesome-template/" in URLs by "/kdeldycke/awesome-<repo_id>/".
run: >
find ./.github/ -type f -iregex ".*\.\(md\|yaml\)$" -print -exec sed -i
"s/\/kdeldycke\/awesome-template\//\/kdeldycke\/${{ github.event.repository.name }}\//g" "{}" \;
- name: Setup Git user
run: |
git config --global user.name "${{ github.actor }}"
git config --global user.email "${{ github.actor }}@users.noreply.github.com"
- name: Deactivate LFS
# XXX Was introduced in https://github.com/AndreasAugustin/actions-template-sync/commit/5335a55
run: |
git config lfs.https://github.com/kdeldycke/${{ github.event.repository.name }}.git/info/lfs.locksverify false
- name: Merge change to previous commit
run: |
git commit --all --amend --no-edit
- name: Push new commit to PR
run: |
git push --force
docs:
uses: kdeldycke/workflows/.github/workflows/docs.yaml@v3.3.0
2 changes: 1 addition & 1 deletion .github/workflows/label-sponsors.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ name: Label sponsors
jobs:

label-sponsors:
uses: kdeldycke/workflows/.github/workflows/label-sponsors.yaml@v3.3.4
uses: kdeldycke/workflows/.github/workflows/label-sponsors.yaml@v3.3.0
2 changes: 1 addition & 1 deletion .github/workflows/labels.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ name: Labels
jobs:

labels:
uses: kdeldycke/workflows/.github/workflows/labels.yaml@v3.3.4
uses: kdeldycke/workflows/.github/workflows/labels.yaml@v3.3.0
2 changes: 1 addition & 1 deletion .github/workflows/lint.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@ name: Lint
jobs:

lint:
uses: kdeldycke/workflows/.github/workflows/lint.yaml@v3.3.4
uses: kdeldycke/workflows/.github/workflows/lint.yaml@v3.3.0

0 comments on commit 19596d8

Please sign in to comment.