docs: add the new build tools and adjust supported technologies

README.md

@@ -6,7 +6,15 @@
 
 Macaron is a supply chain security analysis tool from [Oracle Labs](https://labs.oracle.com/pls/apex/r/labs/labs/intro), which focuses on the build integrity of an artifact and the artifact dependencies. It is based on the [Supply chain Levels for Software Artifacts (SLSA)](https://slsa.dev/) specification, which aims at preventing some of the software supply chain attacks as the systems get more complex, especially with respect to the use of open-source third-party code in applications. Attacks include stealing credentials, injecting malicious code etc., and it is critical to have security assurance on the third-party code to guarantee that the integrity of the code has not been compromised.
 
-Macaron uses [SLSA requirements specifications v0.1](https://slsa.dev/spec/v0.1/requirements) to define concrete rules for protecting software integrity that can be checked for compliance requirements automatically. Macaron provides a customizable checker platform that makes it easy to define checks that depend on each other. This is particularly useful for implementing checks for SLSA levels. In addition, Macaron also checks a user-specified policy for the repository to detect unexpected behavior in the build process. Macaron is a work-in-progress project and currently supports Maven and Gradle Java build systems. Support has also been added for Python projects that use Pip or Poetry as their package managers, minus dependency analysis. We plan to support build systems for other languages in future.
+Macaron uses [SLSA requirements specifications v0.1](https://slsa.dev/spec/v0.1/requirements) to define concrete rules for protecting software integrity that can be checked for compliance requirements automatically. Macaron provides a customizable checker platform that makes it easy to define checks that depend on each other. This is particularly useful for implementing checks for SLSA levels. In addition, Macaron also checks a user-specified policy for a software component to detect unexpected behavior in the build process. We currently support the following build tools:
+
+* Maven and Gradle Java build systems
+* Pip or Poetry package managers for Python
+* npm and Yarn for JavaScript
+* Go
+* Docker
+
+To see the full list of supported technologies, such as CI services, registries, and provenance types see [this page](https://oracle.github.io/macaron/pages/supported_technologies/index.html). Macaron is a work-in-progress project. We plan to support more build systems and technologies in the future.
 
 ## Table of Contents
 

docs/source/pages/supported_technologies/index.rst

@@ -5,27 +5,55 @@
 Supported Technologies
 ======================
 
+-----------
+Build Tools
+-----------
+
+Macaron is able to detect the build and deployment scripts for the following build tools and package managers while analyzing the CI configurations,
+such as GitHub Actions workflows.
+
+* Maven
+* Gradle
+* Pip
+* Poetry
+* npm
+* Yarn
+* Go
+* Docker
+
+
 ------------
 Git Services
 ------------
 
-.. list-table::
-   :header-rows: 1
+Currently, we support the following Git services for version control. If you need support for any other Git services, feel free to open a GitHub issue.
 
-   * - Git Service
-   * - `GitHub <https://github.com>`_
-   * - `GitLab <https://gitlab.com>`_
+* `GitHub <https://github.com>`_
+* `GitLab <https://gitlab.com>`_
 
 ------------
 CI Services
 ------------
 
+Currently, we support the following Continuous Integration (CI) services for automatically building and deploying artifacts. If you need support for any other CI services, feel free to open a GitHub issue.
+
 .. list-table::
    :header-rows: 1
 
    * - CI Service
+     - Support
    * - `GitHub Actions <https://github.com/features/actions>`_
-
+     -
+        * Detecting deployment steps by building a call graph for workflows and reachable shell scripts
+        * Support for various GitHub APIs, such as Releases
+   * - `GitLab <https://gitlab.com>`_
+     - Partial support for detecting deployment steps
+   * - `Jenkins <https://www.jenkins.io>`_
+     - Partial support for detecting deployment steps
+   * - `Travis CI <https://www.travis-ci.com>`_
+     - Partial support for detecting deployment steps
+   * - `CircleCI <https://circleci.com/>`_
+     - Partial support for detecting deployment steps
 
 ------------------
 Package Registries
@@ -39,10 +67,10 @@ Package Registries
      - Support
      - Documentation
    * - `JFrog Artifactory <https://jfrog.com/artifactory>`_
-     - Only projects built with Gradle and publishing to a JFrog Artifactory repo following `Maven layout <https://maven.apache.org/repository/layout.html>`_
+     - Projects built with Gradle and published to a JFrog Artifactory repo following `Maven layout <https://maven.apache.org/repository/layout.html>`_
      - :doc:`page </pages/supported_technologies/jfrog>`
    * - `Maven Central Artifactory <https://central.sonatype.com>`_
-     - Only projects built with Gradle or Maven and published to the Maven Central Artifactory.
+     - Projects built with Gradle or Maven and published to the Maven Central Artifactory.
      - :doc:`page </pages/supported_technologies/maven_central>`
 
 -----------
@@ -57,11 +85,15 @@ Provenances
      - Support
      - Documentation
    * - `SLSA <https://slsa.dev>`_
-     - Only provenances under `SLSA version 0.2 <https://slsa.dev/spec/v0.2/provenance>`_.
+     -
+       * `SLSA provenance version 0.2 <https://slsa.dev/spec/v0.2/provenance>`_.
+       * The provenance should be published as a GitHub release asset
      - :doc:`page </pages/supported_technologies/jfrog>`
    * - `Witness <https://github.com/testifysec/witness>`_
-     - * Only provenances under Witness version 0.1
-       * Only projects built with Gradle on GitLab CI provenances and publishing provenances to JFrog Artifactory
+     -
+       * Witness provenance version 0.1
+       * Projects built with Gradle on GitLab CI
+       * The provenance should be published on JFrog Artifactory
      - :doc:`page </pages/supported_technologies/jfrog>`
 
 --------