Skip to content

Commit 91d0f11

Browse files
authored
Merge pull request #34 from jcook3701/develop
Feat 010 (#33)
2 parents cafb9c6 + 1b890f0 commit 91d0f11

25 files changed

Lines changed: 268 additions & 154 deletions

File tree

.github/CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ The labels can only be set and modified by committers.
6666

6767
### Issue Reporting Disclaimer
6868

69-
We want to improve the quality of github-docs-cookiecutter and good bug reports are welcome! But our capacity is limited, thus we reserve the right to close or to not process insufficient bug reports in favor of those which are very cleanly documented and easy to reproduce. Even though we would like to solve each well-documented issue, there is always the chance that it will not happen - remember: github-docs-cookiecutter is Open Source and comes without warranty.
69+
We want to improve the quality of, github-docs-cookiecutter, and good bug reports are welcome! But our capacity is limited, thus we reserve the right to close or to not process insufficient bug reports in favor of those which are very cleanly documented and easy to reproduce. Even though we would like to solve each well-documented issue, there is always the chance that it will not happen - remember: github-docs-cookiecutter is Open Source and comes without warranty.
7070

7171
Bug report analysis support is very welcome! (e.g. pre-analysis or proposing solutions)
7272

@@ -117,7 +117,7 @@ These are some of the rules we try to follow:
117117
* ```Fixes #(issueNumber)```
118118
* Do NOT add a colon after "Fixes" - this prevents automatic closing.
119119
6. Create a Pull Request
120-
7. Follow the link posted by the github-docs-cookiecutter to your pull request and accept it, as described in detail above.
120+
7. Follow the link posted by the, github-docs-cookiecutter, project to your pull request and accept it, as described in detail above.
121121
8. Wait for our code review and approval, possibly enhancing your change on request
122122
* Note that the github-docs-cookiecutter developers also have their regular duties, so depending on the required effort for reviewing, testing and clarification this may take a while
123123
9. Once the change has been approved we will inform you in a comment

.github/SECURITY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Security Vulnerabilities
22

3-
The github-docs-cookiecutter is built with security and data privacy in mind to ensure your data is safe.
3+
The github-docs-cookiecutter project is built with security and data privacy in mind to ensure your data is safe.
44

55
## Reporting
66
We are grateful for security researchers and users reporting a vulnerability to us, first. To ensure that your request is handled in a timely manner and non-disclosure of vulnerabilities can be assured, please follow the below guideline.

.github/workflows/jekyll-gh-pages.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,8 @@ jobs:
5858
- name: Build with Jekyll site in /docs/jekyll
5959
run: make build-docs
6060
env:
61+
PAGES_REPO_NWO: ${{ github.repository }}
62+
JEKYLL_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
6163
JEKYLL_ENV: production
6264
- name: Upload artifact
6365
uses: actions/upload-pages-artifact@v3
File renamed without changes.

changelogs/CHANGELOG.md

Lines changed: 23 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -61,22 +61,36 @@ Feat 007 cla continued (#25)
6161
- Merge pull request #28 from jcook3701/develop
6262

6363
Feat 009 jekyll ci cd (#27)
64-
- Merge branch 'develop' into feat-008-cla
64+
- Feat 008 cla (#30)
65+
66+
* Update template
67+
68+
* fix(docs): fix for the jekyll ci/cd. Switched to my makefile build and am using that build path.
69+
70+
* Update template
71+
72+
* fix(readme): Moved commit-message help out of readme into better spot within documentation. Also info update for contributing.
73+
74+
* feat(cla): CLA Policy and CLA Privacy Policy setup.
75+
76+
* fix(license): Preparation for license update.
77+
78+
* Update template
79+
80+
* fix(build): fixed build errors.
81+
- Merge pull request #32 from jcook3701/develop
82+
83+
Feat 008 cla (#30)
84+
- Update template
6585
- Update template
6686
- Update template
6787
- Update template
68-
- Merge branch 'cookiecutter-template' into feat-008-cla
88+
- Merge branch 'cookiecutter-template' into feat-010
6989

7090
### 🐛 Fixed
7191

7292
- *(template)* Updates to template cookiecutter.json file.
73-
- *(docs)* Fix for the jekyll ci/cd. Switched to my makefile build and am using that build path.
74-
- *(readme)* Moved commit-message help out of readme into better spot within documentation. Also info update for contributing.
75-
- *(license)* Preparation for license update.
76-
77-
### 🚀 Added
78-
79-
- *(cla)* CLA Policy and CLA Privacy Policy setup.
93+
- *(license)* Removed doubled copy of the license file.
8094
## [0.1.0] - 2025-12-05
8195

8296
### ⚙️ Miscellaneous

changelogs/releases/v0.1.1.md

Lines changed: 24 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# Changelog:
33
# --------------------------------------------------
44

5-
## [0.1.1] - 2026-01-24
5+
## [0.1.1] - 2026-01-26
66

77
### ⚙️ Miscellaneous
88

@@ -61,19 +61,33 @@ Feat 007 cla continued (#25)
6161
- Merge pull request #28 from jcook3701/develop
6262

6363
Feat 009 jekyll ci cd (#27)
64-
- Merge branch 'develop' into feat-008-cla
64+
- Feat 008 cla (#30)
65+
66+
* Update template
67+
68+
* fix(docs): fix for the jekyll ci/cd. Switched to my makefile build and am using that build path.
69+
70+
* Update template
71+
72+
* fix(readme): Moved commit-message help out of readme into better spot within documentation. Also info update for contributing.
73+
74+
* feat(cla): CLA Policy and CLA Privacy Policy setup.
75+
76+
* fix(license): Preparation for license update.
77+
78+
* Update template
79+
80+
* fix(build): fixed build errors.
81+
- Merge pull request #32 from jcook3701/develop
82+
83+
Feat 008 cla (#30)
84+
- Update template
6585
- Update template
6686
- Update template
6787
- Update template
68-
- Merge branch 'cookiecutter-template' into feat-008-cla
88+
- Merge branch 'cookiecutter-template' into feat-010
6989

7090
### 🐛 Fixed
7191

7292
- *(template)* Updates to template cookiecutter.json file.
73-
- *(docs)* Fix for the jekyll ci/cd. Switched to my makefile build and am using that build path.
74-
- *(readme)* Moved commit-message help out of readme into better spot within documentation. Also info update for contributing.
75-
- *(license)* Preparation for license update.
76-
77-
### 🚀 Added
78-
79-
- *(cla)* CLA Policy and CLA Privacy Policy setup.
93+
- *(license)* Removed doubled copy of the license file.

docs/jekyll/_config.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
# github-docs-cookiecutter Documentation
22
---
3-
43
title: "github-docs-cookiecutter"
54
author: "Jared Cook"
65
version: "0.1.1"
@@ -9,9 +8,10 @@ description: "Github docs cookiecutter template generation."
98
remote_theme: "pmarsceill/just-the-docs"
109
ga_tracking: "G-C7PWLWSHB9"
1110

12-
repo_name: "github-docs-cookiecutter"
13-
repo_url: >
14-
https://github.com/jcook3701/github-docs-cookiecutter
11+
repo_url: "https://github.com/jcook3701/github-docs-cookiecutter"
12+
repo_blob: "https://github.com/jcook3701/github-docs-cookiecutter/blob/None/"
13+
14+
repository: "jcook3701/github-docs-cookiecutter"
1515

1616
# Specifies the site's subpath for correct URL generation
1717
baseurl: "/github-docs-cookiecutter"
@@ -101,9 +101,9 @@ back_to_top: true
101101
back_to_top_text: "Back to top"
102102

103103
footer_content: >-
104-
Copyright © 2025 Jared Cook. Distributed by an
104+
Copyright (c) 2025-2026, Jared Cook. Distributed by an
105105
<a href="https://github.com/jcook3701/github-docs-cookiecutter/blob/master/LICENSE">
106-
MIT license.
106+
AGPL-3.0-or-later license.
107107
</a>
108108
<a href=""></a>
109109

docs/jekyll/_manual/contribute/create-feature-request.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,9 @@ We're excited to hear your ideas! Before you submit a feature request, consider
1919

2020
When you're ready to submit a feature request, use the [feature request template](https://github.com/jcook3701/github-docs-cookiecutter/issues/new?template=02-feature_request.md). The template has three sections that help maintainers understand what you need and why.
2121

22-
<!-- Here's an [example of how all three sections work together in an actual feature request](https://github.com/jcook3701/github-docs-cookiecutter) from the github-docs-cookiecutter community. We'll analyze each section based on this example feature request. -->
22+
<!-- TODO: Put together an example feature request.
23+
24+
Here's an [example of how all three sections work together in an actual feature request](https://github.com/jcook3701/github-docs-cookiecutter) from the github-docs-cookiecutter community. We'll analyze each section based on this example feature request. -->
2325

2426
## Best practices for feature requests
2527

@@ -52,6 +54,6 @@ After submitting your feature request, monitor the discussion. Answer questions
5254

5355
## Contributing the feature yourself
5456

55-
If you want to implement the feature yourself, feel free to create a pull request following the [pull request guidelines](create-pull-request.md).
57+
If you want to implement the feature yourself, feel free to create a pull request following the [pull request guidelines]({% link _manual/contribute/create-pull-request.md %}).
5658

5759
We welcome community contributions and appreciate your help making github-docs-cookiecutter better!

docs/jekyll/_manual/contribute/create-pull-request.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,6 @@ Every contribution to github-docs-cookiecutter's software begins with a [pull re
1313

1414
We know you're excited to create your first pull request. Before we get started, read these resources first:
1515

16-
- Get started [contributing to github-docs-cookiecutter](/CONTRIBUTING.md).
17-
- Make sure your code follows the relevant [style guides](style-guides).
18-
- It's recommended you [set up precommit hooks](developer-guide.md) to auto-format when you commit
16+
- Get started [contributing to github-docs-cookiecutter]({{ site.repo_url }}/CONTRIBUTING.md).
17+
- Make sure your code follows the relevant [style guides]({% link _manual/contribute/style-guides/index.md %}).
18+
- It's recommended you [set up precommit hooks]({% link _manual/contribute/developer-guide.md %}) to auto-format when you commit.

docs/jekyll/_manual/contribute/developer-guide.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,75 @@ parent: Contribute
88
## Developer guide
99

1010
This guide helps you get started developing github-docs-cookiecutter.
11+
12+
## Development Strategy
13+
14+
All Makefile commands are used in __ci/cd__ to ensure that if they pass locally they should also pass once pushed to github.
15+
16+
### 🐍️ Build environment (.venv)
17+
18+
``` shell
19+
$ make install
20+
```
21+
22+
### 🧬 Dependency Management (deptry)
23+
24+
```shell
25+
$ make dependency-check
26+
```
27+
28+
### 🛡️ Security Audit (pip-audit)
29+
30+
```shell
31+
$ make security
32+
```
33+
34+
### 🎨 Formatting (black)
35+
36+
```shell
37+
$ make format-check
38+
```
39+
40+
```shell
41+
$ make format-fix
42+
```
43+
44+
### 🔍 Linting (jinja2-cli, ruff, tomllint, & yaml-lint)
45+
46+
``` shell
47+
$ make lint-check
48+
```
49+
50+
``` shell
51+
$ make lint-fix
52+
```
53+
54+
### 🎓 Spellchecking (codespell)
55+
56+
```shell
57+
$ make spellcheck
58+
```
59+
60+
### 🧠 Typechecking (mypy)
61+
62+
``` shell
63+
$ make typecheck
64+
```
65+
66+
### 🧪 Testing (pytest)
67+
68+
``` shell
69+
$ make test
70+
```
71+
72+
### 🚀 Release (git tag)
73+
74+
```shell
75+
$ make release
76+
```
77+
78+
### ❓ Build Help
79+
80+
``` shell
81+
$ make help
82+
```

0 commit comments

Comments
 (0)