Add CI for releases, set a versioning scheme for the proto (#4)

.github/workflows/pre-release.yml

@@ -0,0 +1,22 @@
+name: "pre-release"
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  pre-release:
+    name: "Pre-release"
+    runs-on: "ubuntu-latest"
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - uses: "marvinpinto/[email protected]"
+        with:
+          repo_token: "${{ secrets.GITHUB_TOKEN }}"
+          automatic_release_tag: "dev"
+          prerelease: true
+          title: "Development build"
+          files: '*.proto'

.github/workflows/tagged-release.yml

@@ -0,0 +1,20 @@
+name: "tagged-release"
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  pre-release:
+    name: "Tagged release"
+    runs-on: "ubuntu-latest"
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - uses: "marvinpinto/[email protected]"
+        with:
+          repo_token: "${{ secrets.GITHUB_TOKEN }}"
+          prerelease: false
+          files: '*.proto'

README.md

@@ -5,4 +5,20 @@ Protocol Buffers and gRPC specifications for the Jelly protocol.
 - `grpc.proto` – Jelly's gRPC protocol service specifications.
 
 ## Usage
-The protocol is not stable yet and will change. Expect a first stable release in Q1 2023.
+The protocol is not stable yet and will change. Expect a first stable release in Q1 2023.
+
+## Versioning
+This protocol follows the [Semantic Versioning 2.0 scheme](https://semver.org/). The current major version is 1, and after it stabilizes, backward compatibility with it will be kept in future 1.x.y versions.
+
+### Releases
+The `dev` release tag corresponds to the main branch in the repository and is updated automatically.
+
+Tagged (versioned) releases are created manually. To create a new tagged release (example for version 1.2.3):
+```sh
+git checkout main
+git pull
+git tag v1.2.3
+git push origin v1.2.3
+```
+
+The rest (packaging and release creation) will be handled automatically by the CI.

grpc.proto

@@ -1,5 +1,5 @@
 syntax = "proto3";
-package eu.ostrzyciel.jelly.core.proto;
+package eu.ostrzyciel.jelly.core.proto.v1;
 
 // gRPC service specifications for RDF streaming.
 

rdf.proto

@@ -1,7 +1,7 @@
 syntax = "proto3";
-package eu.ostrzyciel.jelly.core.proto;
+package eu.ostrzyciel.jelly.core.proto.v1;
 
-// Protocol Buffers Rdf serialization.
+// Jelly RDF serialization with Protocol Buffers.
 
 // === Rdf Terms ===
 message RdfIri {