mkdocs2confluence 0.13.3__tar.gz → 0.13.5__tar.gz

{mkdocs2confluence-0.13.3/src/mkdocs2confluence.egg-info → mkdocs2confluence-0.13.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.13.3
+Version: 0.13.5
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later

{mkdocs2confluence-0.13.3 → mkdocs2confluence-0.13.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs2confluence"
-version = "0.13.3"
+version = "0.13.5"
 description = "Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more"
 readme = "README.md"
 license = { text = "GPL-3.0-or-later" }

{mkdocs2confluence-0.13.3 → mkdocs2confluence-0.13.5/src/mkdocs2confluence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.13.3
+Version: 0.13.5
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later

{mkdocs2confluence-0.13.3 → mkdocs2confluence-0.13.5}/src/mkdocs_to_confluence/cli.py

@@ -544,7 +544,7 @@ def _cmd_publish(args: argparse.Namespace) -> None:
         print(f"Dry run: would publish {len(pages)} page(s) to {conf_config.base_url}")
         for page in pages:
             print(f"  {page.docs_path} → '{page.title}'")
-        if conf_config.changelog_file and not partial:
+        if conf_config.changelog_file:
             from mkdocs_to_confluence.publisher.changelog import _extract_title
             cl_path = config.docs_dir / conf_config.changelog_file
             cl_title = _extract_title(cl_path) or "What's New"
@@ -580,13 +580,12 @@ def _cmd_publish(args: argparse.Namespace) -> None:
                 prune=getattr(args, "prune", False) and not partial,
                 quiet=args.quiet,
             )
-            # Changelog is a pinned top-level page — always publish on full runs,
-            # skip on partial runs (--page / --section) like all other publish behaviour.
-            if not partial:
-                publish_changelog(
-                    config, conf_config, client, space_id,
-                    space_key=conf_config.space_key, quiet=args.quiet,
-                )
+            # Changelog is a pinned top-level page independent of the nav —
+            # always publish it when it has updates, even on partial runs.
+            publish_changelog(
+                config, conf_config, client, space_id,
+                space_key=conf_config.space_key, quiet=args.quiet,
+            )
     except ConfluenceError as exc:
         print(f"error: {exc}", file=sys.stderr)
         sys.exit(1)

{mkdocs2confluence-0.13.3 → mkdocs2confluence-0.13.5}/src/mkdocs_to_confluence/skill_installer.py

@@ -66,7 +66,7 @@ def install_skill(
     if _want("claude"):
         claude_dir = project_dir / ".claude"
         if explicit or claude_dir.exists():
-            dest = claude_dir / "commands" / "changelog.md"
+            dest = claude_dir / "commands" / "mk2conf-changelog.md"
             dest.parent.mkdir(parents=True, exist_ok=True)
             dest.write_text(content_body, encoding="utf-8")
             installed.append(("claude", dest))

{mkdocs2confluence-0.13.3 → mkdocs2confluence-0.13.5}/src/mkdocs_to_confluence/skills/mkdocs-changelog/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: mkdocs-changelog
 description: Analyse doc changes since the last CHANGELOG.md update and draft a major-change entry if the changes qualify.
-version: "1.0.0"
+version: "1.1.0"
 tags: [documentation, git, changelog, mkdocs, confluence]
 specificity: context-specific
 tool_agnostic: true
@@ -47,23 +47,31 @@ Analyse git changes to the docs directory since the last `CHANGELOG.md` commit.
 ```markdown
 ## YYYY-MM-DD — Brief title describing the major change
 
-One or two sentences summarising what fundamentally changed and why it matters to readers.
-
 ### Added
 - …
 
 ### Changed
 - …
 
+### Deprecated
+- …
+
 ### Removed
 - …
+
+### Fixed
+- …
+
+### Security
+- …
 ```
 
    Rules for the entry:
    - Date is today's date in `YYYY-MM-DD` format
-   - Sections (`Added`, `Changed`, `Removed`) are included only when non-empty
-   - No version numbers — dates only
    - Title is a brief, reader-facing description (not a git commit message)
+   - No version numbers — dates only
+   - **Include only sections that have actual content** — omit any empty section entirely
+   - Section meanings: `Added` (new content), `Changed` (updated content), `Deprecated` (content being phased out), `Removed` (deleted content), `Fixed` (corrected errors or misleading information), `Security` (security-related documentation updates)
 
    Prepend the entry above any existing entries in `CHANGELOG.md`. Do not commit — the user reviews, edits if needed, and commits manually.
 
@@ -71,7 +79,14 @@ One or two sentences summarising what fundamentally changed and why it matters t
 
 - **Do not draft an entry for every change.** The changelog is for readers who want to know what fundamentally changed, not a git log. When in doubt, do not draft.
 - **Do not commit.** Always leave the file for the user to review. The user runs `git add` and `git commit` themselves before publishing.
-- **If CHANGELOG.md does not exist yet**, create it with just the new entry (no header needed).
+- **If `CHANGELOG.md` does not exist yet**, create it with this header before the first entry:
+
+```markdown
+# Changelog
+
+All notable changes to this documentation are recorded here.
+The format is inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+```
 
 ## Verification
 

{mkdocs2confluence-0.13.3 → mkdocs2confluence-0.13.5}/tests/test_skill_installer.py

@@ -45,7 +45,7 @@ def test_install_skill_claude(tmp_path: Path) -> None:
     assert len(installed) == 1
     name, dest = installed[0]
     assert name == "claude"
-    assert dest == tmp_path / ".claude" / "commands" / "changelog.md"
+    assert dest == tmp_path / ".claude" / "commands" / "mk2conf-changelog.md"
     content = dest.read_text(encoding="utf-8")
     # Frontmatter stripped for Claude Code
     assert "name: mkdocs-changelog" not in content
@@ -117,7 +117,7 @@ def test_install_skill_explicit_tool_ignores_detection(tmp_path: Path) -> None:
 
 def test_install_skill_overwrites_existing(tmp_path: Path) -> None:
     (tmp_path / ".claude").mkdir()
-    dest = tmp_path / ".claude" / "commands" / "changelog.md"
+    dest = tmp_path / ".claude" / "commands" / "mk2conf-changelog.md"
     dest.parent.mkdir(parents=True, exist_ok=True)
     dest.write_text("old content", encoding="utf-8")