Skip to content

Commit 616306f

Browse files
committed
docs: Reorganize n_analysis_workers documentation
Simplify the documentation structure: - Move usage explanation to regular section text - Add concise "Experimental" warning about potential removal/changes - Keep "Signature analysis parallelization" note to clarify automatic parallelization is independent of this option
1 parent 278076a commit 616306f

File tree

1 file changed

+12
-18
lines changed

1 file changed

+12
-18
lines changed

docs/src/launching.md

Lines changed: 12 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -153,27 +153,21 @@ require a server restart to take effect.
153153

154154
Number of concurrent analysis worker tasks for running full analysis.
155155

156+
The code loading phase must execute sequentially due to package environment and
157+
world age constraints. However, when multiple analysis units are open (e.g.,
158+
package source code and test code), increasing `n_analysis_workers` may reduce
159+
overall analysis time: while one unit is in the signature analysis phase,
160+
another can begin code loading concurrently.
161+
162+
!!! warning "Experimental"
163+
This option is experimental and may be removed or its semantics may be changed
164+
substantially in future versions as the full analysis architecture evolves.
165+
156166
!!! note "Signature analysis parallelization"
157167
The signature analysis phase is parallelized automatically using
158168
`Threads.@spawn` when Julia is started with multiple threads. This
159-
parallelization is independent of `n_analysis_workers` and generally
160-
provides significant speedups (e.g., ~4x faster with 4 threads for large
161-
packages).
162-
163-
!!! warning "Current limitations"
164-
This option is experimental. JETLS currently runs all analysis within a
165-
single server process. These "workers" are concurrent tasks, not separate
166-
processes. Due to constraints around package environment switching and
167-
world age management, the code loading phase of each analysis unit must
168-
execute sequentially.
169-
170-
However, when multiple analysis units are open (e.g., package source code
171-
and test code), increasing `n_analysis_workers` may reduce overall analysis
172-
time: while one unit is in the signature analysis phase, another can begin
173-
code loading concurrently.
174-
175-
The semantics of this option may change substantially in future versions as
176-
the full analysis architecture evolves.
169+
parallelization is independent of `n_analysis_workers` and provides
170+
significant speedups (e.g., ~4x faster with 4 threads for large packages).
177171

178172
### [Client configuration](@id init-options/client-config)
179173

0 commit comments

Comments
 (0)