You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2020/03/29 15:37:54 UTC
[isis] 05/29: ISIS-2062: post-release docs
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to tag docs/isis-2.0.0-M3
in repository https://gitbox.apache.org/repos/asf/isis.git
commit eed2689b7629cb3c9549e269005d2519f82db860
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Sat Mar 28 10:03:50 2020 +0000
ISIS-2062: post-release docs
---
.../update-site-yml-no-tags.png | Bin 0 -> 158926 bytes
.../ROOT/pages/post-release-successful.adoc | 23 ++++++++++++++++-----
2 files changed, 18 insertions(+), 5 deletions(-)
diff --git a/antora/components/comguide/modules/ROOT/images/release-process-post/update-site-yml-no-tags.png b/antora/components/comguide/modules/ROOT/images/release-process-post/update-site-yml-no-tags.png
new file mode 100644
index 0000000..3e6b21f
Binary files /dev/null and b/antora/components/comguide/modules/ROOT/images/release-process-post/update-site-yml-no-tags.png differ
diff --git a/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc b/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
index b7d9e6b..19ccd62 100644
--- a/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
+++ b/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
@@ -178,7 +178,7 @@ We therefore temporarily modify all of the `antora.yml` files and `site.yml` wit
+
** `version: latest` -> `version: {isisnext}`
+
-image::release-process-post/update-antora-latest.png[width="600px",link="{imagesdir}/release-process-post/update-antora-latest.png"]
+image::release-process-post/update-antora-latest.png[width="800px",link="{imagesdir}/release-process-post/update-antora-latest.png"]
* Commit the change, and tag:
+
@@ -224,17 +224,17 @@ to:
.site.yml
[source,yml,subs="attributes+"]
----
-- url: https://github.com/apache/isis.git
+- url: .
start_path: antora/components/docs # docs
tags: docs/isis-{isisnext} # <.>
- branches: HEAD # <.>
+ branches: HEAD # <.>
----
<.> will generate the {isisnext} version
<.> will generate the 'latest' version
+
eg using the IDE:
+
-image::release-process-post/update-site-yml-tags.png[width="600px",link="{imagesdir}/release-process-post/update-site-yml-tags.png"]
+image::release-process-post/update-site-yml-tags.png[width="800px",link="{imagesdir}/release-process-post/update-site-yml-tags.png"]
* commit this change, too (there's no need to push):
+
@@ -255,15 +255,28 @@ This will write to `antora/target/site`; we'll use the results in the xref:#publ
* Finally, revert the changes to `site.yml` back into "author mode".
+
-That is, so that each content source specifies a local URL and only the HEAD branch:
+That is, comment out the tags entries:
+
.site.yml
[source,yml,subs="attributes+"]
----
- url: .
start_path: antora/components/docs # docs
+# tags: docs/isis-{isisnext}
branches: HEAD
----
++
+eg using the IDE:
++
+image::release-process-post/update-site-yml-no-tags.png[width="800px",link="{imagesdir}/release-process-post/update-site-yml-no-tags.png"]
+
+* commit this change, too (there's no need to push):
++
+[source,bash,subs="attributes+"]
+----
+git add .
+git commit -m "$ISISJIRA: site.yml back to author mode"
+----
[#publish-website]
== Publish website