Update CHANGELOG.md in preparation for next patch release.

Signed-off-by: Rahul Krishna <i.m.ralk@gmail.com>

Author: rahlk

.github/workflows/release.yml

@@ -66,6 +66,14 @@ jobs:
       - name: Build Package
         run: poetry build
 
+      - name: Read Changelog Entry
+        id: changelog_reader
+        uses: mindsers/changelog-reader-action@v2
+        with:
+          validation_level: warn
+          version: ${{ steps.tag_name.outputs.current_version }}
+          path: ./CHANGELOG.md
+
       - name: Build Changelog
         id: gen_changelog
         uses: mikepenz/release-changelog-builder-action@v5

CHANGELOG.md

@@ -5,10 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [v1.1.0] - 2025-08-21
+## [v1.0.7] - 2025-08-21
+
+### Added
+- Doctest-style Examples across the public API surface of JavaAnalysis, PythonAnalysis, CAnalysis, and core CLDK helpers. Coverage includes Java CRUD operations and comment/docstring query APIs, plus concise inline examples for Python and C where applicable.
+- Examples documenting expected NotImplementedError behavior for placeholder APIs (PythonAnalysis and CAnalysis) using doctest flags.
+
+### Changed
+- Converted and standardized docstrings to strict Google style (Args, Returns, Raises, Examples) across edited modules.
+- Standardized Examples to use the CLDK facade (e.g., `CLDK(language="java").analysis(...)`) instead of raw constructor calls.
+- Normalized all doctest Example inputs to single-line strings to ensure reliable mkdocstrings rendering.
+- Clarified `CLDK.analysis` return type with a precise union: `JavaAnalysis | PythonAnalysis | CAnalysis`.
 
 ### Fixed
 - Fixed README.md logo display on PyPI by updating image URLs to use raw GitHub URLs and maintaining theme-based auto-switching with proper fallback
+- mkdocstrings rendering issues caused by multi-line doctest strings and formatting inconsistencies.
+- Replaced confusing examples like `JavaAnalysis(None, None, ...)` with clear CLDK-based initialization patterns.
+- Packaging: ensured the built wheel includes the `cldk` package by adding `packages = [{ include = "cldk" }]` to Poetry configuration.
+
+### Removed
+- Multi-line doctest strings in Examples that broke mkdocstrings rendering; all examples are now single-line.
 
 ## [v1.0.6] - 2025-07-23
 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "cldk"
-version = "1.0.6"
+version = "1.0.7"
 description = "The official Python SDK for Codellm-Devkit."
 authors = ["Rahul Krishna <i.m.ralk@gmail.com>", "Rangeet Pan <rangeet.pan@ibm.com>", "Saurabh Sinhas <sinhas@us.ibm.com>",
             "Raju Pavuluri <pavuluri@us.ibm.com>"]