You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@freemarker.apache.org by dd...@apache.org on 2020/02/16 19:17:48 UTC
[freemarker-site] branch master updated (88166d4 -> d2cb0b0)
This is an automated email from the ASF dual-hosted git repository.
ddekany pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/freemarker-site.git.
from 88166d4 Added Synesty Studio to "Powered By" page
new 4b82978 Made Release Candidate policy much more causal, as in reality it wasn't followed.
new a36a1d5 Removed some release steps, and mailing list references related to the sourceforge.net project, as we lost control over the project over there.
new d2cb0b0 Small additions/fixes in the release process description.
The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/main/docgen/book.xml | 111 ++++++++++++++++---------------------------
src/main/docgen/docgen.cjson | 2 -
2 files changed, 40 insertions(+), 73 deletions(-)
[freemarker-site] 02/03: Removed some release steps,
and mailing list references related to the sourceforge.net project,
as we lost control over the project over there.
Posted by dd...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ddekany pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/freemarker-site.git
commit a36a1d56e5418131c4f87f2737aff120adfd3b7d
Author: ddekany <dd...@apache.org>
AuthorDate: Sun Feb 16 17:14:20 2020 +0100
Removed some release steps, and mailing list references related to the sourceforge.net project, as we lost control over the project over there.
---
src/main/docgen/book.xml | 44 --------------------------------------------
src/main/docgen/docgen.cjson | 2 --
2 files changed, 46 deletions(-)
diff --git a/src/main/docgen/book.xml b/src/main/docgen/book.xml
index 30e6265..ec361de 100644
--- a/src/main/docgen/book.xml
+++ b/src/main/docgen/book.xml
@@ -509,13 +509,6 @@ two freemarker.jar-s and unpredictable behavior!
</section>
<section>
- <title><olink targetdoc="oldBugTracker">Bugs still in the old
- tracker</olink></title>
-
- <para/>
- </section>
-
- <section>
<title><olink targetdoc="newStackOverflowQuestion">Ask help on Stack
Overflow</olink></title>
@@ -644,30 +637,6 @@ two freemarker.jar-s and unpredictable behavior!
<para>The mailing list archive can be found <olink
targetdoc="devMailingListArchive">here...</olink></para>
-
- <simplesect>
- <title>Retired mailing lists</title>
-
- <para>These are the lists on sourceforge.net, which
- <emphasis>shouldn't be used anymore</emphasis>.</para>
-
- <para>Archives of <emphasis>retired</emphasis> lists:</para>
-
- <itemizedlist>
- <listitem>
- <para><olink
- targetdoc="oldUserMailingListArchive">freemarker-user@lists.sourceforge.net</olink></para>
- </listitem>
-
- <listitem>
- <para><olink
- targetdoc="oldDevelMailingListArchive">freemarker-devel@lists.sourceforge.net</olink></para>
- </listitem>
- </itemizedlist>
-
- <para><olink targetdoc="oldMailingListSubscription">Manage
- <emphasis>retired</emphasis> list subscriptions...</olink></para>
- </simplesect>
</section>
<section xml:id="poweredBy">
@@ -1534,14 +1503,6 @@ two freemarker.jar-s and unpredictable behavior!
</listitem>
<listitem>
- <para>The same two artifacts should also be released (uploaded for
- download) on <link
- xlink:href="https://sourceforge.net/projects/freemarker/">https://sourceforge.net/projects/freemarker/</link>.
- We add a note there to indicate that the canonical download is the
- one from Apache.</para>
- </listitem>
-
- <listitem>
<para>Releases should have a usual jar artifact, an src artifact
and javadoc artifact either in the Apache Maven staging repository
(for RC-s), or in the Maven Central Repository (for
@@ -1878,11 +1839,6 @@ two freemarker.jar-s and unpredictable behavior!
<para>On <link
xlink:href="https://twitter.com/freemarker">https://twitter.com/freemarker</link></para>
</listitem>
-
- <listitem>
- <para>On the old FreeMarker mailing lists: freemarker-user,
- freemarker-devel, freemarker-announce</para>
- </listitem>
</itemizedlist>
</listitem>
diff --git a/src/main/docgen/docgen.cjson b/src/main/docgen/docgen.cjson
index f92ae0c..2c26893 100644
--- a/src/main/docgen/docgen.cjson
+++ b/src/main/docgen/docgen.cjson
@@ -85,11 +85,9 @@ olinks: {
devMailingListArchive: "https://lists.apache.org/list.html?dev@freemarker.apache.org"
notificationsMailingListSubscribe: "mailto:notifications-subscribe@freemarker.apache.org"
notificationsMailingListUnsubscribe: "mailto:notifications-unsubscribe@freemarker.apache.org"
- oldMailingListSubscription: "https://sourceforge.net/p/freemarker/mailman/"
oldUserMailingListArchive: "http://news.gmane.org/gmane.comp.web.freemarker.user"
oldDevelMailingListArchive: "http://news.gmane.org/gmane.comp.web.freemarker.devel"
newBugReport: "https://issues.apache.org/jira/browse/FREEMARKER/"
- oldBugTracker: "https://sourceforge.net/p/freemarker/bugs/"
newStackOverflowQuestion: "https://stackoverflow.com/questions/ask?tags=freemarker"
asfSponsorship: "http://www.apache.org/foundation/sponsorship.html"
asfThanks: "http://www.apache.org/foundation/thanks.html"
[freemarker-site] 01/03: Made Release Candidate policy much more
causal, as in reality it wasn't followed.
Posted by dd...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ddekany pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/freemarker-site.git
commit 4b82978d49a7d3e4c328935cda1646c67d9fbaed
Author: ddekany <dd...@apache.org>
AuthorDate: Sun Feb 16 17:01:45 2020 +0100
Made Release Candidate policy much more causal, as in reality it wasn't followed.
---
src/main/docgen/book.xml | 48 +++++++++++++++++++++++++++---------------------
1 file changed, 27 insertions(+), 21 deletions(-)
diff --git a/src/main/docgen/book.xml b/src/main/docgen/book.xml
index e9d185a..30e6265 100644
--- a/src/main/docgen/book.xml
+++ b/src/main/docgen/book.xml
@@ -1526,27 +1526,6 @@ two freemarker.jar-s and unpredictable behavior!
<itemizedlist>
<listitem>
- <para>Releases with non-trivial changes should have at least one
- Release Candidate (RC01) release, which is legally a normal
- release (not just a internal/developer one), and is promoted for
- at least 1 month on our web page. The differences to a final
- release are these:</para>
-
- <itemizedlist>
- <listitem>
- <para>RC-s aren't released to the Maven Central
- Repository</para>
- </listitem>
-
- <listitem>
- <para>RC documentation (Manual + JavaDoc) is only published
- under
- https://freemarker.apache.org/builds/<replaceable>X.X.X</replaceable>-rc<replaceable>X</replaceable>/</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
<para>The official release is provided as source code to build the
project (src tar.gz). For the convenience of users the release is
also accompanied by compiled binaries (bin tar.gz, which also
@@ -1576,6 +1555,33 @@ two freemarker.jar-s and unpredictable behavior!
changes should be made in the 2.3-gae branch, and then merged into
the 2.3 branch (unless a change only applies to 2.3).</para>
</listitem>
+
+ <listitem>
+ <para>Releases with deeper changes sometimes should have one or
+ more Release Candidate releases (RC01, RC02, etc.), which is
+ legally a normal release (not just a internal/developer one), and
+ is promoted on our web page. The differences to a final release
+ are these:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>RC-s aren't released to the Maven Central Repository,
+ only to the Apache Maven repository</para>
+ </listitem>
+
+ <listitem>
+ <para>RC documentation (Manual + JavaDoc) is only published
+ under
+ https://freemarker.apache.org/builds/<replaceable>X.X.X</replaceable>-rc<replaceable>X</replaceable>/</para>
+ </listitem>
+
+ <listitem>
+ <para>RC-s promise no backward compatibility for the new
+ features they add; they may be redesigned or dropped till the
+ final release comes out.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
</itemizedlist>
<para>The steps of making a release:</para>
[freemarker-site] 03/03: Small additions/fixes in the release
process description.
Posted by dd...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ddekany pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/freemarker-site.git
commit d2cb0b06d61f20a17d33a042b2cbc180837712d8
Author: ddekany <dd...@apache.org>
AuthorDate: Sun Feb 16 20:17:40 2020 +0100
Small additions/fixes in the release process description.
---
src/main/docgen/book.xml | 19 +++++++++++++------
1 file changed, 13 insertions(+), 6 deletions(-)
diff --git a/src/main/docgen/book.xml b/src/main/docgen/book.xml
index ec361de..91c81df 100644
--- a/src/main/docgen/book.xml
+++ b/src/main/docgen/book.xml
@@ -1558,7 +1558,7 @@ two freemarker.jar-s and unpredictable behavior!
history of the Manual is up to date. Also the release date Version
history section of the Manual has to be updated. That's tricky as
you can't know it exactly, yet you can't change it when the actual
- release is about to hapen, as that would change the release
+ release is about to happen, as that would change the release
artifacts that were voted upon. So write the current date and
<quote>+ release process</quote> after it; that's how it will be
in the released artifacts.</para>
@@ -1618,7 +1618,10 @@ two freemarker.jar-s and unpredictable behavior!
<para>SVN commit the release files into the proper subdirectory of
https://dist.apache.org/repos/dist/<emphasis
role="bold">dev</emphasis>/freemarker. Note that this is
- <quote>dev/</quote>, not <quote>release/</quote>!</para>
+ <quote>dev/</quote>, not <quote>release/</quote>! You will likely
+ find the <quote>dev</quote> directory empty, so see the proper
+ layout under the <quote>release</quote> directory as a sample, but
+ don't commit to there accidentally.</para>
</listitem>
<listitem>
@@ -1628,7 +1631,10 @@ two freemarker.jar-s and unpredictable behavior!
<listitem>
<para>If your Maven <literal>settings-security.xml</literal>
is relocated to an encrypted storage (recommended), mount it,
- otherwise you will get 401 error when uploading.</para>
+ otherwise you will get 401 error when uploading. (How that's
+ done: create a file called settings-security.xml next to
+ ~/.m2/settings.xml, with content
+ <literal><settingsSecurity><relocation><replaceable>your-decrypted-storage-mount</replaceable>/settings-security.xml</relocation></settingsSecurity></literal>)</para>
</listitem>
<listitem>
@@ -1637,7 +1643,7 @@ two freemarker.jar-s and unpredictable behavior!
<listitem>
<para>Go to <link
- xlink:href="http://repository.apache.org/">http://repository.apache.org/</link>,
+ xlink:href="https://repository.apache.org/">https://repository.apache.org/</link>,
log in, chose <quote>Staging Repositories</quote>, find and
click the repository just created. Check the upload files
manually (on the <quote>Content</quote> tab). Then
@@ -1650,8 +1656,9 @@ two freemarker.jar-s and unpredictable behavior!
</listitem>
<listitem>
- <para>Upload the content of <literal>documentation/_html</literal>
- from the binary release to https://freemarker.apache.org/<emphasis
+ <para>Upload the content <emphasis>inside</emphasis>
+ <literal>documentation/_html</literal> from the binary release to
+ https://freemarker.apache.org/<emphasis
role="bold">builds/<replaceable>X.X.X</replaceable>-voting</emphasis>/
(by committing it into the <quote>asf-site</quote> branch of
https://git-wip-us.apache.org/repos/asf/freemarker-site.git). The