You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by ah...@apache.org on 2022/06/14 05:48:46 UTC

[isis] branch master updated: ISIS-2965: antora: adding M8 migration notes

This is an automated email from the ASF dual-hosted git repository.

ahuber pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git


The following commit(s) were added to refs/heads/master by this push:
     new 79483ec998 ISIS-2965: antora: adding M8 migration notes
79483ec998 is described below

commit 79483ec9985228f4f1f6cf3f5e1c9dfef51460fe
Author: Andi Huber <ah...@apache.org>
AuthorDate: Tue Jun 14 07:48:41 2022 +0200

    ISIS-2965: antora: adding M8 migration notes
---
 .../2022/{2.0.0-RC1 => 2.0.0-M8}/mignotes.adoc     |   0
 .../modules/ROOT/pages/2022/2.0.0-M8/relnotes.adoc |   8 +
 .../ROOT/pages/2022/2.0.0-RC1/mignotes.adoc        | 183 +--------------------
 .../relnotes/modules/ROOT/pages/about.adoc         |   8 +-
 antora/playbooks/site.yml                          |   2 +-
 5 files changed, 16 insertions(+), 185 deletions(-)

diff --git a/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-RC1/mignotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-M8/mignotes.adoc
similarity index 100%
copy from antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-RC1/mignotes.adoc
copy to antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-M8/mignotes.adoc
diff --git a/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-M8/relnotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-M8/relnotes.adoc
new file mode 100644
index 0000000000..a3061b12bd
--- /dev/null
+++ b/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-M8/relnotes.adoc
@@ -0,0 +1,8 @@
+[[r2.0.0-M8]]
+= 2.0.0-M8
+
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
+:page-partial:
+
+(This page will be updated once the release candidate is released).
+
diff --git a/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-RC1/mignotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-RC1/mignotes.adoc
index 4769687770..7795e957f3 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-RC1/mignotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2022/2.0.0-RC1/mignotes.adoc
@@ -1,186 +1,9 @@
-= Migrating from M7 to M8
+= Migrating from M8 to RC1
 
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 :page-partial:
 
-(This page will be added to as development progresses).
-
-== Programming Model
-
-[cols="2a,3a", options="header"]
-
-|===
-
-| previously
-| new
-
-| `@DomainService.logicalTypeName` deprecated for removal
-| use `@Named` or any other semantics supported by Spring
-+
-Behavioral change: `@DomainService.logicalTypeName` can now be left empty, which is interpreted as _unspecified/indifferent_ 
-
-| `RecreatableDomainObject` interface removed
-| use `ViewModel` interface instead
-
-| `ViewModel.viewModelInit(String memento)` removed
-| use a single (String) argument constructor instead; this will allow Java Records to be used as viewmodels (future work)
-
-| `MetamodelEvent` as provided with _metamodel_ moved
-| moved to _applib_; we introduced _interface_ `MetamodelListener` for convenience to maybe use instead
-[source, java]
-.Example
-----
-@Service
-public class SeedService implements MetamodelListener {
-/..
-    @Override
-    public void onMetamodelLoaded() {
-        // seed database entities
-    }
-}
----- 
-
-| Factory method `Identifier.propertyOrCollectionIdentifier(..)`
-| was slit up into `Identifier.propertyIdentifier(..)` and `Identifier.collectionIdentifier(..)`
-
-|===
-
-== Commons
-
-The following changed:
-[cols="2a,3a", options="header"]
-
-|===
-
-| previously
-| new
-
-| `Result<T>` removed
-| replaced by `Try<T>`; also promoting `Either<L, R>` to non-internal, 
-and introducing `Railway<F, S>` 
-
-|===
-
-== Configuration
-
-The following changed:
-[cols="2a,3a", options="header"]
-
-|===
-
-| previously
-| new
-
-| (non-essential) object meta-data mixins were split out of `IsisModuleApplib` 
-| need to be explicitly imported via `IsisModuleApplibObjectMetadataMixins`
-
-| default logging subscribers were split out of `IsisModuleApplib` 
-| need to be explicitly imported via `IsisModuleApplibChangeAndExecutionLoggers`
-
-|===
-
-== Other
-
-=== Bill of Material / Parent POM
-
-Folder moved `/isis-parent` -> `/bom` 
-
-[source, xml]
-.Bill of Material
-----
-<!-- renamed
-<groupId>org.apache.isis</groupId>
-<artifactId>isis-parent</artifactId>
--->
-
-<groupId>org.apache.isis</groupId>
-<artifactId>isis-bom</artifactId>
-----
-
-=== Restclient
-
-[source, java]
-.Restclient Package Names
-----
-// renamed ...
-//import org.apache.isis.extensions.restclient.RestfulClient;
-//import org.apache.isis.extensions.restclient.RestfulClientConfig;
-import org.apache.isis.viewer.restfulobjects.client.RestfulClient;
-import org.apache.isis.viewer.restfulobjects.client.RestfulClientConfig;
-----
-
-[source, xml]
-.Restclient Artifacts
-----
-<!-- renamed
-<groupId>org.apache.isis.mappings</groupId>
-<artifactId>isis-mappings-restclient-applib</artifactId>
--->
-
-<groupId>org.apache.isis.viewer</groupId>
-<artifactId>isis-viewer-restfulobjects-client</artifactId>
-----
-
-[source, java]
-.Restclient Usage
-----
-// DigestResponse is no longer publicly visible, instead returning Try<T>  
-<T> Try<T> digest(Response response, Class<T> entityType);
-
-// DigestResponse is no longer publicly visible, instead returning Try<Can<T>>
-<T> Try<Can<T>> digestList(Response response, Class<T> entityType, GenericType<List<T>> genericType);
-----
-
-=== Mappings
-
-[source, xml]
-.Mappings
-----
-<!-- all removed
-<groupId>org.apache.isis.mappings</groupId>
-<artifactId>isis-mappings-...</artifactId>
--->
-----
-
-=== Mavendeps
-
-[source, xml]
-.integtests
-----
-<!-- removed
-<groupId>org.apache.isis.mavendeps</groupId>
-<artifactId>isis-mavendeps-integtests</artifactId>
-<type>pom</type>
--->
-
-<!-- instead use directly as required ... -->
-
-<groupId>org.apache.isis.testing</groupId>
-<artifactId>isis-testing-integtestsupport-applib</artifactId>
-
-<groupId>org.apache.isis.testing</groupId>
-<artifactId>isis-testing-fakedata-applib</artifactId>
-
-<groupId>org.apache.isis.testing</groupId>
-<artifactId>isis-testing-fixtures-applib</artifactId>
-----
-
-[source, xml]
-.unittests
-----
-<!-- removed
-<groupId>org.apache.isis.mavendeps</groupId>
-<artifactId>isis-mavendeps-unittests</artifactId>
-<type>pom</type>
--->
-
-<!-- instead use directly as required ... -->
-
-<groupId>org.apache.isis.testing</groupId>
-<artifactId>isis-testing-unittestsupport-applib</artifactId>
-
-<groupId>org.apache.isis.testing</groupId>
-<artifactId>isis-testing-fakedata-applib</artifactId>
-----
+This page will be added to as development progresses. 
 
+(M8 has not yet been released.)
 
diff --git a/antora/components/relnotes/modules/ROOT/pages/about.adoc b/antora/components/relnotes/modules/ROOT/pages/about.adoc
index a76639f7c2..5186f4a527 100644
--- a/antora/components/relnotes/modules/ROOT/pages/about.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/about.adoc
@@ -26,15 +26,15 @@ This table summarises all releases of Apache Isis v2.0 to date.
 * xref:relnotes:ROOT:2022/2.0.0-RC1/relnotes.adoc[Release Notes]
 * xref:relnotes:ROOT:2022/2.0.0-RC1/mignotes.adoc[Migration Notes]
 
-| 2.0.0-RC1
+| 2.0.0-M8
 | not released yet (upcoming)
-| First release candidate for Apache Isis 2.0.0
+| Eighth milestone release for Apache Isis 2.0.0
 | ?
 | ?
 | ?
 |
-* xref:relnotes:ROOT:2022/2.0.0-RC1/relnotes.adoc[Release Notes]
-* xref:relnotes:ROOT:2022/2.0.0-RC1/mignotes.adoc[Migration Notes]
+* xref:relnotes:ROOT:2022/2.0.0-M8/relnotes.adoc[Release Notes]
+* xref:relnotes:ROOT:2022/2.0.0-M8/mignotes.adoc[Migration Notes]
 
 | 2.0.0-M7
 | 28-02-2022
diff --git a/antora/playbooks/site.yml b/antora/playbooks/site.yml
index 17ed30673b..293e7e527c 100644
--- a/antora/playbooks/site.yml
+++ b/antora/playbooks/site.yml
@@ -293,7 +293,7 @@ asciidoc:
     kroki-fetch-diagram: true
     kroki-server-url: https://kroki.io # (default)
     page-isisprev: "2.0.0-M7"
-    page-isisrel: "2.0.0-RC1"
+    page-isisrel: "2.0.0-M8"
 
 output:
   dir: antora/target/site