chore(ci): Improve CI lint and test runners

- Reconfigures prettier linting.
- Adds .editorconfig to help with consistent editor settings
- Refactors test runs:
  - Removes test configuration from compose.yaml (not suited for this use case).
  - Splits test runner into test content setup and pytest that can be run separately or together (and with other test runners in the future).
  - Configuration is in Dockerfiles and command line (`.lintstagedrc.mjs`)
- Updates CONTRIBUTING.md
- Updates client library write examples in cloud-dedicated and clustered.

Author: jstirnaman

.editorconfig

@@ -0,0 +1,6 @@
+charset = utf-8
+insert_final_newline = true
+end_of_line = lf
+indent_style = space
+indent_size = 2
+max_line_length = 80

.gitignore

@@ -3,11 +3,15 @@
 public
 .*.swp
 node_modules
+.config*
+**/.env*
 *.log
 /resources
 .hugo_build.lock
 /content/influxdb/*/api/**/*.html
 /api-docs/redoc-static.html*
 .vscode/*
 .idea
-package-lock.json
+config.toml
+package-lock.json
+tmp

.husky/pre-commit

@@ -1,2 +1 @@
-npx lint-staged --relative --verbose
-yarn run test
+npx lint-staged --relative

.lintstagedrc.mjs

@@ -0,0 +1,44 @@
+// Lint-staged configuration. This file must export a lint-staged configuration object.
+
+function lintStagedContent(paths, productPath) {
+  const name = `staged-${productPath.replace(/\//g, '-')}`;
+
+  return [
+           `prettier --write ${paths.join(' ')}`,
+
+           `docker build . -f Dockerfile.tests -t influxdata-docs/tests:latest`,
+
+            // Remove any existing test container.
+           `docker rm -f ${name} || true`,
+
+           `docker run --name ${name} --mount type=volume,target=/app/content --mount type=bind,src=./content,dst=/src/content --mount type=bind,src=./static/downloads,dst=/app/data
+           influxdata-docs/tests --files "${paths.join(' ')}"`,
+
+           `docker build . -f Dockerfile.pytest -t influxdata-docs/pytest:latest`,
+
+           // Run test runners. If tests fail, the container will be removed,
+           //but the "test-" container will remain until the next run.
+           `docker run --env-file ${productPath}/.env.test
+           --volumes-from ${name} --rm
+           influxdata-docs/pytest --codeblocks ${productPath}/`
+  ];
+}
+
+export default {
+    "*.{js,css}": paths => `prettier --write ${paths.join(' ')}`,
+
+    // Don't let prettier check or write Markdown files for now;
+    // it indents code blocks within list items, which breaks Hugo's rendering.
+    // "*.md": paths => `prettier --check ${paths.join(' ')}`,
+
+    "content/influxdb/cloud-dedicated/**/*.md":
+      paths => lintStagedContent(paths, 'content/influxdb/cloud-dedicated'),
+    "content/influxdb/clustered/**/*.md":
+      paths => lintStagedContent(paths, 'content/influxdb/clustered'),
+    
+    // "content/influxdb/cloud-serverless/**/*.md": "docker compose run -T lint --config=content/influxdb/cloud-serverless/.vale.ini --minAlertLevel=error",
+
+    // "content/influxdb/clustered/**/*.md": "docker compose run -T lint --config=content/influxdb/clustered/.vale.ini --minAlertLevel=error",
+
+    // "content/influxdb/{cloud,v2,telegraf}/**/*.md": "docker compose run -T lint --config=.vale.ini --minAlertLevel=error"
+}

.prettierignore

@@ -0,0 +1,5 @@
+# Ignore Prettier checking for files
+**/.git
+**/.svn
+**/.hg
+**/node_modules

.prettierrc.yaml

@@ -1,4 +1,14 @@
-trailingComma: "es5"
-tabWidth: 2 
+#  ~/.prettierrc.yaml
+printWidth: 80
 semi: true 
 singleQuote: true
+tabWidth: 2
+trailingComma: "es5"
+useTabs: false
+overrides:
+  - files:
+      - "*.md"
+      - "*.markdown"
+    options:
+      proseWrap: "preserve"
+# Prettier also uses settings, such as indent, specified in .editorconfig