Commit Graph

56 Commits (update-schedule)

Author SHA1 Message Date
Nate W f3ba85a033
correcting headings style guide recommendation
Signed-off-by: Nate W <natew@cncf.io>
2024-11-18 11:26:33 -08:00
Nate W d13d5c5acb
Updating Style Guide Headings and Titles section
Signed-off-by: Nate W <natew@cncf.io>

Signed-off-by: Nate W <natew@cncf.io>
2024-11-08 11:25:47 -08:00
Charles Uneze c9fb2678dd
Update style-guide.md 2024-06-07 16:31:48 +01:00
Kat Cosgrove 10878da2e3
updates style guide for open source and cloud native 2024-05-01 09:32:49 +01:00
Tim Bannister 255026f426 Write API kinds without code style 2024-02-14 12:34:04 +00:00
Aditya Samant a58dbb54df Correct the code style for K8S component names 2024-01-24 09:59:01 +05:30
Qiming Teng 80e6a832b0 Amend the style guide for line wrapping
We need to let contributors know that manual wrapping is a good
practice thus part of the style guide to make the lives of others
easier.
2023-10-02 20:54:20 +08:00
Karthik P M 29178c6a3b
Update style-guide.md 2023-08-07 22:54:38 +05:30
Karthik-PM dc9e07cb03 added .editorconfig 2023-08-05 16:39:52 +05:30
AmarNathChary ae69059fb1 fixed buggy example note shortcode 2023-06-21 13:29:17 +05:30
Michael 1ec7fe8e63 Tweak line wrappings in content-organization.md 2023-06-01 21:49:31 +08:00
Tim Bannister 252bcf6c29 Adapt Kubernetes basics tutorials for local use
Avoid relying on Katacoda.

Co-authored-by: Divya Mohan <divya.mohan0209@gmail.com>
2023-03-28 15:23:31 +01:00
Dipesh Rawat e7e4de3a0f
Added info for <codenew> shortcode in style guide (#39764)
* Add info for codenew shortcode in style guide

Signed-off-by: Dipesh Rawat <Dipesh.rawat@ibm.com>

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

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

* Addressed feedback comments

Signed-off-by: Dipesh Rawat <Dipesh.rawat@ibm.com>

* Update content/en/docs/contribute/style/hugo-shortcodes/index.md

Co-authored-by: Brad Topol <btopol@us.ibm.com>

* Update content/en/docs/contribute/style/hugo-shortcodes/index.md

Co-authored-by: Brad Topol <btopol@us.ibm.com>

---------

Signed-off-by: Dipesh Rawat <Dipesh.rawat@ibm.com>
Co-authored-by: Tim Bannister <tim@scalefactory.com>
Co-authored-by: Brad Topol <btopol@us.ibm.com>
2023-03-08 05:37:12 -08:00
Mauren Berti e16623fb96
fix: remove excessive line breaks in headings and titles section.
The subsection Headings and Titles of this document contains a dos and don'ts table that was
not rendering correctly do to a few surplus line breaks inside the Markdown for the table.
This commit removes these spaces so the table renders correctly.
2023-02-26 17:06:50 -05:00
Seokho Son 35ebbd1e41 Update page weights for pages in content/en/docs/contribute 2022-10-25 01:09:47 +09:00
Shannon Kularathna e688bb87bb Add title case style guideline 2022-09-21 20:54:48 +00:00
Kubernetes Prow Robot c932262b65
Merge pull request #35119 from Rishit-dagli/Rishit-dagli-api-resources-style
Add clarification about API resources to the Style Guide
2022-07-25 00:18:58 -07:00
Rishit Dagli 989e8ac98c Add clarification about API resources to the Style Guide 2022-07-23 18:37:34 +00:00
utkarsh-singh1 70ace47f66 Updated the style-guide doc
Signed-off-by: utkarsh-singh1 <utkarsh.singh1@india.nec.com>
2022-07-13 21:55:32 +05:30
budhirajamadhav fbeab275d0 Fix obsolete link to sig docs agenda doc 2021-11-23 03:12:10 +05:30
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