diff --git a/docs/get_started.rst b/docs/get_started.rst index e838cd588..10c09cb18 100644 --- a/docs/get_started.rst +++ b/docs/get_started.rst @@ -236,13 +236,14 @@ choice to create a pool of reusable worker threads. .. attention:: - `GIL `_ has the potential to - undermine your concurrency performance, as it prevents multiple threads from - accessing the same line of code simultaneously. Libraries like - `NumPy `_ can mitigate this for parallel intensive - computations as they free the GIL. RxPy may also minimize thread overlap to some - degree. Just be sure to test your application with concurrency and ensure there - is a performance gain. + The `GIL `_ has the potential to + undermine your concurrency performance in Python versions prior to 3.13, as it prevents + multiple threads from accessing the same line of code simultaneously. Starting with Python 3.13, + the GIL can be disabled via the free-threading mode (enabled with the `--disable-gil` build option), + allowing for true multi-threading parallelism. Libraries like `NumPy `_ + can mitigate GIL limitations for parallel intensive computations as they release the GIL during + operations. RxPy may also minimize thread overlap to some degree. Just be sure to test your application + with concurrency and ensure there is a performance gain, especially when using free-threading builds. The :func:`subscribe_on() ` instructs the source :class:`Observable ` at the start of the chain which scheduler to