Adding 'module' way to build docs (#16)

Upgrading dependencies
Changing current build to 'latest'
Adding 'release' build
Adding new commands to README

Author: MaximilianSoerenPollak

MODULE.bazel

@@ -23,7 +23,7 @@ bazel_dep(name = "rules_pkg", version = "1.0.1")
 # Python version
 #
 ###############################################################################
-bazel_dep(name = "rules_python", version = "1.0.0")
+bazel_dep(name = "rules_python", version = "1.4.1")
 
 PYTHON_VERSION = "3.12"
 
@@ -36,20 +36,21 @@ python.toolchain(
 use_repo(python)
 
 # Additional Python rules provided by aspect, e.g. an improved version of
-bazel_dep(name = "aspect_rules_py", version = "1.0.0")
+bazel_dep(name = "aspect_rules_py", version = "1.4.0")
 bazel_dep(name = "buildifier_prebuilt", version = "7.3.1")
 
 ###############################################################################
 #
 # Generic linting and formatting rules
 #
 ###############################################################################
-bazel_dep(name = "aspect_rules_lint", version = "1.3.1")
+bazel_dep(name = "aspect_rules_lint", version = "1.4.2")
 
 # Provides, pytest & venv
-bazel_dep(name = "score_python_basics", version = "0.3.0")
+bazel_dep(name = "score_python_basics", version = "0.3.1")
 
 # Checker rule for CopyRight checks/fixes
 bazel_dep(name = "score_cr_checker", version = "0.2.2")
-bazel_dep(name = "score_docs_as_code", version = "0.2.2")
 bazel_dep(name = "score_format_checker", version = "0.1.1")
+bazel_dep(name = "score_platform", version = "0.1.1")
+bazel_dep(name = "score_docs_as_code", version = "0.2.6")

README.md

@@ -1,13 +1,15 @@
 # process_description
+
 S-CORE process description
 
 ## Overview
-The S-CORE process model aims to establish organization rules for developing open source software in the automotive industry, which can be used in safety and security context.
 
+The S-CORE process model aims to establish organization rules for developing open source software in the automotive industry, which can be used in safety and security context.
 
 ## Features
 
 The process model provide processes, which conform to state-of the art standards
+
 - ASPICE PAM 4.0
 - ISO 26262
 - ISO/SAE 21434
@@ -17,20 +19,39 @@ The process model provide processes, which conform to state-of the art standards
 
 #### Run a documentation build:
 
+#### Integrate latest score main branch
+
 ```bash
-bazel run //process:incremental
-bazel build //process:docs
-bazel run //process:ide_support
+bazel run //process:incremental_latest
+bazel build //process:docs_latest
+```
+
+#### Integrate latest score release
+
+This should also work with proxy configuration if latest is not working.
+
+```bash
+bazel run //process:incremental_release
+bazel build //process:docs_release
 ```
 
 #### Access your documentation at:
 
 - `_build/` for incremental
 - `bazel-bin/bazel-bin/<BUILD FILE FOLDER NAME>/docs/_build/html`
 
+#### Getting IDE support
+
+Create the virtual environment via `bazel run //process:ide_support`.\
+If your IDE does not automatically ask you to activate the newly created environment you can activate it.
+
+- In VSCode via `ctrl+p` => `Select Python Interpreter` then select `.venv/bin/python`
+- In the terminal via `source .venv/bin/activate`
+
 #### Format your documentation with:
 
 ```bash
 bazel test //:format.test
 bazel run //:format.fix
-```
+```
+

process/BUILD

@@ -24,12 +24,22 @@ docs(
     conf_dir = "process",  # Where 'conf.py' is
     docs_targets = [
         {
-            "suffix": "",  # latest main branch documentation build
+            "suffix": "latest",  # latest main branch documentation build
             "external_needs_info": [
                 {
-                    "base_url": "https://eclipse-score.github.io/score/main",
+                    "base_url": "https://eclipse-score.github.io/score/main/",
                     "json_url": "https://eclipse-score.github.io/score/main/needs.json",
-                    "version": "0.1",
+                    "id_prefix": "score_",
+                },
+            ],
+        },
+        {
+            "suffix": "release",  # The version imported from MODULE.bazel
+            "target": ["@score_platform//docs:docs_needs"],
+            "external_needs_info": [
+                {
+                    "base_url": "https://eclipse-score.github.io/score/main/",
+                    "json_path": "/score_platform~/docs/docs_needs/_build/needs/needs.json",
                     "id_prefix": "score_",
                 },
             ],