No documentation published yet for SWF 3.0.0 GA about spring-webflow

[rstoyanchev]

Thanks for reporting this. I'm not sure why they didn't get published. The 3.0 M1 and RC1 are also not there, and the 2.5.2 releases are also missing, so the issue might have been introduced with some build changes after 2.5.1. I'll have a look.

Snapshot documentation seems to be there, so you could use that for now:
https://docs.spring.io/spring-webflow/docs/3.0.0-SNAPSHOT/

[rstoyanchev]

Never mind 2.5.2. The last 2.5.x release is 2.5.1.

[iay]

Thanks. I'm referencing the 3.0.0-SNAPSHOT docs in our build for now.

[bclozel]

I think this might be a CI/Bamboo configuration issue, as the docs are produced by the build itself locally:

$ ./gradlew build
$ unzip -l build/distributions/spring-webflow-3.0.1-SNAPSHOT-docs.zip
Archive:  build/distributions/spring-webflow-3.0.1-SNAPSHOT-docs.zip
  Length      Date    Time    Name
---------  ---------- -----   ----
        0  08-05-2023 11:41   api/
    24455  08-05-2023 11:41   api/constant-values.html
      163  08-05-2023 11:41   api/tag-search-index.js
   160720  08-05-2023 11:41   api/overview-tree.html
...
    13759  08-05-2023 11:41   api/search.js
        0  08-05-2023 11:41   reference/
    29633  08-05-2023 11:41   reference/actions.html
   309183  08-05-2023 11:41   reference/index.html
        0  08-05-2023 11:41   reference/css/
    56350  08-05-2023 11:41   reference/css/site.css.map
    32094  08-05-2023 11:41   reference/css/site.css
        0  08-05-2023 11:41   reference/images/
    14050  08-05-2023 11:41   reference/images/hotels-site-bookhotel-flow.png
    19211  08-05-2023 11:41   reference/images/flow-view-packaging.png
    12411  08-05-2023 11:41   reference/images/hotels-site.png
        0  08-05-2023 11:41   reference/js/
   343038  08-05-2023 11:41   reference/js/site.js.map
    33036  08-05-2023 11:41   reference/js/setup.js.map
    80969  08-05-2023 11:41   reference/js/site.js
     4069  08-05-2023 11:41   reference/js/setup.js
    13082  08-05-2023 11:41   reference/flow-security.html
    27840  08-05-2023 11:41   reference/el.html
    42890  08-05-2023 11:41   reference/spring-faces.html
    20552  08-05-2023 11:41   reference/spring-js.html
     6149  08-05-2023 11:41   reference/overview.html
    32730  08-05-2023 11:41   reference/defining-flows.html
     8687  08-05-2023 11:41   reference/testing.html
    10950  08-05-2023 11:41   reference/flow-inheritance.html
     7458  08-05-2023 11:41   reference/flow-managed-persistence.html
    32714  08-05-2023 11:41   reference/system-setup.html
    61749  08-05-2023 11:41   reference/views.html
    28388  08-05-2023 11:41   reference/spring-mvc.html
  2481284  08-05-2023 11:41   reference/index.pdf
---------                     -------
 17147670                     704 files

Opening the generated docs locally works and renders fine:

$ open build/docs/asciidoc/index.html

Unzipping the build/distributions/spring-webflow-3.0.1-SNAPSHOT-docs.zip file shows that we're missing some content (here, the img folder). I can send a PR to fix that part once we figure out why the docs aren't published.

When looking at previous Bamboo builds, I'm seeing the docs artifact being deployed:

15-Feb-2021 11:42:33 | Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/webflow/2.4.9.BUILD-SNAPSHOT/spring-webflow-2.4.9.BUILD-SNAPSHOT-docs.zip

In recent builds we don't see the docs artifact being deployed anymore:

build	14-Jul-2023 17:07:14	[pool-2-thread-3] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-js-resources/3.0.1-SNAPSHOT/spring-js-resources-3.0.1-SNAPSHOT.jar
build	14-Jul-2023 17:07:14	[pool-2-thread-2] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-faces/3.0.1-SNAPSHOT/spring-faces-3.0.1-SNAPSHOT-javadoc.jar
build	14-Jul-2023 17:07:14	[pool-2-thread-1] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-binding/3.0.1-SNAPSHOT/spring-binding-3.0.1-SNAPSHOT-javadoc.jar
build	14-Jul-2023 17:07:14	[pool-2-thread-4] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-webflow/3.0.1-SNAPSHOT/spring-webflow-3.0.1-SNAPSHOT-javadoc.jar
build	14-Jul-2023 17:07:15	[pool-2-thread-2] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-faces/3.0.1-SNAPSHOT/spring-faces-3.0.1-SNAPSHOT-sources.jar
build	14-Jul-2023 17:07:16	[pool-2-thread-4] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-webflow/3.0.1-SNAPSHOT/spring-webflow-3.0.1-SNAPSHOT-sources.jar
build	14-Jul-2023 17:07:16	[pool-2-thread-1] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-binding/3.0.1-SNAPSHOT/spring-binding-3.0.1-SNAPSHOT-sources.jar
build	14-Jul-2023 17:07:16	[pool-2-thread-3] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-js-resources/3.0.1-SNAPSHOT/spring-js-resources-3.0.1-SNAPSHOT.pom
build	14-Jul-2023 17:07:16	[pool-2-thread-2] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-faces/3.0.1-SNAPSHOT/spring-faces-3.0.1-SNAPSHOT.jar
build	14-Jul-2023 17:07:16	[pool-2-thread-4] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-webflow/3.0.1-SNAPSHOT/spring-webflow-3.0.1-SNAPSHOT.jar
build	14-Jul-2023 17:07:17	[pool-2-thread-1] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-binding/3.0.1-SNAPSHOT/spring-binding-3.0.1-SNAPSHOT.jar
build	14-Jul-2023 17:07:17	[pool-2-thread-2] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-faces/3.0.1-SNAPSHOT/spring-faces-3.0.1-SNAPSHOT.pom
build	14-Jul-2023 17:07:17	[pool-2-thread-1] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-binding/3.0.1-SNAPSHOT/spring-binding-3.0.1-SNAPSHOT.pom
build	14-Jul-2023 17:07:17	[pool-2-thread-4] Deploying artifact: https://repo.spring.io/libs-snapshot-local/org/springframework/webflow/spring-webflow/3.0.1-SNAPSHOT/spring-webflow-3.0.1-SNAPSHOT.pom

I'll need to take a look at the Bamboo build configuration to better understand what's going on.

[rstoyanchev]

The 3.0.1 snapshot build is producing documentation again https://docs.spring.io/spring-webflow/docs/3.0.1-SNAPSHOT/.

[rstoyanchev]

The 3.0.0 links are up now, reference and api.