Commit Graph

67 Commits

Author SHA1 Message Date
Jimmy Song 0b2ea1d38e Enable extra lint stuff (#2158) 2018-08-06 09:43:31 -07:00
Martin Taillefer fd290dc73e
Improve linting (#2148)
- We now detect text blocks that are incorrectly indented.

- We now detect image captions that end in a period.

- We now detect page descriptions that don't end in a period.

- CircleCi now runs linting without minifying HTML first, improving perf and
improving error output.

- In CircleCi, we now have a per-build cache for HTML proofer output. This
helps reduce the frequency of link timeout errors.

- Fix errors flagged by the above new lint checks.
2018-08-04 08:44:06 -07:00
Jimmy Song 0492530216 Fix Chinese spelling errors (#2044)
* Chinese: about/contribute/github/index.md

- translate working with GitHub
- translate contributing to docs index

* Chinese: add two indexes for policy and telemetry

- add policy and telemetry index
- add adapters index

* modify translation

* Fix Chinese spelling errors

- enable Chinese spelling checks
- fix spelling errors
- refer to #2038
2018-07-30 04:34:54 -07:00
Martin Taillefer 1c300c99bd
Spelling improvements (#2037)
Remove a bunch of entries that shouldn't have been in the spelling dictionary
and correct content aoocrdingly.

I'm disabling the Chinese spell checking for now, since I'm not able to fix the
spelling errors that emerged there. Once this PR is in, I'll file an issue to get
those spelling errors addressed and checking reenabled.
2018-07-29 14:27:06 -07:00
Martin Taillefer 04cc4a3d84
Start populating the ops guide. (#1994) 2018-07-26 15:05:23 -07:00
mtail 3dee29d873 Fix a linting error. 2018-07-23 17:27:29 -07:00
Martin Taillefer 5527dcbaf6
Switch uses of funny quotation marks to plain ones. (#1914)
- Use only standard quotation marks to avoid cut & paste stuff not working

- Put in a lint rule to prevent further use of non-plain quotation marks.
2018-07-22 08:48:03 -07:00
Martin Taillefer 597f7ce3b4
Enable more linting rules (#1824)
Fix feported linting errors.
2018-07-15 07:49:11 -07:00
Martin Taillefer f4a0656ab1 Add a lint check for incorrectly indented code blocks. (#1800)
Fixed a problem reported by the link check.
2018-07-13 07:26:36 -07:00
Martin Taillefer 0541000be8
Switch from ``` to {{< text >}} to indicate text blocks. (#1644)
This fixes a number of cases of incorrect formatting of code blocks
throughout the site.
2018-06-30 07:11:21 -07:00
mtail fa0a3fe408 Turn htmlproofer back on. 2018-06-28 07:53:34 -07:00
Martin Taillefer 5a1b090fbc
Improve handling for code blocks (#1580)
- Add the {{< text >}} shortcode as a way to declare code blocks. This shortcode
is intended to hide the subtleties around code blocks. More specifically, it
provides a transparent workaround for the Hugo bug around converting indented
code blocks with lines starting with dashes. It also deals with the special
formatting case we have around command-lines that start with `cat <<EOF`.

- Rename the {{< file_content >}} shortcode to {{< text_file >}} and the
{{< fetch_content >}} shortcode to {{< text_dynamic >}} for consistency in naming.
2018-06-28 06:29:27 -07:00
mtail 5296742475 First pass at refactoring file locations.
This also reenables html proofing, which I accidentally left
off in an earlier commit.
2018-06-26 23:29:47 -07:00
Martin Taillefer ac1cbc7730
Improve linting script (#1582)
- Add useful error messages so people can self-serve when they get linting errors.

- Run all linters even if one fails. This gives you all the linting errors in one shot.
2018-06-25 06:46:47 -07:00
Jimmy Song b9f7174e2b quick start doc translation (#1523)
* quick start doc translation

* fix the markdown style

* enable Chinese spell checker
2018-06-18 06:08:12 -07:00
Martin Taillefer 857f86abad
Update Makefile for simplified Netlify scheme. (#1525) 2018-06-15 17:02:08 -07:00
mtail f8a5265efa Get all the bits in place to do docker-based build, generation, linting, and serving of the site. 2018-06-15 15:51:04 -07:00