From 18fb9dc546412d128d1a0cf42443f8d68abf9350 Mon Sep 17 00:00:00 2001 From: "totally-not-ai[bot]" <290682512+totally-not-ai[bot]@users.noreply.github.com> Date: Mon, 21 Sep 2026 16:09:09 +0300 Subject: [PATCH] docs: mark AppSec Kit as deprecated (#5949) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit AppSec Kit won't be available in Vaadin 26. A replacement online service for Vaadin Enterprise is in progress and is planned to be available before the Vaadin 26 release, so the AppSec Kit documentation is now marked as deprecated. The presentation follows what the other deprecated tools (e.g. Designer) already use, so readers see a consistent signal: - **Dismissible caution banner** on every AppSec Kit page — `banner`, `banner-id: appsec-kit-deprecated` and `banner-style: caution` front matter on [guilabel]#index#, [guilabel]#Getting Started# and [guilabel]#Advanced Topics#. The shared `banner-id` means dismissing it once dismisses it for the whole section. - **Deprecated badge on each page title** via the `[deprecated:com.vaadin:vaadin@V25.3]#...#` title macro. - **Shared warning admonition** defined once in `articles/tools/appsec/index.adoc` as a `deprecation-notice` tag and included from the two sub-pages. On the landing page it renders as plain text below the title; the sub-pages set `:admonition:` so the same text renders inside a `[WARNING]` block, avoiding a duplicated wording that could drift. - **Metadata updates**: the landing page `title` becomes "AppSec Kit (deprecated)", and `description` / `meta-description` state the deprecation so it also shows in search results and navigation. - **Tools overview card** in `articles/tools/index.adoc` is labelled "AppSec Kit (Deprecated)" and its blurb mentions the upcoming replacement service. The wording deliberately uses the future tense ("won't be available in Vaadin 26") since Vaadin 26 doesn't exist yet. ### Note on the diff This branch also contains the already-reviewed preview-infrastructure fix from #5951 (`Dockerfile.preview`, `dspublisher/theme/init-browser.ts`, `vite.dspublisher.ts`), which suppresses the cookie-consent dialog on preview deployments. It shows up here only because `main` hadn't been updated at the time this branch was merged up; it isn't part of the documentation change under review and will disappear once `main` is refreshed. --------- Co-authored-by: totally-not-ai[bot] <290682512+totally-not-ai[bot]@users.noreply.github.com> Co-authored-by: Artur Signell --- articles/tools/appsec/advanced-topics.adoc | 8 +++++++- articles/tools/appsec/getting-started.adoc | 8 +++++++- articles/tools/appsec/index.adoc | 24 ++++++++++++++++++---- articles/tools/index.adoc | 4 ++-- 4 files changed, 36 insertions(+), 8 deletions(-) diff --git a/articles/tools/appsec/advanced-topics.adoc b/articles/tools/appsec/advanced-topics.adoc index 3cbe8620f6..3705f0e91e 100644 --- a/articles/tools/appsec/advanced-topics.adoc +++ b/articles/tools/appsec/advanced-topics.adoc @@ -4,10 +4,16 @@ page-title: Advanced application security topics | Vaadin description: Highlights advanced topics related to AppSec Kit. meta-description: Explore advanced security concepts to safeguard your Vaadin applications. order: 20 +banner: AppSec Kit is deprecated and won't be available in Vaadin 26. +banner-id: appsec-kit-deprecated +banner-style: caution --- -= Advanced Topics += [deprecated:com.vaadin:vaadin@V25.3]#Advanced Topics# + +:admonition: +include::index.adoc[tag=deprecation-notice] This page highlights some advanced topics related to AppSec Kit. For more basic information, see the <> page. diff --git a/articles/tools/appsec/getting-started.adoc b/articles/tools/appsec/getting-started.adoc index 825dd9c9a0..a2705ebe3e 100644 --- a/articles/tools/appsec/getting-started.adoc +++ b/articles/tools/appsec/getting-started.adoc @@ -4,10 +4,16 @@ page-title: Getting started with AppSec for Vaadin description: Step-by-step guide on using AppSec Kit in an application. meta-description: Discover how to use the AppSec tool to secure your Vaadin applications. order: 10 +banner: AppSec Kit is deprecated and won't be available in Vaadin 26. +banner-id: appsec-kit-deprecated +banner-style: caution --- -= Getting Started with AppSec Kit += [deprecated:com.vaadin:vaadin@V25.3]#Getting Started with AppSec Kit# + +:admonition: +include::index.adoc[tag=deprecation-notice] AppSec Kit is an excellent tool for monitoring an application's dependencies for vulnerabilities. It lets you see details of what's discovered. And you can record and store your own analysis to share with other developers. diff --git a/articles/tools/appsec/index.adoc b/articles/tools/appsec/index.adoc index a769cf1b5b..9dc152441a 100644 --- a/articles/tools/appsec/index.adoc +++ b/articles/tools/appsec/index.adoc @@ -1,19 +1,35 @@ --- -title: AppSec Kit +title: AppSec Kit (deprecated) page-title: Seamless Security Integration with AppSec Kit | Vaadin -description: Identify and manage vulnerabilities in third-party dependencies. -meta-description: Learn to identify and manage vulnerabilities in third-party dependencies of your application. +description: Identify and manage vulnerabilities in third-party dependencies. Deprecated, and won't be available in Vaadin 26. +meta-description: AppSec Kit identifies and manages vulnerabilities in third-party dependencies. It's deprecated and won't be available in Vaadin 26. section-nav: commercial order: 40 +banner: AppSec Kit is deprecated and won't be available in Vaadin 26. +banner-id: appsec-kit-deprecated +banner-style: caution --- -= AppSec Kit += [deprecated:com.vaadin:vaadin@V25.3]#AppSec Kit# :commercial-feature: AppSec Kit :kit-start-trial: true include::{articles}/_commercial-banner.adoc[opts=optional] +// tag::deprecation-notice[] +ifdef::admonition[] +[WARNING] +==== +endif::admonition[] +AppSec Kit is deprecated and won't be available in Vaadin 26. + +A replacement is in progress: an online service for Vaadin Enterprise, planned to be available before the release of Vaadin 26. +ifdef::admonition[] +==== +endif::admonition[] +// end::deprecation-notice[] + AppSec Kit offers seamless security integration to the development of Vaadin-based applications. It provides comprehensive dependency visibility, earlier remediation of vulnerabilities, and fewer false positives. diff --git a/articles/tools/index.adoc b/articles/tools/index.adoc index 24a274b2b2..5dddd9a69b 100644 --- a/articles/tools/index.adoc +++ b/articles/tools/index.adoc @@ -30,9 +30,9 @@ Edit your application directly in the browser yourself or ask the AI copilot to == Acceleration Kits [.card.commercial] -=== AppSec Kit +=== AppSec Kit (Deprecated) -Identify and manage security vulnerabilities in third-party dependencies. +Identify and manage security vulnerabilities in third-party dependencies. AppSec Kit won't be available in Vaadin 26; a replacement online service for Vaadin Enterprise is in progress. [.sr-only] <<{tools-path-prefix}appsec#,See AppSec Kit>>