Skip to content

Commit 26de80b

Browse files
jonasfroellerjonasfroeller
committed
adds /en/blog (closes #46)
1 parent 72a89ad commit 26de80b

9 files changed

+479
-10
lines changed

‎astro.config.mjs‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,13 @@ const IS_DEV = import.meta.env.DEV;
1212

1313
export default defineConfig({
1414
site: IS_DEV ? "http://localhost:4321" : "https://propromo-docs.vercel.app",
15+
vite: {
16+
resolve: {
17+
alias: {
18+
'@components': '/src/components'
19+
}
20+
}
21+
},
1522
integrations: [
1623
starlight({
1724
title: "Propromo Docs",

‎src/content/docs/blog/a-guide-on-github-projects.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: A guide on GitHub-Projects.
2+
title: Ein Leitfaden für GitHub Projects
33
date: 2024-12-12
44
lastUpdated: 2024-12-12
55
tags: [github, github-projects-v2]
6-
excerpt: How to master GitHub Projects?
6+
excerpt: Wie meistert man GitHub Projects?
77
cover:
8-
alt: Template Project Preview
8+
alt: Template Projekt Vorschau
99
image: ../../../assets/blog/a-guide-on-github-projects/default-view.png
1010
featured: false
1111
draft: false

‎src/content/docs/blog/how-to-use-propromos-github-scrum-template-project.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: How to use Propromo's GitHub SCRUM Template Project?
2+
title: Wie verwendet man Propromo's GitHub SCRUM Template Project?
33
date: 2024-12-07
44
lastUpdated: 2024-12-07
55
authors:
66
- jonasfroeller
77
tags: [github, scrum-template-project]
8-
excerpt: How to use Propromo's GitHub SCRUM Template Project.
8+
excerpt: Eine Anleitung zur Verwendung des Propromo GitHub SCRUM Template Projects.
99
cover:
10-
alt: Template Project Preview
10+
alt: Template Projekt Vorschau
1111
dark: ../../../assets/blog/how-to-use-propromos-github-scrum-template-project/cover.png
1212
light: ../../../assets/blog/how-to-use-propromos-github-scrum-template-project/cover-light.png
1313
featured: true

‎src/content/docs/blog/new-github-projectv2-features.mdx‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
2-
title: New GitHub ProjectV2 features! (13.1.2025)
2+
title: Neue GitHub ProjectV2 Features! (13.1.2025)
33
date: 2025-01-25
44
lastUpdated: 2025-01-25
55
authors:
66
- jonasfroeller
77
tags: [github, github-projects-v2]
8-
excerpt: New GitHub ProjectV2 features (opt-in preview 12.12.2024, release 13.1.2025).
8+
excerpt: Neue Features in GitHub ProjectsV2 - Sub-Issues und Insights Charts!
9+
featured: false
910
draft: false
1011
---
1112

‎src/content/docs/blog/propromos-github-scrum-template-project-v3.mdx‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
2-
title: Propromo's GitHub SCRUM Template Project V3.
2+
title: Propromo's GitHub SCRUM Template Project V3
33
date: 2025-01-25
44
lastUpdated: 2025-01-25
55
authors:
66
- jonasfroeller
77
tags: [github, scrum-template-project]
8-
excerpt: Propromo's latest GitHub SCRUM Template Project. What is new in V3? What changed?
8+
excerpt: Propromo's neuestes GitHub SCRUM Template Project. Was ist neu in V3? Was hat sich geändert?
99
cover:
1010
alt: Template Project Preview
1111
dark: ../../../assets/blog/propromos-github-scrum-template-project-v3/cover.png
1212
light: ../../../assets/blog/propromos-github-scrum-template-project-v3/cover-light.png
13+
featured: false
1314
draft: false
1415
---
1516

‎src/content/docs/en/blog/a-guide-on-github-projects.mdx‎

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
---
2+
title: A guide on GitHub Projects
3+
date: 2024-12-12
4+
lastUpdated: 2024-12-12
5+
tags: [github, github-projects-v2]
6+
excerpt: How to master GitHub Projects?
7+
cover:
8+
image: /src/assets/blog/a-guide-on-github-projects/default-view.png
9+
alt: Template Project Preview
10+
featured: false
11+
draft: false
12+
---
13+
14+
import { LinkCard, Aside, LinkButton, Steps, Icon, Badge } from '@astrojs/starlight/components';
15+
16+
<Aside type="caution">This guide is only for <a href="https://docs.github.com/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects" target="_blank">GitHub ProjectsV2!</a></Aside>
17+
18+
<Steps>
19+
20+
1. ## Create a ProjectV2
21+
22+
With our SCRUM template,
23+
24+
<LinkCard
25+
title="Propromo's GitHub SCRUM Template"
26+
href="/en/blog/how-to-use-propromos-github-scrum-template-project"
27+
description="How to use Propromo's GitHub SCRUM Template Project?"
28+
/>
29+
30+
or with a GitHub template at<br />`github.com/<username>?tab=projects` or `github.com/orgs/<username>/projects`.
31+
<img src="/src/assets/blog/a-guide-on-github-projects/project-templates.png" alt="Project Templates" />
32+
33+
---
34+
35+
or migrate from ProjectV1:
36+
37+
<LinkButton
38+
href="https://docs.github.com/en/issues/planning-and-tracking-with-projects/creating-projects/migrating-from-projects-classic"
39+
target="_blank"
40+
variant="secondary"
41+
icon="external"
42+
iconPlacement="start"
43+
>
44+
GitHub Documentation
45+
</LinkButton>
46+
47+
2. ## Default View
48+
49+
You are now at `github.com/<orgs|users>/<username>/projects/<id>`
50+
and can see your default view here.
51+
52+
<a href="https://github.com/orgs/propromo-software/projects/1/views/1" target="_blank">
53+
<img src="/src/assets/blog/a-guide-on-github-projects/default-view.png" alt="Default View" />
54+
</a>
55+
56+
> Here you can also set the type of **view** as well as some sorting and display options.
57+
58+
<img src="/src/assets/blog/a-guide-on-github-projects/change-type-sort-and-fields.png" alt="Change Type Sort and Fields" />
59+
60+
> And [**filter**](https://docs.github.com/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects).
61+
62+
<img src="/src/assets/blog/a-guide-on-github-projects/filter.png" alt="Filter" />
63+
64+
<Aside type="note">
65+
GitHub ProjectsV2 has a limitation on the number of displayed sprints.
66+
This is quite annoying when you want to create an overview of all sprints.
67+
To work around this, you can simply exclude a sprint that doesn't exist.
68+
Like this: `-sprint:"thiswillneverbeasprintname"`.
69+
</Aside>
70+
71+
> There are now also **statistics** for GitHub Projects.
72+
73+
<img src="/src/assets/blog/a-guide-on-github-projects/insights.png" alt="Insights" />
74+
75+
`github.com/<orgs|users>/<username>/projects/<id>/insights`
76+
<img src="/src/assets/blog/a-guide-on-github-projects/insight-settings.png" alt="Insight Settings" />
77+
<img src="/src/assets/blog/a-guide-on-github-projects/statistics.png" alt="Statistics" />
78+
79+
> Settings - Creating custom **Issue Fields**
80+
81+
`github.com/<orgs|users>/<username>/projects/<id>/settings`
82+
<img src="/src/assets/blog/a-guide-on-github-projects/settings.png" alt="Settings" />
83+
84+
> &nbsp;&nbsp;&nbsp;&nbsp; Sprint
85+
86+
<img src="/src/assets/blog/a-guide-on-github-projects/sprint-settings.png" alt="Sprint Settings" />
87+
88+
> &nbsp;&nbsp;&nbsp;&nbsp; Status
89+
90+
<img src="/src/assets/blog/a-guide-on-github-projects/status-settings.png" alt="Status Settings" />
91+
92+
*Result:*
93+
<img src="/src/assets/blog/a-guide-on-github-projects/sprint-field.png" alt="Sprint Field" />
94+
95+
> **Workflows**: How to automatically change issues through actions.
96+
97+
<img src="/src/assets/blog/a-guide-on-github-projects/workflows.png" alt="Workflows" />
98+
99+
`github.com/<orgs|users>/<username>/projects/<id>/workflows`
100+
<img src="/src/assets/blog/a-guide-on-github-projects/workflow-settings.png" alt="Workflow Settings" />
101+
102+
3. ## How do we organize our GitHub Project?
103+
104+
We assign <Badge text="userstory" variant="note" /> and <Badge text="task" variant="success" /> labels to our issues so we can identify them more quickly.
105+
Additionally, although we have created a dedicated Sprint field for the issues, we also assign a Sprint label (`sprint-xxx`),
106+
to keep track in the issues overview where the Sprint field is not displayed.
107+
108+
`github.com/<username>/<repository-name>/issues`
109+
<img src="/src/assets/blog/a-guide-on-github-projects/issues.png" alt="Issues" />
110+
111+
`github.com/<username>/<repository-name>/labels`
112+
<img src="/src/assets/blog/a-guide-on-github-projects/labels.png" alt="Labels" />
113+
114+
`github.com/<username>/<repository-name>/milestones`
115+
<img src="/src/assets/blog/a-guide-on-github-projects/milestones.png" alt="Milestones" />
116+
117+
Since milestones and labels can only be managed per repository in GitHub,
118+
we recommend using our [propromo.cli](https://github.com/propromo-software/propromo.cli) to synchronize them between repositories.
119+
120+
</Steps>
121+
122+
<div style="display: flex; margin-top: 2rem;">
123+
<LinkButton
124+
href="https://github.com/propromo-software/propromo.cli"
125+
target="_blank"
126+
variant="secondary"
127+
icon="github"
128+
iconPlacement="start"
129+
>
130+
Learn more.
131+
</LinkButton>
132+
</div>

‎src/content/docs/en/blog/how-to-use-propromos-github-scrum-template-project.mdx‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: How to use Propromo's GitHub SCRUM Template Project?
3+
date: 2024-12-07
4+
lastUpdated: 2024-12-07
5+
authors:
6+
- jonasfroeller
7+
tags: [github, scrum-template-project]
8+
excerpt: How to use Propromo's GitHub SCRUM Template Project.
9+
cover:
10+
image: /src/assets/blog/how-to-use-propromos-github-scrum-template-project/cover.png
11+
alt: Template Project Preview
12+
featured: true
13+
draft: false
14+
---
15+
16+
import AsyncIframe from "@components/AsyncIframe.astro";
17+
18+
## Propromo's GitHub SCRUM Template Project
19+
20+
To use the template, open this [Link](https://github.com/orgs/propromo-software/projects/11/views/1) and click on "Use this template".
21+
22+
<AsyncIframe>
23+
<iframe
24+
src="https://scribehow.com/embed/How_to_Use_a_GitHub_Project_Template__y3JHkik4RZyMwE6fqhVPYA"
25+
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
26+
allowfullscreen
27+
frameborder="0"
28+
></iframe>
29+
</AsyncIframe>
30+
31+
[More guides](https://scribehow.com/page/Propromo__MU4jHKxgQGaFxrY-THBpsg)

‎src/content/docs/en/blog/new-github-projectv2-features.mdx‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: New GitHub ProjectV2 features! (13.1.2025)
3+
date: 2025-01-25
4+
lastUpdated: 2025-01-25
5+
authors:
6+
- jonasfroeller
7+
tags: [github, github-projects-v2]
8+
excerpt: New GitHub ProjectV2 features (opt-in preview 12.12.2024, release 13.1.2025).
9+
draft: false
10+
---
11+
12+
## What's new in GitHub ProjectsV2?
13+
14+
### Sub-issues & Issue Types
15+
16+
Indirectly, what's new is that there are now sub-issues that can also be linked in tasks. ([REST API](https://docs.github.com/en/rest/issues/sub-issues?apiVersion=2022-11-28))
17+
18+
- 100 [Sub-issues](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues) per Issue
19+
20+
Settings (customize)
21+
22+
![Image](https://github.com/user-attachments/assets/bd7f0f25-d6a1-4f25-8c27-574c10596f23)
23+
24+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Task (link)
25+
26+
![Image](https://github.com/user-attachments/assets/0a9e4eb2-9697-48b6-990f-b75f2c8b19b8)
27+
28+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tabs (display)
29+
30+
![Image](https://github.com/user-attachments/assets/ec4d2bf6-627a-4f61-8e81-b164e929317b)
31+
32+
- 25 [Issue Types](https://docs.github.com/en/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization) per Organization
33+
34+
![Image](https://github.com/user-attachments/assets/2a56b51f-c26a-459f-bf3e-b21fdc2b83a1)
35+
36+
### "Insight" charts now use [Highcharts](https://www.highcharts.com)
37+
38+
---
39+
40+
[Learn more (12.12.2024)](https://github.blog/changelog/2024-12-12-github-issues-projects-close-issue-as-a-duplicate-rest-api-for-sub-issues-and-more)
41+
[More information (13.1.2025)](https://github.blog/changelog/2025-01-13-evolving-github-issues-public-preview)
42+
[Stay updated](https://github.blog/changelog/label/projects)
43+
[More about GitHub ProjectsV2](https://docs.github.com/en/issues/planning-and-tracking-with-projects)
44+
[More about GitHub Issues](https://github.com/features/issues)

0 commit comments

Comments
 (0)