Skip to content

Commit

Permalink
Add documentation for contributing docs
Browse files Browse the repository at this point in the history
  • Loading branch information
tstromberg committed Aug 13, 2019
1 parent 8e5a161 commit 53feb72
Showing 1 changed file with 59 additions and 0 deletions.
59 changes: 59 additions & 0 deletions site/content/en/docs/Contributing/documentation.en.md
@@ -0,0 +1,59 @@
---
linkTitle: "Documentation"
title: "Contributing to minikube documentation"
date: 2019-07-31
weight: 2
---

minikube's documentation is in [Markdown](https://www.markdownguide.org/cheat-sheet/), and generated using the following tools:

* [Hugo](https://gohugo.io)
* [Docsy](https://www.docsy.dev)

In production, the minikube website is served using [Netlify](http://netlify.com/)

## Local documentation website

To serve documentation pages locally, clone the `minikube` repository and run:

`make site`

NOTE: On Windows, our site currently causes Hugo to `panic`.

## Lint

We recommend installing [markdownlint](https://github.com/markdownlint/markdownlint) to find issues with your markdown file. Once installed, you can use this handy target:

`make mdlint`

## Style Guidelines

We follow the [Kubernetes Documentation Style Guide](https://kubernetes.io/docs/contribute/style/style-guide/)

## Linking between documents

For compile-time checking of links, use one of the following forms to link between documentation pages:


```go-html-template
{{</* ref "document.md" */>}}
{{</* ref "#anchor" */>}}
{{</* ref "document.md#anchor" */>}}
{{</* ref "/blog/my-post" */>}}
{{</* ref "/blog/my-post.md" */>}}
{{</* relref "document.md" */>}}
{{</* relref "#anchor" */>}}
{{</* relref "document.md#anchor" */>}}
```

For more information, please see [Hugo: Links and Cross References](https://gohugo.io/content-management/cross-references/)

## Pull Request Previews

When reviewing documentation PR's, look for the test that says:

**✓ deploy/netlify** Deploy preview ready! *Details*

The `Details` link will point to a site preview URL in the form of:

<https://deploy-preview-PR#--kubernetes-sigs-minikube.netlify.com>

0 comments on commit 53feb72

Please sign in to comment.