readme-links

New Settings Repository Since v0.1.0

Linter: the README links each of the configured documents that exists.

Example#

README.md:

# Project

A tool.

With CONTENTS.md in the repository, markright check reports:

README.md:1: does not link CONTENTS.md (readme-links)
markright: 1 issue(s)

Fixed:

# Project

A tool. See the [contents](CONTENTS.md).

Settings#

Under linters.settings.readme-links:

KeyMeaningDefault
fileThe READMEREADME.md
linksDocuments the README must link, when they existCONTENTS.md, GLOSSARY.md, STANDARDS.md

With the defaults, in .markright.yaml:

linters:
  settings:
    readme-links:
      file: README.md
      links: [CONTENTS.md, GLOSSARY.md, STANDARDS.md]

or in .markright.toml:

[linters.settings.readme-links]
file = "README.md"
links = ["CONTENTS.md","GLOSSARY.md","STANDARDS.md"]

Turning it off#

linters:
  disable: [readme-links]
[linters]
disable = ["readme-links"]

More in Rules.

Settings

Appearance

ThemeColours of every page

Reading

Code blocksLines longer than the block
TablesCells wider than the page

Accessibility

Text sizeEvery page, in proportion
LinksLinks inside the text
MotionAnimations and smooth scrolling
ScrollbarsCode blocks, tables and other scrolling areas