[mandy-chessell]

Karma points documentation for the Simon Contribution Recorder

Summary

In 6.3, karma points are awarded by a new nanny integration connector, the Simon Contribution Recorder, instead of the Award Karma Points Lovelace watchdog service (odpi/egeria PR to follow). This PR updates the pages that describe karma points, adds the 6.3 release notes, and regenerates the mermaid graphs that still showed the karma service.

Pages

• concepts/karma-point.md - rewritten: Simon awards the points from the Core Content Pack's OpenMetadataObservability group, one per change, written on each refresh (12 minutes by default); the actor profile requirement; and a new People and automation section on ignoredUserIdPatterns, which by default (.*npa, .*engine) awards points to people only. The page used to say automation earns points.
• egeria-solutions/organization-insight/overview.md - How points are awarded rewritten, with a table of what happens in each situation and its audit log message (SIMON-CONTRIBUTION-RECORDER-0003 to -0007); points are added to the stored total; changes made while Simon is not running earn nothing; run Simon only once per set of repositories; why content pack loads produce discarded points for "Egeria Project". The karma engine action graph is removed, and the introduction no longer says that all of Organization Insight comes from the Lovelace services.
• features/metadata-observability/overview.md - Simon added to Figure 1 and the introduction, with a new The Simon Contribution Recorder section after Pepys; the karma row removed from the Lovelace services table; the operational view table and the set-up list name Simon.
• features/people-roles-organizations/overview.md and types/1/0125-Contribution.md - name Simon and the people-only default; the type page gives the qualifiedName and displayName of the records Simon creates.
• guides/developer/watchdog-action-services/overview.md - the worked example was the karma service. The code samples now use an illustrative ChangeWatchdogService, and the examples list says Egeria currently supplies no watchdog action service, linking the karma service's source at tag V6.2.

Corrections found on the way

• isPublic is not a property of ContributionRecord (the type has only karmaPoints, and the 0125 diagram already agreed). Removed from the concept, type and Organization Insight pages; the Organization Insight page now says visibility follows the security of the actor profile.

Release notes (snippets/release-notes/6-3.md)

• New entries: Karma points are awarded by the Simon Contribution Recorder, Removing an element from a content pack removes it from the repository, and Faster reads in the PostgreSQL repository.
• Upgrade notes: add simonnpa to the integrationConnector group of your own user directory; automation no longer earns karma points by default; the karma definitions are soft-deleted on upgrade and the EgeriaWatchdog engine has no services; the new PostgreSQL indexes are built on first start, or can be built beforehand with CREATE INDEX CONCURRENTLY under the same names.

Mermaid snippets

Regenerated from a platform running the new content packs, using the same logic as extract-mermaid-graphs.ipynb:

• Organization Insight content pack graph and solution blueprint graph, Core content pack solution blueprint graph, both Open Metadata Digital Products content pack graphs, and the Babbage Analytical Engine component graph. They no longer show the karma service, and now show Babbage's new "schedules" wires to the Lovelace services. Their last regeneration was at 6.0, so the diffs also include other changes to those packs since then.
• Deleted: the three award-karma-points snippets, and the egeria-observability-content-pack and jacquard-harvester-content-pack graphs, whose blueprints no longer exist. None of them was included by any page.

Testing

• mkdocs build succeeds with no new warnings; the new anchors (#the-simon-contribution-recorder, #how-points-are-awarded, #people-and-automation) render.
• Every internal link and include in the changed pages resolves.

🤖 Generated with Claude Code