From dd7243da2646dd5de9f464b3da40ecdaa0a22554 Mon Sep 17 00:00:00 2001 From: nparker94 Date: Wed, 28 Jan 2026 16:28:41 +0000 Subject: [PATCH 1/6] WIP Suggested structure for homepage of employability guide --- .../content/employability/_index.md | 29 ++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/org-cyf-guides/content/employability/_index.md b/org-cyf-guides/content/employability/_index.md index 32bdfd96d..0e4926ad0 100644 --- a/org-cyf-guides/content/employability/_index.md +++ b/org-cyf-guides/content/employability/_index.md @@ -1,5 +1,32 @@ +++ title="Employability" -description="Your guides for getting job ready" +description="Your guide for getting job ready" menu=["everyone"] +++ + +This guide is to help to you get a job and hit the ground running once you start. It is written sequentially based on the typical steps you would take in a job seeking process but each individual guide can be use as a reference to dig into at any point as well. + +The first thing you need to do is work out what sort of role you want and what sort of company you want to work for. If you are already clear on this then fantastic, if you not please read the following guide to help you with your decision. + +### How to decide what job I want (add link) + +Then before you apply ideally you will have the follow things ready. It is not mandatory to have a LinkedIn profile and portfolio site, however it will increase your chances of getting a job so we recommend creating them. + +### CVs (add link) +### LinkedIn (add link) +### Porfolio site (add link) + +Once you have prepared the resources and know what sort of jobs you want to apply for, it's time to really start your search + +### Job search (add link) +### High level application process (add link) +### Cover letters (add link) +### Networking (add link) +### Interviews (add link) + +Once you have passed the interview process, you should read the + +### Employment contracts and offers (add link) +### References and security checks (add link) +### First 90 days in a job (add link) +### Lifelong learning (add link) From ffe3b9474c54b4cf34926d562961726de383d15f Mon Sep 17 00:00:00 2001 From: nparker94 Date: Thu, 29 Jan 2026 08:36:45 +0000 Subject: [PATCH 2/6] Adding more detail to the contributors.md to make it easier for first time contributors --- .gitignore | 7 ++++++- CONTRIBUTING.md | 20 +++++++++++++++++++- org-cyf-guides/go.mod | 4 ++-- org-cyf-guides/package-lock.json | 7 ++++--- 4 files changed, 31 insertions(+), 7 deletions(-) diff --git a/.gitignore b/.gitignore index 92dc17ec8..6ab79d995 100644 --- a/.gitignore +++ b/.gitignore @@ -26,9 +26,14 @@ npm-debug.log* yarn-debug.log* yarn-error.log* +org-cyf-guides/go.mod +org-cyf-guides/package-lock.json + # CI uses package-lock.json, don't allow yarn.lock yarn.lock # Local Netlify folder .netlify -.env \ No newline at end of file +.env +org-cyf-guides/go.mod +org-cyf-guides/package-lock.json diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0b9e9158c..38138004d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -66,7 +66,7 @@ As this front end composes many different repos, please open an issue in the rep You need the following software packages to run this curriculum: * `go` -* `hugo` (must be the extended version) - we recommend version 0.136 extended +* `hugo` (must be the extended version) - please use version 0.136 extended, as more recent versions have a breaking change. * `npm` On macOS: @@ -131,6 +131,24 @@ npx pagefind --site "public" --serve And go to http://localhost:1414/ to see the PageFind-served site with search enabled; but there is no hot reload. You can run hugo on http://localhost:1313/ at the same time. + +## Checklist before raising a PR + +Please check the following before raising a PR. Unless you have been given permissions to push to the code your future repo you will have to create a fork of the repo and then raise a PR from that to the main repo. You will also not be able to add reviewers yourself unless you have been given permission, but you can mention people in the PR description to bring it to their attention. + +If you are working on a GitHub issue please mention the reference in the PR, but if it is a small improvement it does not need one. + +- [ ] I have checked my spelling and grammar with an [automated tool](https://www.grammarly.com/grammar-check) +- [ ] I have previewed my changes to check the [markdown renders](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) as I intend +- [ ] I have run my code to check it works +- [ ] My changes follow our [Style Guide](https://curriculum.codeyourfuture.io/guides/code-style-guide) + +## Deploy preview + +When you raise a PR, Netlify will automatically try and deploy your branch and give you a custom URL so you can view a preview of your changes and anyone reviewing your PR can see the preview without needing to run the branch locally. + +However, if you do not have permissions to push to the CodeYourFuture repo and are creating a PR from a fork of the review, someone with the correct permissions will have to approve the Netlify build. Please ask in the #curriculum channel in slack to get the build approved. If you have push permissions then the build will happen automatically. + ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): diff --git a/org-cyf-guides/go.mod b/org-cyf-guides/go.mod index e6f2dd2d5..ebab863ee 100644 --- a/org-cyf-guides/go.mod +++ b/org-cyf-guides/go.mod @@ -3,8 +3,8 @@ module github.com/CodeYourFuture/curriculum/org-cyf-guides go 1.24.5 require ( - github.com/CodeYourFuture/curriculum/common-content v0.0.0-20241008095008-281a5517463f // indirect - github.com/CodeYourFuture/curriculum/common-theme v0.0.0-20241008095008-281a5517463f // indirect + github.com/CodeYourFuture/curriculum/common-content v0.0.0-20250801130816-705636729ea4 // indirect + github.com/CodeYourFuture/curriculum/common-theme v0.0.0-20250801130816-705636729ea4 // indirect github.com/CodeYourFuture/curriculum/org-cyf-theme v0.0.0-20240818070728-e8702788f7cb // indirect ) diff --git a/org-cyf-guides/package-lock.json b/org-cyf-guides/package-lock.json index 279946fa2..40290e0da 100644 --- a/org-cyf-guides/package-lock.json +++ b/org-cyf-guides/package-lock.json @@ -18,10 +18,11 @@ } }, "node_modules/cross-spawn": { - "version": "7.0.3", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", - "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", "dev": true, + "license": "MIT", "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", From 5bc72f41b76b937ce7f235f8590cff304bf51961 Mon Sep 17 00:00:00 2001 From: nparker94 Date: Thu, 29 Jan 2026 08:47:49 +0000 Subject: [PATCH 3/6] Adding more about deploy previews --- CONTRIBUTING.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 38138004d..2067dd77a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -145,10 +145,12 @@ If you are working on a GitHub issue please mention the reference in the PR, but ## Deploy preview -When you raise a PR, Netlify will automatically try and deploy your branch and give you a custom URL so you can view a preview of your changes and anyone reviewing your PR can see the preview without needing to run the branch locally. +When you raise a PR, Netlify will automatically try and deploy your branch and give you a custom URL so you can view a preview of your changes and anyone reviewing your PR can see the preview without needing to run the branch locally. However, if you do not have permissions to push to the CodeYourFuture repo and are creating a PR from a fork of the review, someone with the correct permissions will have to approve the Netlify build. Please ask in the #curriculum channel in slack to get the build approved. If you have push permissions then the build will happen automatically. +As this repo contains multiple sites, when you create a PR it will create a different Netlify build for each site. Netlify also runs Lighthouse and creates a report on performance, accessibility, SEO and best practices so you can see how your branch performs. + ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): From e941c9381bfdb307414ef3afa970cb952711c6ba Mon Sep 17 00:00:00 2001 From: nparker94 Date: Thu, 29 Jan 2026 09:01:34 +0000 Subject: [PATCH 4/6] Reverting changes I accidentally commited --- .gitignore | 7 +------ org-cyf-guides/go.mod | 4 ++-- org-cyf-guides/package-lock.json | 7 +++---- 3 files changed, 6 insertions(+), 12 deletions(-) diff --git a/.gitignore b/.gitignore index 6ab79d995..92dc17ec8 100644 --- a/.gitignore +++ b/.gitignore @@ -26,14 +26,9 @@ npm-debug.log* yarn-debug.log* yarn-error.log* -org-cyf-guides/go.mod -org-cyf-guides/package-lock.json - # CI uses package-lock.json, don't allow yarn.lock yarn.lock # Local Netlify folder .netlify -.env -org-cyf-guides/go.mod -org-cyf-guides/package-lock.json +.env \ No newline at end of file diff --git a/org-cyf-guides/go.mod b/org-cyf-guides/go.mod index ebab863ee..e6f2dd2d5 100644 --- a/org-cyf-guides/go.mod +++ b/org-cyf-guides/go.mod @@ -3,8 +3,8 @@ module github.com/CodeYourFuture/curriculum/org-cyf-guides go 1.24.5 require ( - github.com/CodeYourFuture/curriculum/common-content v0.0.0-20250801130816-705636729ea4 // indirect - github.com/CodeYourFuture/curriculum/common-theme v0.0.0-20250801130816-705636729ea4 // indirect + github.com/CodeYourFuture/curriculum/common-content v0.0.0-20241008095008-281a5517463f // indirect + github.com/CodeYourFuture/curriculum/common-theme v0.0.0-20241008095008-281a5517463f // indirect github.com/CodeYourFuture/curriculum/org-cyf-theme v0.0.0-20240818070728-e8702788f7cb // indirect ) diff --git a/org-cyf-guides/package-lock.json b/org-cyf-guides/package-lock.json index 40290e0da..279946fa2 100644 --- a/org-cyf-guides/package-lock.json +++ b/org-cyf-guides/package-lock.json @@ -18,11 +18,10 @@ } }, "node_modules/cross-spawn": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", - "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "version": "7.0.3", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", + "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", "dev": true, - "license": "MIT", "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", From 810162f7f745c25b7b0dd961b5db09a905758b1d Mon Sep 17 00:00:00 2001 From: nparker94 Date: Thu, 29 Jan 2026 09:02:46 +0000 Subject: [PATCH 5/6] Reverting file accidentally committed --- .../content/employability/_index.md | 29 +------------------ 1 file changed, 1 insertion(+), 28 deletions(-) diff --git a/org-cyf-guides/content/employability/_index.md b/org-cyf-guides/content/employability/_index.md index 0e4926ad0..32bdfd96d 100644 --- a/org-cyf-guides/content/employability/_index.md +++ b/org-cyf-guides/content/employability/_index.md @@ -1,32 +1,5 @@ +++ title="Employability" -description="Your guide for getting job ready" +description="Your guides for getting job ready" menu=["everyone"] +++ - -This guide is to help to you get a job and hit the ground running once you start. It is written sequentially based on the typical steps you would take in a job seeking process but each individual guide can be use as a reference to dig into at any point as well. - -The first thing you need to do is work out what sort of role you want and what sort of company you want to work for. If you are already clear on this then fantastic, if you not please read the following guide to help you with your decision. - -### How to decide what job I want (add link) - -Then before you apply ideally you will have the follow things ready. It is not mandatory to have a LinkedIn profile and portfolio site, however it will increase your chances of getting a job so we recommend creating them. - -### CVs (add link) -### LinkedIn (add link) -### Porfolio site (add link) - -Once you have prepared the resources and know what sort of jobs you want to apply for, it's time to really start your search - -### Job search (add link) -### High level application process (add link) -### Cover letters (add link) -### Networking (add link) -### Interviews (add link) - -Once you have passed the interview process, you should read the - -### Employment contracts and offers (add link) -### References and security checks (add link) -### First 90 days in a job (add link) -### Lifelong learning (add link) From d77a9270527e81427794aacc23a4d9215309827a Mon Sep 17 00:00:00 2001 From: Daniel Wagner-Hall Date: Thu, 29 Jan 2026 17:30:43 +0000 Subject: [PATCH 6/6] Fix Slack channel name --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2067dd77a..b040666d7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -147,7 +147,7 @@ If you are working on a GitHub issue please mention the reference in the PR, but When you raise a PR, Netlify will automatically try and deploy your branch and give you a custom URL so you can view a preview of your changes and anyone reviewing your PR can see the preview without needing to run the branch locally. -However, if you do not have permissions to push to the CodeYourFuture repo and are creating a PR from a fork of the review, someone with the correct permissions will have to approve the Netlify build. Please ask in the #curriculum channel in slack to get the build approved. If you have push permissions then the build will happen automatically. +However, if you do not have permissions to push to the CodeYourFuture repo and are creating a PR from a fork of the review, someone with the correct permissions will have to approve the Netlify build. Please ask in the #cyf-curriculum channel in slack to get the build approved. If you have push permissions then the build will happen automatically. As this repo contains multiple sites, when you create a PR it will create a different Netlify build for each site. Netlify also runs Lighthouse and creates a report on performance, accessibility, SEO and best practices so you can see how your branch performs.