This is done for several reasons:
- Recent CPython versions such as 3.13 have mostly caught up
with Pyston in terms of performance. If the trend continues,
CPython may supersede Pyston's performance in the long term.
This is especially the case if the experimental JIT is
eventually able to run Godot's SCons setup.
- Pyston is not maintained anymore (its last release was in 2022),
and the last Python version it can run is 3.8. Python 3.8 is now
end-of-life. Godot's SCons setup (as well as SCons itself) will
eventually require Python versions newer than 3.8.
- Reorder instructions to mention ARM64 builds first in macOS,
as this is the primary architecture in use now (with all new Macs
since 2023 being sold with Apple Silicon only). The `lipo` command still
works as before, as it infers the architecture from the input files.
- Remove the manual bundle generation steps to make the page shorter
(similar to Compiling for Android).
- Remove references to the master branch (this was only relevant when
4.0 was still in development).
- Ensure most pages are reachable through the sidebar, by removing headers on pages that are mostly indexes.
- This also means that some pages now have navigable headers again.
- Remove prompt or `$` sign which makes triple-click based selection
more difficult and time-consuming.
- Use `platform` instead of `p` alias in all SCons examples.
`..` immediately following paragraph text at the same indentation is
interpreted as a continuation of that text, as seen on the website:
https://docs.godotengine.org/en/stable/contributing/how_to_contribute.html#technical-contributions
> Upload your plugins to the Godot Asset Library to make them available to others. .. update to talk about Asset Store later
I feel the intent was still clear, but it does look a bit weird at the moment.
Further information:
- There must be a blank line between the text block and the comment for the
comment to be properly interpreted as a comment.
- There must not be two blank lines between the two list items, once the
comment is ignored. Otherwise, the generated output produces two separate
lists. This a perceptibly different amount of padding compared to when they
were structurally part of the same list in HTML output, since Godot adds
extra padding around `<ul>` tags.
* Ubuntu APT oneliner to install system builtin alternatives
Might work on Debian, not sure - tested on Ubuntu 24.04 LTS
* Use new table syntax (easier to maintain), add Debian
---------
Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>