presentation.md

Error in user YAML: (<unknown>): found character that cannot start any token while scanning for the next token at line 7 column 9

---
marp: true
size: 16:9
theme: gaia
class: lead
backgroundColor: #fff
backgroundImage: url('./assets/images/hero-background.svg')
footer: @gep13
---

<style> @import 'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.3.0/css/all.min.css' </style>

Let's Ship This Thing! 🚀

By: Gary Ewan Park

---

Slides

https://gep13.me/ShipItSlides

Code

https://gep13.me/ShipItCode

---

Agenda

• What is an issue?
• What is Semantic Versioning?
• What branching strategy should I use?
• What is GitVersion?
• What is GitReleaseManager?

---

What is an

issue

---

Demo

---

...it is the focal point for work undertaken on a particular task/bug/feature in a product release.

---

What is

Semantic Versioning

---

...a simple set of rules and requirements that dictate how version numbers are assigned and incremented. These rules are based on, but not necessarily limited to, pre-existing widespread common practices in use in both closed and open-source software.

---

The Rules

Given a version number MAJOR.MINOR.PATCH, increment the:

• MAJOR version when you make incompatible API changes
• MINOR version when you add functionality in a backwards-compatible manner
• PATCH version when you make backwards-compatible bug fixes

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

---

Examples

• 0.1.0
• 0.3.13
• 1.0.0
• 0.2.0-alpha.3
• 0.2.0-alpha.3+Branch.develop.Sha.e6eb071cd30974b80d7e237b85e7729a1d791e1e

---

How do you know

when to bump

a version number

---

Tools

• PublicApiGenerator
• Microsoft.CodeAnalysis.PublicApiAnalyzers

---

There is no quick answer 😿

---

What

branching strategy

should I use

---

GitHub Flow

---

Create a branch

---

Add commits

---

Open a Pull Request

---

Discuss and review your code

---

Deploy

---

Merge

---

GitFlow

---

---

---

It depends! 🤷

---

What is

GitVersion

---

...a tool to help you achieve Semantic Versioning on your project.

---

Demo

---

Why do I need

GitVersion

---

---

---

---

?

---

To make version assertion reliable and consistent

---

What is

GitReleaseManager

---

...a tool that will help create, and manage, a release for your application/product.

---

Demo

---

Gary Ewan Park

Principal Software Engineer
Chocolatey Software, Inc

• Twitter: @gep13
• Mastodon: @gep13@mastodon.social
• Blog: https://gep13.co.uk
• GitHub: gep13

---

Questions

---

Learn More

• GitVersion Documentation
  • https://gitversion.net/docs/
• GitReleaseManager Documentation
  • https://gittools.github.io/GitReleaseManager/docs/
• Git Branching Strategies
  • https://www.atlassian.com/git/tutorials/comparing-workflows
• GitFlow
  • https://nvie.com/posts/a-successful-git-branching-model/