add note on rewrite

qmacro · qmacro · commit 0db330f2308f · 2026-02-25T13:47:26.000Z
diff --git a/tutorials/odata-dd-1-origins/odata-dd-1-origins.md b/tutorials/odata-dd-1-origins/odata-dd-1-origins.md
@@ -25,6 +25,8 @@ OData is an open standard that is both a data format and a protocol for consumin
 
 OData has its origins in the world of weblogs and syndication, but now serves to power a great deal of the API and integration activities in typical SAP enterprise environments. This tutorial will help you understand OData's origins.
 
+> This tutorial belongs to the OData Deep Dive mission, a re-write of the original. The re-write is a work in progess, please proceed with caution! More info can be found in the blog post [OData Deep Dive rewrite in the open](https://qmacro.org/blog/posts/2026/02/02/odata-deep-dive-rewrite-in-the-open/).
+
 ---
 
 ### Examine RSS, an ancestor of OData
diff --git a/tutorials/odata-dd-2-standards/odata-dd-2-standards.md b/tutorials/odata-dd-2-standards/odata-dd-2-standards.md
@@ -21,6 +21,8 @@ time: 20
 
 There are myriad resources on the Web about OData. After all, it's a standard that's been around since 2007. There are some key resources that are important to know about, and in this tutorial, you'll find out about them and become more comfortable navigating them.
 
+> This tutorial belongs to the OData Deep Dive mission, a re-write of the original. The re-write is a work in progess, please proceed with caution! More info can be found in the blog post [OData Deep Dive rewrite in the open](https://qmacro.org/blog/posts/2026/02/02/odata-deep-dive-rewrite-in-the-open/).
+
 ---
 
 ### Understand OASIS and its role
diff --git a/tutorials/odata-dd-3-northbreeze/odata-dd-3-northbreeze.md b/tutorials/odata-dd-3-northbreeze/odata-dd-3-northbreeze.md
@@ -22,11 +22,13 @@ In order to take you through various OData concepts in the [OData Deep Dive](htt
 
 The service is provided by a CAP server, and the definition is in a publicly available repository, along with the definition of a container image.
 
+> This tutorial belongs to the OData Deep Dive mission, a re-write of the original. The re-write is a work in progess, please proceed with caution! More info can be found in the blog post [OData Deep Dive rewrite in the open](https://qmacro.org/blog/posts/2026/02/02/odata-deep-dive-rewrite-in-the-open/).
+
 You will need:
 
 - A Docker engine (in the form of Docker Desktop, Podman, or similar)
 
-> This tutorial is a work-in-progress; further updates need to include:
+> This tutorial is to receive further updates to include:
 >
 > - Making multi-arch images available
 > - Running as a dev container in VS Code and GitHub Codespaces
diff --git a/tutorials/odata-dd-4-metadata/odata-dd-4-metadata.md b/tutorials/odata-dd-4-metadata/odata-dd-4-metadata.md
@@ -24,6 +24,8 @@ A key resource in any OData service is its metadata document. In this tutorial y
 
 Throughout this tutorial you should endeavor to use your own instance of the Northbreeze service (see the previous [Northbreeze](https://developers.sap.com/tutorials/odata-dd-3-northbreeze.html) tutorial); for illustration purposes, URLs for the publicly available instance will be used here.
 
+> This tutorial belongs to the OData Deep Dive mission, a re-write of the original. The re-write is a work in progess, please proceed with caution! More info can be found in the blog post [OData Deep Dive rewrite in the open](https://qmacro.org/blog/posts/2026/02/02/odata-deep-dive-rewrite-in-the-open/).
+
 ---
 
 <!-- 1 -->
diff --git a/tutorials/odata-dd-5-vocabularies/odata-dd-5-vocabularies.md b/tutorials/odata-dd-5-vocabularies/odata-dd-5-vocabularies.md
@@ -21,6 +21,8 @@ time: 20
 
 The members of the OData Technical Committee have worked hard on OData as a robust, well-defined and extensible standard. In this tutorial we'll look at a key extensibility mechanism in the form of vocabularies, and how they're used to organize annotations.
 
+> This tutorial belongs to the OData Deep Dive mission, a re-write of the original. The re-write is a work in progess, please proceed with caution! More info can be found in the blog post [OData Deep Dive rewrite in the open](https://qmacro.org/blog/posts/2026/02/02/odata-deep-dive-rewrite-in-the-open/).
+
 ---
 
 ### Examine the rest of the entity model wrapper
@@ -253,4 +255,3 @@ In the next tutorial we'll dig in to the detail of the annotations used in this
 ### Further info
 
 - [OData @ SAP - SAP Vocabularies](https://sap.github.io/odata-vocabularies/)
-
diff --git a/tutorials/odata-dd-6-annotations/odata-dd-6-annotations.md b/tutorials/odata-dd-6-annotations/odata-dd-6-annotations.md
@@ -26,6 +26,10 @@ In all cases, annotations consist of two parts:
 
 In this tutorial we'll examine the terms, along with their types and possible values, in our [Northbreeze OData metadata document](https://odd.cfapps.eu10.hana.ondemand.com/northbreeze/$metadata).
 
+> This tutorial belongs to the OData Deep Dive mission, a re-write of the original. The re-write is a work in progess, please proceed with caution! More info can be found in the blog post [OData Deep Dive rewrite in the open](https://qmacro.org/blog/posts/2026/02/02/odata-deep-dive-rewrite-in-the-open/).
+
+---
+
 ### Revisit the Core.Links annotation
 
 One of the annotations we took a brief first look at in the previous tutorial was "Core.Links", where "Core" is the vocabulary alias, referring here to "Org.OData.Core.V1".
@@ -248,4 +252,3 @@ By the way, this OData service is being served by a CAP Node.js server, where th
 
 - the [@readonly](https://cap.cloud.sap/docs/guides/services/constraints#readonly) section of the Input Validation topic in Capire
 - if you're wondering why there's a third vocabulary [com.sap.vocabularies.Common.v1](https://sap.github.io/odata-vocabularies/vocabularies/Common.xml) included in the references section of this OData service's metadata document, but there are no "Common" terms used, that's just because this is served by a CAP server, and the CAP compiler will by default always include references to both the "Core" and "Common" vocabularies (see the `csn2annotationEdm` function in `@sap/cds-compiler/lib/edm/annotations/genericTranslations.js` for details)
-
