Skip to content

Doc fixes and improvements #11600

Doc fixes and improvements

Doc fixes and improvements #11600

Workflow file for this run

# Uncommment this to replace the rest of the file when you want to debug stuff in CI
#name: Run Debug
#
#on:
# push:
# pull_request:
# workflow_dispatch:
#
#jobs:
# debug:
# runs-on: ubuntu-latest
## runs-on: windows-latest
# steps:
# - uses: actions/checkout@v5
# with: { fetch-depth: 1 }
#
# - run: "echo temurin:11 > .mill-jvm-version"
#
# - uses: sbt/setup-sbt@v1
#
#
# - run: ./mill 'integration.migrating[init].local.daemon.testOnly' mill.integration.MillInitSbtGatlingTests
#
# We run full CI on push builds to main and on all pull requests
#
# To maximize bug-catching changes while keeping CI times reasonable, we run
# tests scattered between Java 11/17/24, across linux/mac/windows, intel/arm
name: Run Tests
on:
push:
branches-ignore:
- '**-patch-**'
pull_request:
types:
- opened
- reopened
- synchronize
- ready_for_review
workflow_dispatch:
# cancel older runs of a pull request;
# this will not cancel anything for normal git pushes
concurrency:
# * For runs on other repos, always use the `ref_name` so each branch only can have one concurrent run
# * For runs on `com-lihaoyi/mill`, use `head_ref` to allow one concurrent run per PR, but `run_id` to
# allow multiple concurrent runs in master
group: cancel-old-pr-runs-${{ github.workflow }}-${{ (github.repository != 'com-lihaoyi/mill' && github.ref_name) || (github.head_ref || github.run_id) }}
cancel-in-progress: true
jobs:
# Jobs are listed in rough order of priority: if multiple jobs fail, the first job
# in the list should be the one that's most worth looking into
build-linux:
if: (github.event.action == 'ready_for_review') || (github.event.pull_request.draft == false)
uses: ./.github/workflows/pre-build.yml
with:
os: ubuntu-latest
shell: bash
build-windows:
if: (github.event.action == 'ready_for_review') || (github.event.pull_request.draft == false)
uses: ./.github/workflows/pre-build.yml
with:
os: windows-latest
shell: powershell
test-docs:
if: (github.event.action == 'ready_for_review') || (github.event.pull_request.draft == false)
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
with: { fetch-depth: 1 }
- run: ./mill -i website.fastPages + website.checkBrokenLinks
cross-plat:
if: (github.event.action == 'ready_for_review') || (github.event.pull_request.draft == false)
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
# Run these with Mill native launcher as a smoketest
include:
- os: ubuntu-24.04-arm
millargs: "'example.thirdparty[{mockito,netty,arrow}].native.daemon'"
java-version: 17
- os: macos-latest
millargs: "'example.thirdparty[{acyclic,fansi,gatling}].native.daemon'"
java-version: 11
- os: macos-13
millargs: "'example.thirdparty[{jimfs,commons-io}].native.daemon'"
java-version: 24
steps:
- uses: actions/checkout@v5
with: { fetch-depth: 1 }
- uses: ./.github/actions/pre-build-setup
with:
os: ${{ matrix.os }}
java-version: ${{ matrix.java-version }}
shell: bash
- uses: ./.github/actions/post-build-setup
with:
java-version: ${{ matrix.java-version }}
os: ${{ matrix.os }}
- uses: ./.github/actions/post-build-selective
with:
millargs: ${{ matrix.millargs }}
shell: bash
linux:
needs: build-linux
strategy:
fail-fast: false
matrix:
include:
# For most tests, run them arbitrarily on Java 11 or Java 17 on Linux, and
# on the opposite version on Windows below, so we get decent coverage of
# each test on each Java version and each operating system
# We also try to group tests together to manually balance out the runtimes of each jobs
- java-version: 17
millargs: "'{contrib,core,testkit,runner,dist}.__.test'"
- java-version: 17
millargs: "'libs.{scalalib,init,tabcomplete}.__.test'"
install-sbt: true
- java-version: 11
millargs: "'libs.{scalajslib,scalanativelib,kotlinlib,pythonlib,javascriptlib}.__.test'"
- java-version: 17
millargs: "example.kotlinlib.__.local.daemon"
- java-version: 11
millargs: "example.scalalib.__.local.daemon"
- java-version: 17
millargs: "example.javalib.__.local.daemon"
- java-version: 17
millargs: "'example.androidlib.__.local.daemon'"
setup-android: true
- java-version: 17
millargs: "'example.thirdparty[androidtodo].packaged.daemon'"
setup-android: true
- java-version: 24
millargs: "'example.migrating.scalalib.__.local.daemon'"
install-sbt: true
- java-version: 24
millargs: "'example.{pythonlib,javascriptlib}.__.local.daemon'"
- java-version: 17
millargs: "'example.{cli,fundamentals,depth,extending,large}.__.local.daemon'"
- java-version: 17.0.16
millargs: "'integration.{feature,ide}.__.packaged.daemon'"
# run this specifically in `native` mode to make sure our non-JVM native image
# launcher is able to bootstrap everything necessary without a JVM installed
- java-version: 17
millargs: "'integration.bootstrap[no-java-bootstrap].native.daemon'"
# These invalidation tests need to be exercised in both execution modes
# to make sure they work with and without -i/--no-server being passed
- java-version: 24
millargs: "'integration.invalidation.__.packaged.nodaemon'"
- java-version: 17
millargs: "'integration.migrating.__.packaged.daemon'"
install-sbt: true
uses: ./.github/workflows/post-build-selective.yml
with:
setup-android: ${{ matrix.setup-android || false }}
install-sbt: ${{ matrix.install-sbt || false }}
install-xvfb: ${{ matrix.install-xvfb || false }}
java-version: ${{ matrix.java-version }}
millargs: ${{ matrix.millargs }}
shell: bash
windows:
needs: build-windows
strategy:
fail-fast: false
matrix:
include:
- java-version: 24
millargs: "'integration.invalidation.__.packaged.daemon'"
- java-version: 11
millargs: '"example.migrating.javalib.__.packaged.daemon"'
- java-version: 11
millargs: '"libs.{util,javalib,androidlib,graphviz}.__.test"'
- java-version: 17
millargs: '"example.scalalib.{basic,publishing}.__.packaged.daemon"'
- java-version: 17
millargs: "'integration.failure.__.packaged.nodaemon'"
- java-version: 17
millargs: "'integration.bootstrap[no-java-bootstrap].native.daemon'"
uses: ./.github/workflows/post-build-selective.yml
with:
os: windows-latest
java-version: ${{ matrix.java-version }}
millargs: ${{ matrix.millargs }}
shell: powershell
itest:
needs: build-linux
strategy:
fail-fast: false
matrix:
include:
# bootstrap tests
- java-version: 11
buildcmd: ci/test-dist-run.sh && ci/test-mill-bootstrap.sh
uses: ./.github/workflows/post-build-raw.yml
with:
java-version: ${{ matrix.java-version }}
buildcmd: ${{ matrix.buildcmd }}
# Scalafmt, Mima, and Scalafix job runs last because it's the least important:
# usually just an automated or mechanical manual fix to do before merging
lint-autofix:
needs: build-linux
uses: ./.github/workflows/post-build-raw.yml
with:
java-version: '17'
buildcmd: |
set -eux
./mill -i mill.scalalib.scalafmt.ScalafmtModule/scalafmt --check + __.fix --check + mill.javalib.palantirformat.PalantirFormatModule/ --check + mill.kotlinlib.ktlint.KtlintModule/checkFormatAll
mima:
needs: build-linux
uses: ./.github/workflows/post-build-raw.yml
with:
java-version: '17'
buildcmd: |
set -eux
./mill -i __.mimaReportBinaryIssues