diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml new file mode 100644 index 00000000..37d3ae3d --- /dev/null +++ b/.github/workflows/documentation.yml @@ -0,0 +1,47 @@ +name: "Documentation" + +on: + pull_request: + branches: + - "*.x" + paths: + - .github/workflows/documentation.yml + - docs/** + push: + branches: + - "*.x" + paths: + - .github/workflows/documentation.yml + - docs/** + +jobs: + validate-with-guides: + name: "Validate documentation with phpDocumentor/guides" + runs-on: "ubuntu-22.04" + + steps: + - name: "Checkout code" + uses: "actions/checkout@v3" + + - name: "Install PHP" + uses: "shivammathur/setup-php@v2" + with: + coverage: "none" + php-version: "8.2" + + - name: "Remove existing composer file" + run: "rm composer.json" + + - name: "Require phpdocumentor/guides-cli" + run: "composer require --dev phpdocumentor/guides-cli dev-main@dev --no-update" + + - name: "Configure minimum stability" + run: "composer config minimum-stability dev" + + - name: "Install dependencies with Composer" + uses: "ramsey/composer-install@v2" + with: + dependency-versions: "highest" + + - name: "Run guides-cli" + run: "vendor/bin/guides -vvv --no-progress --fail-on-log docs/en /tmp/test" diff --git a/src/ArrayCollection.php b/src/ArrayCollection.php index 2804fd76..59f26e48 100644 --- a/src/ArrayCollection.php +++ b/src/ArrayCollection.php @@ -429,6 +429,8 @@ public function partition(Closure $p) /** * Returns a string representation of this object. * {@inheritDoc} + * + * @return string */ #[ReturnTypeWillChange] public function __toString()