Skip to content

Commit

Permalink
[doc] More clearly explain our version support timelines (#20121)
Browse files Browse the repository at this point in the history
  • Loading branch information
jwnimmer-tri authored Sep 5, 2023
1 parent d34b2dc commit 1d00891
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 7 deletions.
19 changes: 12 additions & 7 deletions doc/_pages/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ notebooks. See the [Tutorials](/index.html#tutorials) page for details.
The following table shows the configurations and platforms that Drake
officially supports:

| Operating System ⁽¹⁾ | Architecture | Python ⁽²⁾ |
|------------------------------------|--------------|------------|
| Ubuntu 20.04 LTS (Focal Fossa) | x86_64 | 3.8 ⁽³⁾ |
| Ubuntu 22.04 LTS (Jammy Jellyfish) | x86_64 | 3.10 ⁽³⁾ |
| macOS Monterey (12) | x86_64 | 3.11 |
| macOS Monterey (12) | arm64 | 3.11 |
| macOS Ventura (13) | arm64 | 3.11 |
| Operating System ⁽¹⁾ | Architecture | Python ⁽²⁾ | End of life ⁽⁴⁾ |
|------------------------------------|--------------|------------|-----------------|
| Ubuntu 20.04 LTS (Focal Fossa) | x86_64 | 3.8 ⁽³⁾ | March 2024 |
| Ubuntu 22.04 LTS (Jammy Jellyfish) | x86_64 | 3.10 ⁽³⁾ | March 2026 |
| macOS Monterey (12) | x86_64 | 3.11 | October 2023 |
| macOS Monterey (12) | arm64 | 3.11 | October 2023 |
| macOS Ventura (13) | arm64 | 3.11 | October 2024 |

"Official support" means that we have Continuous Integration test coverage to
notice regressions, so if it doesn't work for you then please file a bug report.
Expand All @@ -43,6 +43,11 @@ that Conda is involved.
⁽³⁾ The Python version shown in the table is supported for all installation
channels. Additionally, on Ubuntu when installing via ``pip`` Python versions
3.8 through 3.11 (inclusive) are supported.
Refer to [OS Support](/stable.html#os-support) for details on our "end of life"
timeline for changing which Python versions are supported.

⁽⁴⁾ These end-of-life dates are estimates.
Refer to [OS Support](/stable.html#os-support) for details.

Additionally, if you are compiling your own C++ code against Drake's C++ code
and are using Drake's pre-compiled binaries, then you must use the same
Expand Down
10 changes: 10 additions & 0 deletions doc/_pages/stable.md
Original file line number Diff line number Diff line change
Expand Up @@ -220,5 +220,15 @@ Drake intends to support the two most recent versions of Ubuntu LTS and macOS
on an ongoing basis. That generally means that your OS must be no more than
~2-4 years old for Ubuntu, or ~2 years old for macOS.

On Ubuntu, Drake only intends to support Ubuntu's default version of Python (at
``/usr/bin/python3``), except when installing from pip in which case any newer
version is also intended to be supported. This is consistent with
[NEP-29](https://numpy.org/neps/nep-0029-deprecation_policy.html).

On macOS, Drake only intends to support the one newest version of Python
available via Homebrew.
See [#18791](https://github.com/RobotLocomotion/drake/issues/18791) for a
discussion of possible improvements.

Refer to [Installation and Quickstart](/installation.html) for the current
details.

0 comments on commit 1d00891

Please sign in to comment.