site: add community and contributing (#836)

* add _index.md files and front matter

* switch to sentance case caps

* fix weights

* Update community/samples/README.md

Co-Authored-By: RichieEscarez <rescarez@google.com>

community/samples/README.md

@@ -1,8 +1,5 @@
-# Knative Community Samples
+## Sample apps
 
-This directory contains Knative sample applications submitted from the
-community.
-
-| Sample Name | Description                                                                      | Language(s)                                                                                                                                                                                                                                                                                                                                                                                  |
-| ----------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Hello World | A quick introduction that highlights how to deploy an app using Knative Serving. | [Clojure](./serving/helloworld-clojure/README.md), [Dart](./serving/helloworld-dart/README.md), [Elixir](./serving/helloworld-elixir/README.md), [Haskell](./serving/helloworld-haskell/README.md), [Rust](./serving/helloworld-rust/README.md), [Shell](./serving/helloworld-shell/README.md), [Swift](./serving/helloworld-swift/README.md), [Vertx](./serving/helloworld-vertx/README.md) |
+| Sample Name   | Knative Component | Description                | Language(s)       |
+| --------------| ----------------- | -------------------------- | ----------------- |
+| Hello World   | Serving | A quick introduction that highlights how to deploy an app. | [Clojure](./serving/helloworld-clojure/README.md), [Dart](./serving/helloworld-dart/README.md), [Elixir](./serving/helloworld-elixir/README.md), [Haskell](./serving/helloworld-haskell/README.md), [Rust](./serving/helloworld-rust/README.md), [Shell](./serving/helloworld-shell/README.md), [Swift](./serving/helloworld-swift/README.md), [Vertx](./serving/helloworld-vertx/README.md) |

community/samples/_index.md

@@ -0,0 +1,13 @@
+---
+title: "Knative Community Sample Apps"
+linkTitle: "Sample Apps"
+weight: 100
+type: "docs"
+---
+
+Get up and running in a language of your choice using one of the community
+contributed and maintained sample apps.
+
+Use the following table to view the instructions and sample code in the knative/docs repo.
+
+{{% readfile file="community/samples/README.md" markdown="true" %}}

contributing/CODE-OF-CONDUCT.md

@@ -1,4 +1,8 @@
-# Contributor Covenant Code of Conduct
+---
+title: "Contributor covenant code of conduct"
+linkTitle: "Code of conduct"
+weight: 10
+---
 
 ## Our Pledge
 

contributing/CONTRIBUTING.md

@@ -1,4 +1,8 @@
-# Contributing to Knative
+---
+title: "Knative contributor guidelines"
+linkTitle: "Contributing to Knative"
+weight: 15
+---
 
 So, you want to hack on Knative? Yay!
 
@@ -20,7 +24,7 @@ given the same level of review.
 
 ## Working groups
 
-The Knative community is organized into a set of
+The Knative contributors community is organized into a set of
 [working groups](WORKING-GROUPS.md). Any contribution to Knative should be
 started by first engaging with the appropriate working group.
 

contributing/DOCS-CONTRIBUTING.md

@@ -1,4 +1,8 @@
-# Contributing to the Knative Documentation
+---
+title: "Contributing to the Knative documentation"
+linkTitle: "Contributing to docs"
+weight: 20
+---
 
 **First off, thanks for taking the time to contribute!**
 

contributing/README.md

@@ -1,4 +1,3 @@
-# Knative Community
 
 _Important_. Before proceeding, please review the Knative community
 [Code of Conduct](CODE-OF-CONDUCT.md).

contributing/REVIEWING.md

@@ -1,4 +1,8 @@
-# Reviewing and Merging Pull Requests for Knative
+---
+title: "Reviewing and merging Knative pull requests"
+linkTitle: "Pull request guidelines"
+weight: 60
+---
 
 As a community, we believe in the value of code reviews for all contributions.
 Code reviews increase both the quality and readability of our code base, which

contributing/ROLES.md

@@ -1,4 +1,8 @@
-# Knative Community Roles
+---
+title: "Knative community roles"
+linkTitle: "Community roles"
+weight: 55
+---
 
 This document describes the set of roles individuals may have within the Knative
 community, the requirements of each role, and the privileges that each role

contributing/SLACK-GUIDELINES.md

@@ -1,4 +1,8 @@
-# Slack Usage Guidelines
+---
+title: "Slack usage guidelines"
+linkTitle: "Slack guidelines"
+weight: 45
+---
 
 Slack is the main communication platform for Knative outside of our mailing
 lists. It’s important that conversation stays on topic in each channel, and that

contributing/STEERING-COMMITTEE.md

@@ -1,4 +1,8 @@
-# Knative Steering Committee
+---
+title: "Knative steering committee"
+linkTitle: "Steering committee"
+weight: 40
+---
 
 The Knative Steering Committee (SC) defines, evolves, and defends the vision,
 values, mission, and scope of the project. _The Steering Committee is a

contributing/TECH-OVERSIGHT-COMMITTEE.md

@@ -1,4 +1,8 @@
-# Knative Technical Oversight Committee
+---
+title: "Knative technical oversight committee"
+linkTitle: "Technical oversight committee"
+weight: 35
+---
 
 The Knative Technical Oversight Committee (TOC) is responsible for cross-cutting
 product and design decisions.

contributing/VALUES.md

@@ -1,4 +1,8 @@
-# Knative Team Values
+---
+title: "Knative team values"
+linkTitle: "Team values"
+weight: 50
+---
 
 We want to make sure every member has a shared understanding of the goals and
 values we hold as a team:

contributing/WORKING-GROUP-PROCESSES.md

@@ -1,4 +1,8 @@
-# Knative Working Group Processes
+---
+title: "Knative working group processes and guidelines"
+linkTitle: "Working group guidelines"
+weight: 30
+---
 
 This document describes the processes we use to manage the Knative working
 groups. This includes how they are formed, how leads are established, how they

contributing/WORKING-GROUPS.md

@@ -1,4 +1,8 @@
-# Knative Working Groups
+---
+title: "Knative working group"
+linkTitle: "Join working groups"
+weight: 25
+---
 
 Most community activity is organized into _working groups_.
 

contributing/_index.md

@@ -0,0 +1,19 @@
+
+---
+title: "Knative contribution guidelines"
+linkTitle: "Contributing"
+weight: 20
+type: "docs"
+menu:
+  main:
+    weight: 60
+aliases:
+  - /docs/contribution-guidelines/
+---
+
+Learn how to join the community of Knative contributors.
+
+Also see our [Community page](community) for links to Knative chats, discussions, or Q&A.
+
+
+{{% readfile file="docs/contributing/README.md" markdown="true" %}}