Skip to content

BASE 1.3.0 documentation fixes and cleanups (SPECBASE-48)#19

Open
sebastian-iancu wants to merge 8 commits into
masterfrom
fix/updates-and-cleanups
Open

BASE 1.3.0 documentation fixes and cleanups (SPECBASE-48)#19
sebastian-iancu wants to merge 8 commits into
masterfrom
fix/updates-and-cleanups

Conversation

@sebastian-iancu

Copy link
Copy Markdown
Member

Summary

Documentation fixes and cleanups for the BASE Release 1.3.0 (unreleased) sources, primarily addressing SPECBASE-48 (documentation fixes and typos, incl. SPECPR-392), with a RESOURCE_DESCRIPTION correction from SPECBASE-39 and AI-agent tooling config.

Changes

  • SPECBASE-48 — BMM/class-table cleanups:
    • Normalize asterisk HTML entities (**) in BMM and class tables
    • Fix VALIDITY_KIND doc count and PARTY_REF invariant spacing
    • Replace smart quotes with straight quotes in BMM expressions
    • Add missing RESOURCE_DESCRIPTION invariants
    • Update amendment records across documents for BASE Release 1.3.0 (unreleased)
  • SPECBASE-39 — fix description of RESOURCE_DESCRIPTION.lifecycle_state per agreement
  • Repo tooling — add .gitignore entries, AGENTS.md / CLAUDE.md AI guidance, and Claude settings.json

Notes

  • Source-only changes (BMM schema + AsciiDoc amendment records + repo config). Regenerated docs/*.html publication artifacts are intentionally not included in this PR.

🤖 Generated with Claude Code

sebastian-iancu and others added 8 commits June 24, 2026 14:11
…md and CLAUDE.md for AI guidance; add settings.json for Claude permissions and plugins.
…ultiple documents, including documentation fixes, BMM definitions, and updated issue references (SPECBASE-48)
… class tables

Replace the pre-escaped * HTML entity with the literal '*' character in
openehr_base_1.3.0.bmm.json: the multiply operator alias, the
Multiplicity_unbounded_marker constant and the Regex_any_pattern constant.
The model should carry the plain character; output-format escaping is the
publisher's job. Regenerate the eight affected docs/UML/classes tables
(basic_definitions, multiplicity_interval, numeric, integer, integer64,
real, double, iso8601_duration); the only change is * -> * on one line
each.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Drop auto-approval of destructive/local-mutating git ops from the shared
.claude/settings.json: git reset (--hard), git checkout (-f / path revert),
git worktree (remove --force), and git branch (-D). These now prompt.

Retains read-only/low-risk entries: git diff, git add, git commit, the
trusted WebFetch domain, and the read-only Atlassian MCP lookups.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant