Skip to content

add a documentation page for the n8n community node - #266

Merged
rpietzsch merged 3 commits into
mainfrom
feature/n8n-node
Sep 11, 2026
Merged

rpietzsch merged 3 commits into
mainfrom
feature/n8n-node

Conversation

@seebi

@seebi seebi commented Sep 10, 2026

Copy link
Copy Markdown
Member

Adds the missing documentation page for the n8n community node that shipped with Corporate Memory 26.2, and carries two changes that came out of writing it.

⚠️ Repository policy change: a page has three titles, and they need not match

This is the part that needs a second opinion, because it reverses a rule the repository has been enforcing.

.claude/docs-guidelines/repo-conventions.md stated:

The page title (# Heading) and the .pages nav title must correspond.

That is wrong. A page carries its name in three places, and each serves a different purpose:

Place Purpose
the entry in the directory's .pages file the label in the navigation menu
title: in the Markdown front matter the site page title and the entry on the tags page
the # Heading at the top of the Markdown the visible title rendered on the page

They legitimately diverge in both directions. A menu label competes for horizontal space and is read inside its section, so it is often shorter than the heading. The front matter title is often longer than the heading, because the tags page lists pages flat, stripped of the hierarchy that would otherwise say what a page belongs to — which is exactly why every cmemc page sets title: "cmemc: Installation" against a heading of Installation.

The consequence for anyone editing: do not "fix" such a divergence as if it were drift, and in particular do not rewrite a deliberately chosen .pages entry just because the heading says something else.

The new page is itself an instance of this:

.pages n8n Integration — reads well next to Continuous Integration and Scheduling Workflows
title: n8n: Corporate Memory Community Node — self-describing in a flat tag listing
# Heading n8n Community Node

The corrected rule is recorded in both repo-conventions.md and CLAUDE.md.

The page

docs/automate/n8n-node/index.md — introduction, use cases, prerequisites, working mode.

  • Use cases: event-driven workflow execution, publishing graph content to downstream systems, Knowledge Graph lookup inside a larger automation.
  • Working mode: one credential, one node, three resources and their five actions, as a table using the action labels shown in the n8n node panel.
  • Technical detail stays external. Installation, credential fields and per-action parameters live in the repository README, which the page links to.
  • No version number appears on the page, so it does not age when the next npm release ships. The release note remains the version-stamped record.
  • The credential prerequisite points at a dedicated Keycloak client scoped to what the automation needs, rather than at the broadly privileged cmem-service-account that the Power BI and Redash pages reuse. Worth a look — it is a deliberate departure from the existing precedent.

The screenshot is the one already published in the 26.2 release note.

Also in this commit: a fifth card on the Automate landing page, the integrations entry repointed at the page, the 26.2 release note pointed at the page instead of at npm, and an Integration tag mapping in mkdocs.yml.

Integrations entries rewritten in the imperative

The entries in data/integrations.yml addressed the reader directly ("You can send and receive messages", "your Knowledge Graphs", "files you created") and spoke for eccenca in the first person ("by using our Power-BI-Connector"), against style guide 3.2. Nine entries are rewritten.

Three unrelated defects in the same texts are fixed along the way: "and captures its output" (Kubernetes), "to user and groups" and "in you Mattermost" (Mattermost).

The template comment at the top of the file keeps its "you" — it addresses the author of an entry, not a reader of the page.

Notes for the reviewer

  • task check passes on every commit.
  • Two claims on the page could not be verified against a running instance and rest on the README and on the node's Verified badge: that the node installs on n8n Cloud as well as self-hosted, and the wording of the five action labels beyond what the screenshot shows.
  • While mapping the Integration tag I found there is no md-tag--* CSS anywhere in the repo, so the value in extra.tags acts as a slug and no icon asset is needed. repo-conventions.md claims an unmapped tag "renders without an icon", which appears to overstate what this build does — left alone, not verified end to end.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DoyrnqQWXJBjPFqX1kj5cP

seebi and others added 3 commits September 10, 2026 20:01
A page carries its name in three places, and the conventions claimed they had
to correspond. They do not: the `.pages` entry is the label in the navigation
menu, `title:` in the front matter is the site page title and the entry on the
tags page, and the `# Heading` is the visible title on the page itself.

A menu label is written for scanning inside its section and is often shorter
than the heading. The front matter title is often written longer than the
heading, because the tags page lists pages flat, without the hierarchy that
would otherwise say what a page belongs to - which is why every cmemc page
sets `title: "cmemc: Installation"` against a heading of `Installation`.

Divergence between the three is therefore not drift and is not to be corrected.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DoyrnqQWXJBjPFqX1kj5cP
The entries addressed the reader directly ("You can send and receive
messages", "your Knowledge Graphs", "files you created") and spoke for
eccenca in the first person ("by using our Power-BI-Connector"), against
style guide 3.2. They are rewritten in the imperative.

Three unrelated defects in the same texts are fixed along the way:
"and captures its output" (Kubernetes), "to user and groups" and
"in you Mattermost" (Mattermost).

The template comment at the top keeps its "you", as it addresses the author
of an entry rather than a reader of the page.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DoyrnqQWXJBjPFqX1kj5cP
Corporate Memory 26.2 shipped @eccenca/n8n-nodes-corporate-memory, an n8n
community node, and the release note was the only place describing it.

The page introduces the node, names three use cases (event-driven workflow
execution, publishing graph content downstream, Knowledge Graph lookup inside
a larger automation), lists the prerequisites and describes the working mode:
one credential, one node, three resources and their five actions. Technical
detail - installation, credential fields, per-action parameters - stays in the
repository README, which the page links to.

The credential prerequisite points at a dedicated Keycloak client scoped to
what the automation needs, rather than at the broadly privileged
cmem-service-account that the Power BI and Redash pages reuse.

Also:

- lists the page as a fifth card on the Automate landing page
- points the n8n entry of the integrations page at it
- points the 26.2 release note at it instead of at npm
- maps the Integration tag in mkdocs.yml

The screenshot is the one from the 26.2 release note. No version number
appears on the page, so it does not age with the next npm release.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DoyrnqQWXJBjPFqX1kj5cP
@github-actions

github-actions Bot commented Sep 10, 2026

Copy link
Copy Markdown

Test Results

0 tests  ±0   0 ✅ ±0   0s ⏱️ ±0s
0 suites ±0   0 💤 ±0 
1 files   ±0   0 ❌ ±0 

Results for commit 286eb74. ± Comparison against base commit 7fa06a0.

♻️ This comment has been updated with latest results.

@rpietzsch rpietzsch left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@rpietzsch
rpietzsch merged commit be18697 into main Sep 11, 2026
3 checks passed
@rpietzsch
rpietzsch deleted the feature/n8n-node branch September 11, 2026 10:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants