Skip to content

[Task]: cleanup doc errors #6012

@bamaer

Description

@bamaer

What needs to happen?

There are multiple errors when running the documentation build.

yarn run v1.22.10
$ run-s preview-local:*
$ antora --require ./menu.js site-local.yml
[10:42:47.802] ERROR (asciidoctor): target of image not found: icons/expand-all.svg
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/hop-gui/hop-gui-git.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:47.804] ERROR (asciidoctor): target of image not found: icons/collapse-all.svg
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/hop-gui/hop-gui-git.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:47.805] ERROR (asciidoctor): target of image not found: icons/hide.svg
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/hop-gui/hop-gui-git.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:47.845] WARN (asciidoctor): unterminated tabs block
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/hop-doc/index.adoc:81
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:47.954] WARN (asciidoctor): unterminated example block
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop.adoc:26
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.013] ERROR (asciidoctor): target of image not found: icons/SFI.svg
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/salesforce-connection.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.014] WARN (asciidoctor): skipping reference to missing attribute: sf_pass
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/salesforce-connection.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.014] WARN (asciidoctor): skipping reference to missing attribute: sf_jwt_private_key
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/salesforce-connection.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.015] WARN (asciidoctor): skipping reference to missing attribute: sf_pass
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/salesforce-connection.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.016] WARN (asciidoctor): skipping reference to missing attribute: sf_user
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/salesforce-connection.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.017] WARN (asciidoctor): skipping reference to missing attribute: sf_consumer_key
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/salesforce-connection.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.017] WARN (asciidoctor): skipping reference to missing attribute: sf_jwt_private_key
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/salesforce-connection.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.229] ERROR (asciidoctor): target of xref not found: metadata-types/variable-resolver/vault-variable-resolver.adoc
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/metadata-types/variable-resolver/azure-key-vault-variable-resolver.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:48.749] WARN (asciidoctor): unterminated table block
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/pipeline/transforms/getdatafromxml.adoc:142
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:49.281] WARN (asciidoctor): skipping reference to missing attribute: customerid
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/pipeline/transforms/tableinput.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:49.283] WARN (asciidoctor): skipping reference to missing attribute: prm_id
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/pipeline/transforms/tableinput.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:49.285] WARN (asciidoctor): skipping reference to missing attribute: startdate
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/pipeline/transforms/tableinput.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:49.285] WARN (asciidoctor): skipping reference to missing attribute: tablename
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/pipeline/transforms/tableinput.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:49.285] WARN (asciidoctor): skipping reference to missing attribute: condition
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/pipeline/transforms/tableinput.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:49.286] WARN (asciidoctor): skipping reference to missing attribute: param
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/pipeline/transforms/tableinput.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
[10:42:49.475] WARN (asciidoctor): skipping reference to missing attribute: project_home
    file: /Users/bart/git-hop/hop/docs/hop-user-manual/modules/ROOT/pages/workflow/actions/filesexist.adoc
    source: /Users/bart/git-hop/hop/ (refname: main <worktree>, start path: docs/hop-user-manual)
Site generation complete!
Open file:///Users/bart/git-hop/hop-website/documentation/index.html in a browser to view your site.
$ hugo server -D
port 1313 already in use, attempting to use an available port
Start building sites …

                   |  EN
-------------------+-------
  Pages            |  145
  Paginator pages  |   15
  Non-page files   |    0
  Static files     | 1582
  Processed images |    0
  Aliases          |    1
  Sitemaps         |    1
  Cleaned          |    0

Built in 1366 ms
Watching for changes in /Users/bart/git-hop/hop-website/{archetypes,content,documentation,layouts,package.json,static}
Watching for config changes in /Users/bart/git-hop/hop-website/config.toml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:57182/ (bind address 127.0.0.1)
Press Ctrl+C to stop

Change detected, rebuilding site.
2025-11-15 10:43:07.567 +0100
Rebuilt in 2594 ms

Issue Priority

Priority: 2

Issue Component

Component: Documentation

Metadata

Metadata

Assignees

Labels

Type

No fields configured for Task.

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions