mirror of
https://github.com/kata-containers/kata-containers.git
synced 2025-08-16 07:05:14 +00:00
Merge pull request #126 from jodh-intel/more-doc-requirements
docs: Add notes to doc requirements
This commit is contained in:
commit
8e3bc751c9
@ -1,5 +1,6 @@
|
|||||||
* [Introduction](#introduction)
|
* [Introduction](#introduction)
|
||||||
* [General requirements](#general-requirements)
|
* [General requirements](#general-requirements)
|
||||||
|
* [Notes](#notes)
|
||||||
* [Code blocks](#code-blocks)
|
* [Code blocks](#code-blocks)
|
||||||
|
|
||||||
# Introduction
|
# Introduction
|
||||||
@ -12,6 +13,26 @@ Containers](https://github.com/kata-containers) project.
|
|||||||
- All documents are expected to be written in [GitHub Flavored Markdown](https://github.github.com/gfm) format.
|
- All documents are expected to be written in [GitHub Flavored Markdown](https://github.github.com/gfm) format.
|
||||||
- All documents should have the `.md` file extension.
|
- All documents should have the `.md` file extension.
|
||||||
|
|
||||||
|
# Notes
|
||||||
|
|
||||||
|
Important information that is not part of the main document flow should be
|
||||||
|
added as a Note in bold with all content contained within block quote:
|
||||||
|
|
||||||
|
> **Note:** This is areally important point!
|
||||||
|
>
|
||||||
|
> This particular note also spans multiple lines. The entire note should be
|
||||||
|
> included inside the quoted block.
|
||||||
|
|
||||||
|
If there are multiple notes, bullets should be used:
|
||||||
|
|
||||||
|
> **Notes:**
|
||||||
|
>
|
||||||
|
> - I am important point 1.
|
||||||
|
>
|
||||||
|
> - I am important point 2.
|
||||||
|
>
|
||||||
|
> - I am important point *n*.
|
||||||
|
|
||||||
# Code blocks
|
# Code blocks
|
||||||
|
|
||||||
This section lists requirements for displaying commands and command output.
|
This section lists requirements for displaying commands and command output.
|
||||||
|
Loading…
Reference in New Issue
Block a user