GH-25271: Update Apache Description Of A Project (DOAP) File

alamb commented 1 year ago

Rationale for this change

The Apache Community Development committee (ComDev) maintains a website projects.apache.org which lists all ASF projects, and some basic details about them. These details are derived from DOAP (Description Of A Project) file that is maintained by each PMC.

What changes are included in this PR?

Update the DOAP file for Arrow, which (in theory) drives the content of https://projects.apache.org/project.html?arrow, based on the output of the form at https://projects.apache.org/create.html.

I have already updated projects.xml as described on https://projects.apache.org/create.html. See https://github.com/apache/arrow/issues/25271#issuecomment-1735477349 for more details

Are these changes tested?

N/A

Are there any user-facing changes?

No

Closes: https://github.com/apache/arrow/issues/25271

alamb commented 1 year ago

Can we keep ? (The latest version is 13.0.0 at 2023-08-23: https://arrow.apache.org/release/ )

Given the DOAP page provides a link to https://arrow.apache.org/release/

My rationale in proposing to remove the specific version release link is that the value in avoiding a click through was not worth the the potential confusion if the link was stale (e.g. points at an old release)

If there is some straightforward / automated way to ensure it stays up to date, perhaps we can do that instead.

kou commented 1 year ago

My rationale in proposing to remove the specific version release link is that the value in avoiding a click through was not worth the the potential confusion if the link was stale (e.g. points at an old release)

I understand.

If there is some straightforward / automated way to ensure it stays up to date, perhaps we can do that instead.

OK. How about the following?

diff --git a/_data/versions.yml b/_data/versions.yml
index 8273c1d1801..b68e9385490 100644
--- a/_data/versions.yml
+++ b/_data/versions.yml
@@ -19,7 +19,7 @@ current:
   number: '13.0.0'
   pinned_number: '13.0.*'
   major_number: '13'
-  date: '23 August 2023'
+  date: 2023-08-23
   git-tag: 'b7d2f7ffca66c868bd2fce5b3749c6caa002a7f0'
   github-tag-link: 'https://github.com/apache/arrow/releases/tag/apache-arrow-13.0.0'
   release-notes: 'https://arrow.apache.org/release/13.0.0.html'
diff --git a/arrow.rdf b/arrow.rdf
index fb2d6e79784..296ecae313f 100644
--- a/arrow.rdf
+++ b/arrow.rdf
@@ -1,3 +1,5 @@
+---
+---
 <?xml version="1.0"?>
 <?xml-stylesheet type="text/xsl"?>
 <rdf:RDF xml:lang="en"
@@ -49,8 +51,8 @@
     <release>
       <Version>
         <name>Apache Arrow</name>
-        <created>2022-10-31</created>
-        <revision>10.0.0</revision>
+        <created>{{ site.data.versions.current.date }}</created>
+        <revision>{{ site.data.versions.current.number }}</revision>
       </Version>
     </release>
     <repository>

We can refer https://github.com/apache/arrow-site/blob/main/_data/versions.yml data by {{ site.data.versions... }} by adding YAML front matter. (Empty YAML front matter is added in this case.)
We already have the current release information in the file.
The file is generated automatically in apache/arrow release process. [*] (I can fix date format later in apache/arrow.)

[*] https://github.com/apache/arrow/blob/aca1d3eeed3775c2f02e9f5d59d62478267950b1/dev/release/post-03-website.sh#L238-L272

alamb commented 1 year ago

Thanks @kou -- I have implemented your suggestion in 634e0ad I think.

alamb commented 1 year ago

I tested this locally by building the site (bundle exec rake ...) and then downloading http://localhost:4000/arrow.rdf. It seems to have worked great. Thank you @kou for sharing your Jekyll knowledge. 🙏

$ tail -n 15 ~/Downloads/arrow\ \(1\).rdf
    <release>
      <Version>
        <name>Apache Arrow</name>
        <created>2023-08-23</created>
        <revision>13.0.0</revision>
      </Version>
    </release>
    <repository>
      <GitRepository>
        <location rdf:resource="https://github.com/apache/arrow.git"/>
        <browse rdf:resource="https://github.com/apache/arrow/"/>
      </GitRepository>
    </repository>
  </Project>
</rdf:RDF>

apache / arrow-site