chore(dev/release): fix announce@ mail to comply with ASF policy

dev/release/post-09-announce.sh → dev/release/post-10-announce.sh

@@ -16,32 +16,36 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-#
+
+# https://apache.org/legal/release-policy#publication
+# Don't link to GitHub, etc.
 set -ue
 
 SOURCE_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 source "${SOURCE_DIR}/utils-common.sh"
 source "${SOURCE_DIR}/utils-prepare.sh"
 
 main() {
-
     set_resolved_issues "${RELEASE}"
 
+    read -p "Enter the URL of the announcement blog post..." BLOG_URL
+
     cat <<EOF
 To: announce@apache.org
 CC: dev@arrow.apache.org
 Subject: [ANNOUNCE] Apache Arrow ADBC ${RELEASE} Released
 
-The Apache Arrow community is pleased to announce the a new release of
-the Apache Arrow ADBC libraries. It includes ${RESOLVED_ISSUES} resolved GitHub issues
-([1]). Individual components are versioned separately: some packages
-are on version ${VERSION_NATIVE} and others are now version ${VERSION_JAVA}, with the
-release as a whole on version '${RELEASE}'.
+The Apache Arrow PMC is pleased to announce release ${RELEASE} of the
+Apache Arrow ADBC subproject. Individual components are versioned
+separately: some packages are on version ${VERSION_NATIVE} and others
+are on version ${VERSION_JAVA}.
 
-The release is available now from [2] and [3].
+Release artifacts can be downloaded from:
+https://arrow.apache.org/adbc/current/driver/installation.html
 
+This release contains ${RESOLVED_ISSUES} bug fixes and improvements.
 Release notes are available at:
-https://github.com/apache/arrow-adbc/blob/apache-arrow-adbc-${RELEASE}/CHANGELOG.md
+${BLOG_URL}
 
 What is Apache Arrow?
 ---------------------
@@ -59,19 +63,16 @@ What is Apache Arrow ADBC?
 ADBC is a database access abstraction for Arrow-based applications. It
 provides a cross-language API for working with databases while using
 Arrow data, providing an alternative to APIs like JDBC and ODBC for
-analytical applications. For more, see [4].
+analytical applications. For more, see [1].
 
-Please report any feedback to the mailing lists ([5], [6]).
+Please report any feedback to the mailing lists ([2], [3]).
 
 Regards,
 The Apache Arrow Community
 
-[1]: https://github.com/apache/arrow-adbc/issues?q=is%3Aissue+milestone%3A%22ADBC+Libraries+${RELEASE}%22+is%3Aclosed
-[2]: https://arrow.apache.org/adbc/current/driver/installation.html
-[3]: https://packages.apache.org/ui/native/arrow
-[4]: https://arrow.apache.org/blog/2023/01/05/introducing-arrow-adbc/
-[5]: https://lists.apache.org/list.html?user@arrow.apache.org
-[6]: https://lists.apache.org/list.html?dev@arrow.apache.org
+[1]: https://arrow.apache.org/blog/2023/01/05/introducing-arrow-adbc/
+[2]: https://lists.apache.org/list.html?user@arrow.apache.org
+[3]: https://lists.apache.org/list.html?dev@arrow.apache.org
 EOF
 
 }

docs/source/development/releasing.rst

@@ -413,22 +413,6 @@ Be sure to go through on the following checklist:
 
    A conda-forge or feedstock maintainer can review and merge.
 
-.. dropdown:: Announce the new release
-   :class-title: sd-fs-5
-   :class-container: sd-shadow-md
-
-   Write a release announcement and send to announce@apache.org and
-   dev@arrow.apache.org.
-
-   The announcement to announce@apache.org must be sent from your apache.org
-   e-mail address to be accepted.
-
-   Template:
-
-   .. code-block:: Bash
-
-      dev/release/post-09-announce.sh
-
 .. dropdown:: Remove old artifacts
    :class-title: sd-fs-5
    :class-container: sd-shadow-md
@@ -437,7 +421,7 @@ Be sure to go through on the following checklist:
 
    .. code-block:: Bash
 
-      dev/release/post-10-remove-old-artifacts.sh
+      dev/release/post-09-remove-old-artifacts.sh
 
 .. dropdown:: Bump versions
    :class-title: sd-fs-5
@@ -463,4 +447,23 @@ Be sure to go through on the following checklist:
       # dev/release/post-12-website.sh ../arrow-site
       dev/release/post-12-website.sh <arrow-site-dir>
 
+.. dropdown:: Announce the new release
+   :class-title: sd-fs-5
+   :class-container: sd-shadow-md
+
+   Write a release announcement and send to announce@apache.org and
+   dev@arrow.apache.org.  The script below will generate an announcement.  It
+   requires you to provide the URL of the blog post above, so this cannot be
+   sent until the blog post is published.  Also, it expects to be run from the
+   *release branch* and not ``main``.
+
+   The announcement to announce@apache.org must be sent from your apache.org
+   e-mail address to be accepted.
+
+   Template:
+
+   .. code-block:: Bash
+
+      dev/release/post-10-announce.sh
+
 .. _nightly-website.yml: https://github.com/apache/arrow-adbc/actions/workflows/nightly-website.yml

docs/source/driver/installation.rst

@@ -19,6 +19,19 @@
 Installation
 ============
 
+.. We can't link to things like conda-forge or crates.io because we
+   technically do not vote on those packages as part of the release; they are
+   created post-release. (Python wheels are voted on, though.) If we want to
+   fix this, we would have to do something like provide prereleases on these
+   platforms that we promote post-vote.
+
+   The main Arrow project links to unofficial releases with a disclaimer, but
+   as far as I can tell, this isn't actually allowed. Given our announce
+   emails are getting rejected, let's not risk it.
+
+   https://apache.org/legal/release-policy#publication
+   > Your project's download page can only link to release artifacts that your PMC has approved.
+
 .. note::
 
    See individual driver pages in the sidebar for specific installation instructions.
@@ -28,7 +41,7 @@ Source
 
 Download the latest source release: |source_download| (|source_checksum|, |source_signature|)
 
-To verify a release, please see the `instructions`_ page  and the project's `KEYS`_ file.
+When downloading, please check the SHA512 checksum, and verify the OpenPGP-compatible signature against the project's `KEYS`_ file.  Both the checksum and signature are provided above.  See the `instructions`_ page for more details.
 
 Compilation instructions can be found in `CONTRIBUTING.md`_.
 
@@ -39,18 +52,14 @@ Compilation instructions can be found in `CONTRIBUTING.md`_.
 C/C++
 =====
 
-Install the appropriate driver package.  You can use conda-forge_, ``apt`` or ``dnf``.
-
-conda-forge:
-
-- ``mamba install libadbc-driver-flightsql``
-- ``mamba install libadbc-driver-postgresql``
-- ``mamba install libadbc-driver-sqlite``
+Install the appropriate driver package.  Packages for ``apt`` and ``dnf`` are provided as part of official releases.
 
 You can use ``apt`` on the following platforms:
 
-- Debian GNU/Linux bookworm
-- Ubuntu 22.04
+- Debian GNU/Linux 12 ("bookworm")
+- Debian GNU/Linux 13 ("trixie")
+- Ubuntu 22.04 LTS ("jammy")
+- Ubuntu 24.04 LTS ("noble")
 
 Prepare the Apache Arrow APT repository:
 
@@ -109,16 +118,6 @@ Then they can be used via CMake, e.g.:
 
    target_link_libraries(myapp PRIVATE AdbcDriverPostgreSQL::adbc_driver_postgresql_shared)
 
-.. _conda-forge: https://conda-forge.org/
-
-Go
-==
-
-Add a dependency on the driver package, for example:
-
-- ``go get -u github.com/apache/arrow-adbc/go/adbc@latest``
-- ``go get -u github.com/apache/arrow-adbc/go/adbc/driver/flightsql@latest``
-
 Java
 ====
 
@@ -141,15 +140,8 @@ For example, from PyPI:
 - ``pip install adbc-driver-snowflake``
 - ``pip install adbc-driver-sqlite``
 
-From conda-forge_:
-
-- ``mamba install adbc-driver-flightsql``
-- ``mamba install adbc-driver-postgresql``
-- ``mamba install adbc-driver-snowflake``
-- ``mamba install adbc-driver-sqlite``
-
 R
-=
+===
 
 Install the appropriate driver package from CRAN:
 
@@ -171,13 +163,3 @@ Ruby
 
 Install the appropriate driver package for C/C++. You can use it from
 Ruby.
-
-Rust
-====
-
-Add a dependency on ``adbc_core`` and any driver packages
-(e.g. ``adbc_datafusion``):
-
-.. code-block:: shell
-
-   cargo add adbc_core adbc_datafusion