website: adds content-check command and README update (#16579)

This commit is contained in:
Bryce Kalow 2023-03-08 15:30:38 -06:00 committed by GitHub
parent ef2070442d
commit 0c38ade8dd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 2143 additions and 26 deletions

View File

@ -100,6 +100,16 @@ The significant keys in the YAML frontmatter are:
> ⚠️ If there is a need for a `/api/*` url on this website, the url will be changed to `/api-docs/*`, as the `api` folder is reserved by next.js. > ⚠️ If there is a need for a `/api/*` url on this website, the url will be changed to `/api-docs/*`, as the `api` folder is reserved by next.js.
### Validating Content
Content changes are automatically validated against a set of rules as part of the pull request process. If you want to run these checks locally to validate your content before comitting your changes, you can run the following command:
```
npm run content-check
```
If the validation fails, actionable error messages will be displayed to help you address detected issues.
### Creating New Pages ### Creating New Pages
There is currently a small bug with new page creation - if you create a new page and link it up via subnav data while the server is running, it will report an error saying the page was not found. This can be resolved by restarting the server. There is currently a small bug with new page creation - if you create a new page and link it up via subnav data while the server is running, it will report an error saying the page was not found. This can be resolved by restarting the server.

2153
website/package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@ -4,7 +4,8 @@
"version": "0.0.1", "version": "0.0.1",
"author": "HashiCorp", "author": "HashiCorp",
"devDependencies": { "devDependencies": {
"@hashicorp/platform-cli": "^2.5.1", "@hashicorp/platform-cli": "^2.6.0",
"@hashicorp/platform-content-conformance": "^0.0.10",
"dart-linkcheck": "2.0.15", "dart-linkcheck": "2.0.15",
"husky": "4.3.8", "husky": "4.3.8",
"next": "^12.3.1", "next": "^12.3.1",
@ -23,7 +24,8 @@
"generate:readme": "next-hashicorp markdown-blocks README.md", "generate:readme": "next-hashicorp markdown-blocks README.md",
"lint": "next-hashicorp lint", "lint": "next-hashicorp lint",
"start": "./scripts/website-start.sh", "start": "./scripts/website-start.sh",
"linkcheck": "linkcheck https://consul.io" "linkcheck": "linkcheck https://consul.io",
"content-check": "hc-content --config base-docs"
}, },
"engines": { "engines": {
"npm": ">=7.0.0" "npm": ">=7.0.0"