Commit Graph

36 Commits

Author SHA1 Message Date
Tim Bannister da31234d5d Update docs for primary branch rename to "main" 2021-06-19 01:50:25 +01:00
Peter Sutter 5deefdaa9d Switch Do's and Don'ts 2021-04-26 12:01:56 +02:00
Kubernetes Prow Robot 8de202cfa1 Merge pull request #26580 from kbhawkey/update-style-extraneous-words
update style guide (insensitive words)
2021-02-25 13:48:15 -08:00
Karen Bradshaw e13661c5fe update style guide 2021-02-16 19:14:13 -05:00
Jordan Liggitt ec4df0f2cf Address review comments 2021-02-14 15:50:12 -05:00
Geoffrey Cline 96c4813972 revise guidance for Pascal Case 2021-02-05 21:53:37 +00:00
Dan Roscigno 64594a4c60 Correct camelcase of DaemonSet 2020-12-23 09:22:27 -05:00
Casie Oxford 826d53c81f Update style guidelines for API object capitalization & formatting (#23497)
* Update style-guide.md

updates to api object handling according to SIG email discussion.

* Update content/en/docs/contribute/style/style-guide.md

Co-authored-by: Zach Corleissen <zacharysarah@users.noreply.github.com>

* Update style-guide.md

updating API Object Examples

* Update content/en/docs/contribute/style/style-guide.md

Co-authored-by: Zach Corleissen <zacharysarah@users.noreply.github.com>

* Update content/en/docs/contribute/style/style-guide.md

Co-authored-by: Zach Corleissen <zacharysarah@users.noreply.github.com>

* Update content/en/docs/contribute/style/style-guide.md

Co-authored-by: Tim Bannister <tim@scalefactory.com>

Co-authored-by: Zach Corleissen <zacharysarah@users.noreply.github.com>
Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-09-27 13:10:48 -07:00
TAKAHASHI Shuuji c6a96128c4 Replace special quote characters with normal ones. 2020-08-11 21:05:22 +09:00
Qiming Teng 139da7d731 Tidy up: fix bad links in contribution guide 2020-07-20 09:53:11 +08:00
Maciej Szulik 00f502fa6a Update kubectl run from docs where necessary
kubectl run starting from 1.18 is creating only Pods and there is no option to
create any other resource. Users should be using kubectl create
commands instead. This update the documentation in all those places
where kubectl create should be used instead or changes description to
reflect the situation.
2020-06-25 13:37:14 +02:00
Karen Bradshaw 38250940c3 create page-content-types 2020-06-09 19:33:15 -04:00
Karen Bradshaw ecc27bbbe7 add en pages 2020-06-09 19:33:15 -04:00
Celeste Horgan f0cded013f Restructure to reduce duplication
Signed-off-by: Celeste Horgan <celeste@cncf.io>
2020-04-07 12:25:56 -07:00
Celeste Horgan fbaeb89823 Fix markdown escaping (#19744)
Signed-off-by: Celeste Horgan <celeste@cncf.io>
2020-03-23 05:22:45 -07:00
inductor 4297f3b29c Update nginx to modern versions (#19198)
* update nginx versions

* update

* update examples
2020-03-17 10:48:23 -07:00
Karen Bradshaw 249f88c64e update style guide for styling component names (#17588)
* update style guide for styling component names

- Attempt to outline style conventions for components
  and component tools
- Interested in comments and feedback

* update style examples

* style edits

- removed code style for components not cmd tools
- added style suggestion for namespaces
- cleaned up a few stray spaces
2019-12-02 02:21:04 -08:00
Yuk, Yongsu d437e8c6bc en: Change the full link in the document to an inline link. (#17057)
* Change the full link in the document to an inline link.

grep -r "https \: \ / \ / kubernetes \ .io" content/en/docs
Changed to inline link except the following list.
- URLs are mentioned directly in the body
- release note
- url to blog
- url to community
- Url to be redirected

* Apply suggestions from code review

Co-Authored-By: June Yi <june.yi@samsung.com>
2019-10-23 06:20:14 -07:00
PingWang 74397dd65f Add the -n for pod in kubectl command (#16798)
Signed-off-by: PingWang <wang.ping5@zte.com.cn>

Add instructions in kubectl command

Signed-off-by: PingWang <wang.ping5@zte.com.cn>

update

Signed-off-by: PingWang <wang.ping5@zte.com.cn>
2019-10-11 18:28:39 -07:00
savitharaghunathan 8f2d392fb5 Updating style.md and write-new-topic.md with markdowns (#16190) 2019-09-11 18:08:38 -07:00
aimeeu c9d9e1be14 Add Content Guide to clarify allowed content (#15892)
Add new section for content guidelines
Add table of examples of what is and is not allowed
Add examples of links to Linux Academy courses based on discussion
during the Aug 20 SIG Docs meeting.
Remove example table and reformat based on feedback
Move content guide to its own page
Update existing pages to mention new Content Guide page

Signed-off-by: Aimee Ukasick <aimeeu.opensource@gmail.com>
2019-08-26 17:56:39 -07:00
Zach Corleissen 9591ca0957 Tiny typo fix (#15579) 2019-07-30 08:50:53 -07:00
zhangqx2010 42ef78a7ad update multi-language description (#15124)
* update multi-language description

* Update style-guide.md

* Update style-guide.md
2019-07-06 20:56:34 -07:00
Rajakavitha1 f7d6afedec Add accessibility guidelines to the style guide (#14292)
* [WIP] added accessibility guidelines to the style guide

Adopted the accessibility level A and AA guidelines to Markdown elements: 
https://www.w3.org/WAI/WCAG21/quickref/?versions=2.0&currentsidebar=%23col_overview&levels=aaa

We still need to define attributes for the front matter. See, https://github.com/kubernetes/website/issues/14286

I am yet to draft the guidelines for images and alt text.

* fixed the note

Update style-guide.md

Incorporated the changes suggested

Incorporated the changes suggested.

fixed the formatting  issues in the table

fixed the spaces in the links section

fixed a space issue

fixed format issues in the link

added a11y guidelines to code section

removed a spacing issue

front matter guidelines best fit the using template section

Update content/en/docs/contribute/style/style-guide.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Update content/en/docs/contribute/style/style-guide.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Update content/en/docs/contribute/style/style-guide.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

incorporated the changes

incorporated the changes

Update content/en/docs/contribute/style/style-guide.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

title section for front matter guideline

updated the html characters

Update content/en/docs/contribute/style/style-guide.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Update style-guide.md
2019-06-10 20:32:15 -07:00
Franklin Yu da9d0da028 Fix code block (#14334) 2019-05-16 04:59:42 -07:00
Karen Bradshaw 0c568fa9c9 fix note shortcode, lists (#13587)
* fix note shortcode, lists

- fix note shortcode for use in lists
- add example in style guide

* add more items to list

* update warning, caution, minor tweaks

* more updates
2019-04-09 18:44:12 -07:00
Shashank Patel 8da4c1f1a9 Fix typo style guide (#13626)
Associated with #13625
2019-04-04 15:35:19 -07:00
Dani Comnea 56021dc671 Reorganize Federation tasks so we have it group and under one topic (#12900)
* Reorganize Federation tasks so we have it group and under one topic

* Intended replacement
2019-03-12 13:38:39 -07:00
Dani Comnea 8d4bd9c1fe Add code fencing example in the style guidlines (#12783)
* Add code fencing example in the style guidlines

* Add a period
2019-03-07 14:32:06 -08:00
June Yi 8e5d7e4829 Make k8s.io/docs/home to support i18n (#12570)
* Make k8s.io/docs/home to support i18n

* Apply kbhawkey's review comment
2019-02-21 08:24:20 -08:00
Luc Perkins d65e1790ff Add admonition type to shortcode (#9482)
* Change existing admon blocks

* Fix includes issue
2018-11-06 11:33:04 -08:00
alex-libre 24c8ed25da Capitalized "Pod" in multiple locations (#10199)
* Capitalized "Pod" in multiple locations

This style guide states to always capitalize Pod, but in the next section it was written in lowercase in a couple places. I've capitalized them.

* Capitalized two additional instances of "Pod" as recommended by @neolit123
2018-10-03 20:34:21 -07:00
Cody Clark 1a9b307b4e Add Katacoda Embedded Live Environment (#10276)
* Create kat-button

* Update test.md

* Update test.md

* Update test.md

* Update style-guide.md

* Update style-guide.md

* Update style-guide.md

* Update style-guide.md

* Update style-guide.md

* code highlight fix
2018-09-13 15:45:54 -07:00
Julie Bruce c39d5d8097 Added info about include issues with short codes (#10025)
* Added info about include issues with short codes

* Minor style edits

* fix sample shortcode rendering
2018-08-21 14:44:30 -07:00
shavidissa 27d3092586 Update the content under versioning. (#9919)
It was not clear what "Before you begin" meant and how it needs to be added only if the task or tutorial is version specific. Therefore, added this info in.
2018-08-20 08:29:07 -07:00
Misty Linville 5ae0d0dd8d Reorganize docs contrib guide (#9510)
* Reorganize docs contrib guide

* Address first round of feedback from Brad, Jared

* Standardize on 'SIG Docs'

* Address more feedback

* Rewrites to participating.md

* Tweak navigation titles

* Document PR Wrangler

* Document SIG Docs chairperson

* Fix codeblock that shows how to use <codenew>

It was being interpreted as a Hugo shortcode.
2018-08-06 16:15:57 -07:00