neo4j-documentation / docs-refresh

3 stars 17 forks source link

remove APOC from lint step #73

Closed moxious closed 2 years ago

moxious commented 2 years ago

APOC's build chain doesn't run npm run lint in antora. They currently have some broken references, and this repo running lint on everything as a precondition for publishing is breaking publish of any site because of APOC errors in their asciidoc.

This change creates a temporary playbook that is all of the labs docs MINUS apoc just for the lint step.

This:

Build errors were discovered here: https://github.com/neo4j-documentation/docs-refresh/runs/4371320446?check_suite_focus=true

Right now, APOC errors are limited to unresolved xrefs, or broken links.

Unresolved xrefs (grouped by origin):

repo: https://github.com/neo4j-contrib/neo4j-apoc-procedures | branch: 4.1 | component: apoc | version: 4.1
  path: docs/asciidoc/modules/ROOT/pages/import/load-json.adoc | xref: :partial$usage/apoc.import.json.adoc
  path: docs/asciidoc/modules/ROOT/pages/import/xml.adoc | xref: :partial$usage/apoc.import.json.adoc
  path: docs/asciidoc/modules/ROOT/pages/overview/apoc.import/apoc.import.graphml.adoc | xref: :partial$usage/apoc.import.csv.adoc
  path: docs/asciidoc/modules/ROOT/pages/overview/apoc.import/apoc.import.json.adoc | xref: :partial$usage/apoc.import.csv.adoc
  path: docs/asciidoc/modules/ROOT/pages/overview/apoc.load/apoc.load.csv.adoc | xref: :partial$usage/apoc.import.csv.adoc

antora: xref validation failed! Found 5 unresolved xrefs. See previous report for details.