Kubernetes Contributor Site
This repository contains the Hugo site and generator scripts for the Kubernetes Contributor site. In the future, the site will be available at https://contributors.kubernetes.io. For now, you can access the in-progress site at https://kubernetes-contributor.netlify.com.
Site content
The content for the Contributor Site is sourced from multiple locations.
Content managed within this repository is generated from generated from Markdown
found within the content
directory. To update the site's content,
make changes to the Markdown sources and submit a pull request to this
repository.
Some content is externally sourced and changes to that must be made in the
original location. A list of sources and their locations within the
content
is available below:
External sources
- Source: https://git.k8s.io/community/contributors/guide
Destination:/guide
- Source: https://github.com/cncf/foundation/blob/master/code-of-conduct.md
Destination:/code-of-conduct.md
- Source: https://git.k8s.io/sig-release/releases/release-1.18/README.md
Destination:/release.md
Running the site locally
To develop site content, you can run the site locally using Hugo in two ways:
- Inside a Docker container
- Natively (not inside a Docker container)
When you make changes to the site's content, Hugo will automatically update the site and refresh your browser window.
Using Docker
The easiest and most cross-system-compatible way to run the Contributor
Site is to use Docker. To begin, create the docker image to be used
with generating the site by executing make docker-image
.
To ensure you can view the site with externally sourced content, run
make docker-gen-content
before previewing the site by with make docker-server
.
Natively
For instructions on installing and using Hugo, see the Hugo Documentation.
To run the site locally using an installed Hugo executable, run make server
.
YouTube embeds
You can embed YouTube videos on pages using the youtube
shortcode and
specifying the unique ID of the video. Here's an example:
Check out this cool video:
{{< youtube 6cCEmAisx8A >}}
This embed would take up the full width of the surrounding element. You can specify a smaller width as a percentage by changing the second argument. This embed, for example, would occupy 70% of the width:
Check out this cool video:
{{< youtube 6cCEmAisx8A 70 >}}
Community, discussion, contribution, and support
This project is managed by SIG Contributor Experience as a part of KEP-0005
You can reach the maintainers of this project at:
Evolution of this site:
We’re building out this site in real-time! Want to join us and help? Here’s what we have in store for next iterations:
- An Events page showcasing all current and future happenings within the Kubernetes community. We hope to launch this feature by November 2019. Want to help us hit this target? Help us work on this project by forking the repo and submitting a pull request!
- Contributor guide/handbook: Feature launch date estimated November 2019
- Developers' guide/handbook: Feature launch date estimated April 2020
- Role Board: Feature launch date estimated April 2020
- Directory of Kubernetes SIGs and other community groups
- Pathways to success for new Kubernetes contributors and mentoring programs
- Workshop videos
Code of conduct
Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.