Skip to content

Commit e3be97e

Browse files
k8s-ci-robotk8s-ci-robot
authored
Merge pull request #4870 from mrbobbytables/add-guide-descriptions
Add frontmatter descriptions to the contributor guide docs
2 parents fd5df0d + 427ccfb commit e3be97e

17 files changed

+60
-30
lines changed

‎contributors/guide/README.md

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,3 @@
1-
---
2-
title: "Contributors Guide"
3-
weight: 1
4-
slug: "guide"
5-
---
6-
7-
<!--
8-
Contributing to this document?
9-
Please use semantic line feeds for readability: http://rhodesmill.org/brandon/2012/one-sentence-per-line/
10-
-->
11-
121
This document is the single source of truth for how to contribute to the code base.
132
Feel free to browse the [open issues](https://github.com/kubernetes/community/issues?q=is%3Aissue+is%3Aopen+label%3Aarea%2Fcontributor-guide) and file new ones, all feedback welcome!
143

‎contributors/guide/coding-conventions.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
---
22
title: "Coding Conventions"
33
weight: 8
4-
slug: "coding-conventions"
4+
description: |
5+
A collection of guidelines, style suggestions, and tips for writing code in
6+
the different programming languages used throughout the project.
57
---
68

79
**Table of Contents**

‎contributors/guide/contributing.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
11
---
22
title: "Contributing to Kubernetes"
33
weight: 4
4-
slug: "contributing"
4+
description: |
5+
An entrypoint to getting started with contributing to the Kubernetes project.
56
---
67

78
# Contributing

‎contributors/guide/contributor-cheatsheet/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,13 @@
1+
---
2+
title: Contributor Cheatsheet
3+
weight: 2
4+
description: |
5+
A list of common resources when contributing to Kubernetes, tips, tricks, and
6+
common best practices used within the Kubernetes project. It is a "TL;DR" or
7+
quick reference of useful information to make your GitHub contribution experience
8+
better.
9+
---
10+
111
<!-- omit in toc -->
212
# Kubernetes Contributor Cheat Sheet
313

‎contributors/guide/expectations.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
---
22
title: "Community Expectations"
33
weight: 17
4-
slug: "expectations"
4+
description: |
5+
Expectations of conduct and code review that govern all members of the
6+
community.
57
---
68

79
Kubernetes is a community project. Consequently, it is wholly dependent on

‎contributors/guide/first-contribution.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
---
22
title: "Making your First Contribution"
33
weight: 3
4-
slug: "first-contribution"
4+
description: |
5+
Not sure where to make your first contribution? This doc has some tips and
6+
ideas to help get you started.
57
---
68

79
# Your First Contribution

‎contributors/guide/getting-started.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
---
22
title: "Getting Started"
33
weight: 2
4-
slug: "getting-started"
4+
description: |
5+
A small list of things that you should read and be familiar with before you
6+
get started with contributing. This includes such things as signing the
7+
Contributor License Agreement, familiarizing yourself with our Code of Conduct
8+
and more.
59
---
610

711
# Before you get started

‎contributors/guide/github-workflow.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,10 @@
11
---
22
title: "GitHub Workflow"
33
weight: 6
4-
slug: "github-workflow"
4+
description: |
5+
An overview of the GitHub workflow used by the Kubernetes project. It includes
6+
some tips and suggestions on things such as keeping your local environment in
7+
sync with upstream and commit hygiene.
58
---
69

710
![Git workflow](git_workflow.png)

‎contributors/guide/help-wanted.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,10 @@
11
---
22
title: "Help Wanted and Good First Issue Labels"
33
weight: 9
4-
slug: "help-wanted"
4+
description: |
5+
Provides guidance on how and when to use the help wanted and good first issue
6+
labels. These are used to identify issues that have been specially groomed for
7+
new contributors.
58
---
69

710
# Overview

‎contributors/guide/issue-triage.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,10 @@
11
---
22
title: "Issue Triage Guidelines"
33
weight: 10
4-
slug: "issue-triage"
4+
description: |
5+
These guidelines serve as a primary document for triaging incoming issues to
6+
Kubernetes. SIGs and projects are encouraged to use this guidance as a
7+
starting point, and customize to address specific triaging needs.
58
---
69

710
# Issue Triage: A Primer

0 commit comments

Comments
 (0)