Release Feb24

.vitepress/config.ts

@@ -22,8 +22,8 @@ if (!siteURL.pathname.endsWith('/'))  siteURL.pathname += '/'
 const redirectLinks: Record<string, string> = {}
 
 const latestVersions = {
-  java_services: '2.6.1',
-  java_cds4j: '2.6.1'
+  java_services: '2.7.0',
+  java_cds4j: '2.7.0'
 }
 
 const localSearchOptions = {

.vitepress/theme/components/indexFilter.js → .vitepress/theme/components/indexFilter.ts

@@ -1,7 +1,14 @@
 const { base, themeConfig: { sidebar }} = global.VITEPRESS_CONFIG.site
 import { join } from 'node:path'
+import { ContentData, DefaultTheme } from 'vitepress'
 
-export default (pages, basePath) => {
+type ContentDataCustom = ContentData & {
+  title?:string
+}
+
+type SBItem = DefaultTheme.SidebarItem
+
+export default (pages:ContentDataCustom[], basePath:string):ContentDataCustom[] => {
   let items = findInItems(basePath, sidebar) || []
   items = items.map(item => { return { ...item, link: item.link?.replace(/\.md$/, '') }})
   const itemLinks = items.map(item => join(base, item.link||''))
@@ -13,29 +20,28 @@ export default (pages, basePath) => {
       return p
     })
     .filter(p => {
-      const item = items.find(item => p.url.endsWith(item.link))
+      const item = items.find(item => item.link && p.url.endsWith(item.link))
       if (item)  p.title = item.text
       return !!item
     })
     .filter(p => !p.url.endsWith(basePath))
     .sort((p1, p2) => itemLinks.indexOf(p1.url) - itemLinks.indexOf(p2.url))
-    .map(p => {
-      // this data is inlined in each index page, so sparsely construct the final object
-      return {
-        url: p.url,
-        title: p.title,
-        frontmatter: {
-          synopsis: p.frontmatter.synopsis
-        }
-      }
-    })
+    .map(p => ({
+      url: p.url,
+      title: p.title,
+      frontmatter: {
+        synopsis: p.frontmatter.synopsis
+      },
+      // this data is inlined in each index page, so omit unnecessary data
+      src:undefined, html:undefined, excerpt:undefined
+    }))
 }
 
-function findInItems(url, items=[]) {
+function findInItems(url:string, items:SBItem[]=[]):SBItem[]|undefined {
   let res = items.find(item => item.link?.includes(url))
   if (res)  return res.items
   for (const item of items) {
-    res = findInItems(url, item.items)
-    if (res)  return res
+    const result = findInItems(url, item.items)
+    if (result)  return result
   }
 }

.vitepress/theme/custom.scss

@@ -121,6 +121,10 @@ main {
 
       background: var(--vp-code-block-bg);
     }
+
+    .line-numbers-wrapper {
+      padding-top: 13px; // align with code line height
+    }
   }
 
   // Table of Contents
@@ -225,6 +229,7 @@ main {
   h3.method + h3.method {
     margin-top: 0
   }
+
 }
 
 // Menu Sidebar

about/features.md

@@ -39,17 +39,18 @@ Following is an index of the features currently covered by CAP, with status and
 
 | CLI commands                                                                    |                            |
 |---------------------------------------------------------------------------------|----------------------------|
-| [Jump-start cds-based projects](../get-started/in-a-nutshell#jumpstart)   | `cds init <project>`       |
+| [Jump-start cds-based projects](../get-started/in-a-nutshell#jumpstart)         | `cds init <project>`       |
 | Add a feature to an existing project                                            | `cds add <facets>`         |
 | [Add models from external sources](../guides/using-services#local-mocking)      | `cds import <api>`         |
 | [Compile cds models to different outputs](../node.js/cds-compile)               | `cds compile <models>`     |
 | [Run your services in local server](../node.js/cds-serve)                       | `cds serve <services>`     |
-| [Run and restart on file changes](../get-started/in-a-nutshell#jumpstart) | `cds watch`                |
+| [Run and restart on file changes](../get-started/in-a-nutshell#jumpstart)       | `cds watch`                |
 | [Read-eval-event loop](../node.js/cds-env#cli)  <!-- TODO -->                   | `cds repl`                 |
 | Inspect effective configuration                                                 | `cds env`                  |
 | Prepare for deployment                                                          | `cds build`                |
 | Deploy to databases or cloud                                                    | `cds deploy`               |
 | Login to multitenant SaaS application                                           | `cds login <app-url>`      |
+| Upgrade tenant(s) subscribed to a multitenant SaaS app to its latest base model.| `cds upgrade`              |
 | Logout from multitenant SaaS application                                        | `cds logout`               |
 | Subscribe a tenant to a SaaS application                                        | `cds subscribe <tenant>`   |
 | Unsubscribe a tenant from a SaaS application                                    | `cds unsubscribe <tenant>` |
@@ -131,7 +132,7 @@ Following is an index of the features currently covered by CAP, with status and
 
 | Inbound Protocol Support                              | CDS <sup>1</sup> |      Node.js      |       Java        |
 |-------------------------------------------------------|:----------------:|:-----------------:|:-----------------:|
-| [REST/OpenAPI](../advanced/openapi)                   |       <X/>       |       <X/>        |       <X/>        |
+| [REST/OpenAPI](/advanced/publishing-apis/openapi)                   |       <X/>       |       <X/>        |       <X/>        |
 | [OData V2](../advanced/odata#v2-support) <sup>2</sup> |       <X/>       | <X/> <sup>3</sup> |       <X/>        |
 | OData V4                                              |       <X/>       |       <X/>        |       <X/>        |
 | OData V4 for APIs                                     |       <D/>       |       <D/>        |       <D/>        |
@@ -202,7 +203,7 @@ Following is an index of the features currently covered by CAP, with status and
 
 > <sup>1</sup> To speed up development. Not for productive use! <br>
 
-> You can already integrate your database of choice in a project or a contribution level. The last two are meant to further facilitate this by out-of-the-box features in CAP.
+> Note: You can already integrate your database of choice in a project or a contribution level. The last two are meant to further facilitate this by out-of-the-box features in CAP.
 
 <!--| [Migration to SAP HANA Cloud](../guides/databases)            |   <D/>    | <Na/>  | <Na/> |
 | [Streamlined Schema Evolution](../guides/databases)       |   <D/>    | <Na/>  | <Na/> |

about/index.md

@@ -230,7 +230,7 @@ Following is an excerpt of generic features provided:
 
 All data access in CAP is through dynamic queries, which allows clients to request the exact information they really need. These powerful intrinsic querying capabilities are key enablers for **serving requests automatically**.
 
-> The querying-based approach to process data is in strong contrast to Object-Relational Mapping (→ see also *[Related Concepts: CAP != ORM](related#orm)*)
+> Note: The querying-based approach to process data is in strong contrast to Object-Relational Mapping (→ see also *[Related Concepts: CAP != ORM](related#orm)*)
 
 <br>