From 637f58c342f08c485462e495c272cfa9d99c94a3 Mon Sep 17 00:00:00 2001
From: Jukka Aho <ahojukka5@gmail.com>
Date: Sat, 9 May 2026 16:30:24 +0300
Subject: [PATCH] feat(docs): add NEWS.md

docs/NEWS.md | 19 +++++++++++++++++++  1 file changed, 19 insertions(+)
---
 docs/NEWS.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 docs/NEWS.md

diff --git a/docs/NEWS.md b/docs/NEWS.md
new file mode 100644
index 0000000..ee9e157
--- /dev/null
+++ b/docs/NEWS.md
@@ -0,0 +1,19 @@
+# JuliaFEM.jl news
+
+User-visible and contributor-facing changes. The package is **0.x**; treat this
+file as a lightweight changelog until a **1.0** release with full SemVer discipline.
+
+## 0.5.2 (current `Project.toml`)
+
+- Type-stable **`Element{K,P,S,N}`** pipeline with **`@DOFSet`**, **`DOFHandler`**,
+  and domain **`AbstractKernel`** implementations under `src/domains/`.
+- **`DOFBasedCOOAssembler`** and matrix-free utilities under `src/assemblers/`
+  (including preconditioners and MPC hooks where merged on your branch).
+- Optional **`JuliaFEM.Legacy`** behind **`JULIAFEM_ENABLE_LEGACY=1`** for older
+  `Problem` / Dict-field workflows.
+
+For earlier history, use `git log` and archived notebooks under `docs/tutorials/`
+(reference only).
+
+When you land a user-visible change, add a dated bullet under a new **Unreleased**
+heading in the same PR that updates code or docs.