CI: switched the workflow to manual mode + bump IETF version (#243)

Author: glpatcern

.github/workflows/rfc.yml

@@ -1,10 +1,7 @@
-name: Build RFC XML
+name: Prepare I-D for Datatracker
 
 on:
-  push:
-    branches: [develop]
-    paths: [IETF-RFC.md]
-  workflow_dispatch:         
+  workflow_dispatch:
 
 jobs:
   build:
@@ -13,7 +10,6 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      # Ruby setup
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: '3.2'
@@ -22,25 +18,34 @@ jobs:
       - name: Install kramdown-rfc
         run: gem install --no-document kramdown-rfc
 
+      - name: Bump I-D version
+        run: perl -pe 's/open-cloud-mesh-(\d+)/"open-cloud-mesh-" . sprintf("%02d", $1 + 1)/e' -i IETF-RFC.md || exit -1
+
       - name: Convert Markdown to XML
         run: kramdown-rfc IETF-RFC.md > IETF-RFC.xml
 
+      - uses: actions/upload-artifact@v4
+        with:
+          name: rfc-md
+          path: IETF-RFC.md
+
       - uses: actions/upload-artifact@v4
         with:
           name: rfc-xml
           path: IETF-RFC.xml
 
-      # Commit the result back to the repo
+      # Create a PR to the repo with the results
       - uses: peter-evans/create-pull-request@v6
         with:
           branch: rfc/gen-${{ github.sha }}
           base: develop
           add-paths: |
+            IETF-RFC.md
             IETF-RFC.xml
-          commit-message: 'CI: regenerate IETF-RFC.xml'
+          commit-message: 'CI: regenerate IETF-RFC.xml for Datatracker'
           signoff: true
           title: 'Regenerate IETF-RFC.xml'
-          body: 'Automatic XML regeneration by CI'
+          body: 'This autogenerated PR bumps the IETF version of the I-D and prepares the IETF-RFC.xml file for submission to the [IETF Datatracker](https://datatracker.ietf.org/submit)'
           reviewers: |
             glpatcern
             michielbdejong

README.md

@@ -20,7 +20,7 @@ The Open Cloud Mesh API specification is an open source, community-driven projec
 
 If you'd like to contribute, please follow the [Contributing Guidelines](CONTRIBUTING.md) and the [IETF Note Well](https://www.ietf.org/about/note-well/).
 
-To contribute to the Draft, please do all edits in `IETF-RFC.md` only. A GitHub action will regenerate the `IETF-RFC.xml` file.
+To contribute to the Draft, please do all edits in `IETF-RFC.md` only. A [GitHub action](https://github.com/cs3org/OCM-API/actions/workflows/rfc.yml) is available to prepare a new version of the `IETF-RFC.xml` file for submission to the IETF Datatracker.
 
 ## History and Changelog