mirror of
https://github.com/kubernetes-sigs/node-feature-discovery.git
synced 2025-03-14 20:56:42 +00:00
docs: fix TOCs
Make table of contents in the pages cleaner and more readable by
dropping the main heading (H1 level) from TOCs. This was the original
intention with the usage of "no_toc" kramdown magic, which was broken,
however. The kramdown class magic needs to be specified on the line
immediately following the headinds, otherwise it has no effect. We need
to disable MD022 rule of mdlint as it does not understand this magic.
(cherry picked from commit 819f333118
)
This commit is contained in:
parent
c98bc029ed
commit
8bb46345e7
12 changed files with 25 additions and 44 deletions
|
@ -6,12 +6,10 @@ published: false
|
||||||
---
|
---
|
||||||
|
|
||||||
# Architecture
|
# Architecture
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -6,12 +6,10 @@ published: false
|
||||||
---
|
---
|
||||||
|
|
||||||
# Customization guide
|
# Customization guide
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 1
|
||||||
---
|
---
|
||||||
|
|
||||||
# Developer guide
|
# Developer guide
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -6,12 +6,10 @@ published: false
|
||||||
---
|
---
|
||||||
|
|
||||||
# Configuration file reference of end-to-end tests
|
# Configuration file reference of end-to-end tests
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 2
|
||||||
---
|
---
|
||||||
|
|
||||||
# Commandline flags of nfd-master
|
# Commandline flags of nfd-master
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 3
|
||||||
---
|
---
|
||||||
|
|
||||||
# Commandline flags of nfd-worker
|
# Commandline flags of nfd-worker
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 4
|
||||||
---
|
---
|
||||||
|
|
||||||
# Configuration file reference of nfd-worker
|
# Configuration file reference of nfd-worker
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 3
|
||||||
---
|
---
|
||||||
|
|
||||||
# Deployment and usage
|
# Deployment and usage
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 5
|
||||||
---
|
---
|
||||||
|
|
||||||
# Examples and demos
|
# Examples and demos
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 4
|
||||||
---
|
---
|
||||||
|
|
||||||
# Feature discovery
|
# Feature discovery
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -5,12 +5,10 @@ sort: 1
|
||||||
---
|
---
|
||||||
|
|
||||||
# Introduction
|
# Introduction
|
||||||
|
{: .no_toc}
|
||||||
{: .no_toc }
|
|
||||||
|
|
||||||
## Table of contents
|
## Table of contents
|
||||||
|
{: .no_toc .text-delta}
|
||||||
{: .no_toc .text-delta }
|
|
||||||
|
|
||||||
1. TOC
|
1. TOC
|
||||||
{:toc}
|
{:toc}
|
||||||
|
|
|
@ -1,4 +1,7 @@
|
||||||
all
|
all
|
||||||
|
# Exclude MD022 - Headers should be surrounded by blank lines. The kramdown
|
||||||
|
# "class magic" (like {: .no_toc}) needs to be directly below the heading line.
|
||||||
|
exclude_rule 'MD022'
|
||||||
# Exclude MD041 - First line in file should be a top level header
|
# Exclude MD041 - First line in file should be a top level header
|
||||||
exclude_rule 'MD041'
|
exclude_rule 'MD041'
|
||||||
rule 'MD013', :tables => false
|
rule 'MD013', :tables => false
|
||||||
|
|
Loading…
Add table
Reference in a new issue