Skip to content

Commit 5cfc9d2

Browse files
committed
📝 docs: modify the template README.md
1 parent 16fb00d commit 5cfc9d2

2 files changed

Lines changed: 3 additions & 68 deletions

File tree

template/README.md.jinja

Lines changed: 1 addition & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -1,76 +1,9 @@
11
# {{ project_name }}
22

3+
{% if repository_provider == 'github' -%}
34
[![Release](https://img.shields.io/github/v/release/{{ author_github_handle }}/{{ project_name }})](https://img.shields.io/github/v/release/{{ author_github_handle }}/{{ project_name }})
45
[![Build status](https://img.shields.io/github/actions/workflow/status/{{ author_github_handle }}/{{ project_name }}/main.yml?branch=main)](https://github.com/{{ author_github_handle }}/{{ project_name }}/actions/workflows/main.yml?query=branch%3Amain)
56
[![codecov](https://codecov.io/gh/{{ author_github_handle }}/{{ project_name }}/branch/main/graph/badge.svg)](https://codecov.io/gh/{{ author_github_handle }}/{{ project_name }})
67
[![Commit activity](https://img.shields.io/github/commit-activity/m/{{ author_github_handle }}/{{ project_name }})](https://img.shields.io/github/commit-activity/m/{{ author_github_handle }}/{{ project_name }})
78
[![License](https://img.shields.io/github/license/{{ author_github_handle }}/{{ project_name }})](https://img.shields.io/github/license/{{ author_github_handle }}/{{ project_name }})
8-
9-
{{ project_description }}
10-
11-
- **Github repository**: <https://github.com/{{ author_github_handle }}/{{ project_name }}/>
12-
- **Documentation** <https://{{ author_github_handle }}.github.io/{{ project_name }}/>
13-
14-
## Getting started with your project
15-
16-
### 1. Create a New Repository
17-
18-
First, create a repository on GitHub with the same name as this project, and then run the following commands:
19-
20-
```bash
21-
git init -b main
22-
git add .
23-
git commit -m "init commit"
24-
git remote add origin git@github.com:{{ author_github_handle }}/{{ project_name }}.git
25-
git push -u origin main
26-
```
27-
28-
### 2. Set Up Your Development Environment
29-
30-
Then, install the environment and the pre-commit hooks with
31-
32-
```bash
33-
make install
34-
```
35-
36-
This will also generate your `uv.lock` file
37-
38-
### 3. Run the pre-commit hooks
39-
40-
Initially, the CI/CD pipeline might be failing due to formatting issues. To resolve those run:
41-
42-
```bash
43-
uv run pre-commit run -a
44-
```
45-
46-
### 4. Commit the changes
47-
48-
Lastly, commit the changes made by the two steps above to your repository.
49-
50-
```bash
51-
git add .
52-
git commit -m 'Fix formatting issues'
53-
git push origin main
54-
```
55-
56-
You are now ready to start development on your project!
57-
The CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release.
58-
59-
To finalize the set-up for publishing to PyPI, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/publishing/#set-up-for-pypi).
60-
For activating the automatic documentation with MkDocs, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/mkdocs/#enabling-the-documentation-on-github).
61-
To enable the code coverage reports, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/codecov/).
62-
63-
## Releasing a new version
64-
65-
{%- if publish_to_pypi %}
66-
- Create an API Token on [PyPI](https://pypi.org/).
67-
- Add the API Token to your projects secrets with the name `PYPI_TOKEN` by visiting [this page](https://github.com/{{ author_github_handle }}/{{ project_name }}/settings/secrets/actions/new).
68-
- Create a [new release](https://github.com/{{ author_github_handle }}/{{ project_name }}/releases/new) on Github.
69-
- Create a new tag in the form `*.*.*`.
70-
71-
For more details, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/cicd/#how-to-trigger-a-release).
729
{%- endif %}
73-
74-
---
75-
76-
Repository initiated with [fpgmaas/cookiecutter-uv](https://github.com/fpgmaas/cookiecutter-uv).

template/mkdocs.yml.jinja

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@ repo_name: {{ author_github_handle }}/{{ project_name }}
66
{%- endif %}
77
site_description: {{ project_description }}
88
site_author: {{ author_fullname }}
9+
{%- if repository_provider == 'github' %}
910
edit_uri: edit/main/docs/
11+
{%- endif %}
1012
# copyright: Maintained by <a href="https://{{ author_github_handle }}.com">{{ author_github_handle }}</a>.
1113
copyright: Maintained by <a href="https://github.com/{{ author_github_handle }}">{{ author }}</a>.
1214

0 commit comments

Comments
 (0)