resume 13.1.0
Install from the command line:
Learn more about npm packages
$ npm install @suddenlygiovanni/resume@13.1.0
Install via package.json:
"@suddenlygiovanni/resume": "13.1.0"
About this version
This is my personal resume data; It is based on an extension of the resume.json schema published by https://jsonresume.org .
It is follow sem ver versioning; let's define what constitutes a MAJOR, MINOR, and PATCH change in the context of the resume.yml file:
- MAJOR: A major change would be a significant addition or modification to the resume. This could include adding a new job or education entry, or making a significant change to an existing entry. For example, changing the job title or the institution of an education entry would be considered a major change.
- MINOR: A minor change would be a small addition or modification that doesn't significantly alter the existing information. This could include adding new responsibilities or achievements to a job entry, or adding a new certification. These changes are backward compatible as they don't alter the existing structure or content in a significant way.
- PATCH: A patch change would be a small fix that doesn't add new information or significantly alter existing information. This could include fixing a typo, making a small change to the formatting, or rephrasing existing content without changing its meaning. These definitions should be used as a guide when deciding how to increment the version number based on the changes made to the resume.json file.
graph TB
A[Start: v1.0.0] --> B{Is it a new entry or a major modification?}
B -->|Yes, e.g. new job or education entry| C[Increment Major Version: v2.0.0]
B -->|No| D{Is it a minor detail addition?}
D -->|Yes, e.g. new role or responsibilities within the same company| E[Increment Minor Version: v1.1.0]
D -->|No| F{Is it a bug fix or minor change?}
F -->|Yes, e.g. fixing a typo or small rephrasing of existing content| G[Increment Patch Version: v1.0.1]
C --> H1[Update CHANGELOG.md: v2.0.0]
E --> H2[Update CHANGELOG.md: v1.1.0]
G --> H3[Update CHANGELOG.md: v1.0.1]
H1 --> I[Commit and Tag with Version Number]
H2 --> I
H3 --> I
I --> J[End]
In this project, I use GitHub webhooks
to keep external services updated with changes to the main branch. While these external services could pull
updates from GitHub, this could lead to a high number of requests. To mitigate this, these services might introduce a cache. However, this cache needs to be invalidated when new changes are made to the main branch. To facilitate this, I provide a push
behavior using webhooks. This allows me to notify these external services when changes occur, enabling them to invalidate their cache and pull the latest changes.
Here's a simplified workflow:
graph TB
A[Start: Commit Pushed to Main Branch] --> B[Trigger Webhook]
B --> C[External Service Receives Payload]
C --> D[Perform Necessary Action]
D --> E[End]
In this workflow:
- A commit is pushed to the main branch.
- This triggers the webhook.
- The external service receives the payload from GitHub.
- The external service performs the necessary action (e.g., sending a notification).
- The process ends.
To set up a webhook on GitHub, follow these steps:
- Go to the main page of your GitHub repository and click on "Settings".
- In the left sidebar, click on "Webhooks".
- Click on "Add webhook".
- In the "Payload URL" field, enter the URL where you want GitHub to send the payloads.
- In the "Content type" field, select how you want the data to be sent. Usually, this is "application/json".
- In the "Secret" field, you can enter a secret token. This token will be sent with the payload, and the receiving server can use it to verify that the payload is indeed from GitHub.
- In the "Which events would you like to trigger this webhook?" section, select the events that should trigger the webhook.
- Click on "Add webhook" to save your changes.
Now, whenever the selected events happen in your repository, GitHub will send a payload to the URL you specified. Your external service can then use this payload to perform whatever action is necessary.
- git
main
branch must only composed of released versions (tags) - each change ending merged in main needs to:
- change the semver version number
- update the change log with corresponding description
- tag that commit with corresponding version number
graph TB
A[Start: Pull Request Created or Updated] --> B{Run Tests and Linters}
B -->|Tests Pass| C[Pull Request Merged]
B -->|Tests Fail| D[Fix Issues and Update Pull Request]
D --> B
C --> E[Increment Version Number and Update CHANGELOG.md]
E --> F[Commit and Tag with Version Number]
F --> G[New Tag Created]
G --> H[Trigger Deployment Process]
H --> I[Deployment Completed]
I --> J[Send Notification]
J --> K[End]