diff --git a/ijs.tree b/ijs.tree index 829c53428..ebd661ffa 100644 --- a/ijs.tree +++ b/ijs.tree @@ -1,5 +1,5 @@ - + @@ -69,12 +69,12 @@ - + diff --git a/topics/appendix/glossary.md b/topics/appendix/glossary.md index 4f0ee28fe..3bf072124 100644 --- a/topics/appendix/glossary.md +++ b/topics/appendix/glossary.md @@ -1,4 +1,4 @@ - + # Glossary @@ -19,7 +19,7 @@ Annotator ## B Blocking Context -: Executing in the [blocking context](coroutine_execution_contexts.md#blocking-context) means executing tasks on a thread without access to a coroutine context. +: Executing in the [blocking context](execution_contexts.md#blocking-context) means executing tasks on a thread without access to a coroutine context. → _Suspending Context_ → _Coroutine_ @@ -130,7 +130,7 @@ Stubs : A subset of a → _Program Structure Interface_ tree in a binary serialized compact format, see [](stub_indexes.md). Suspending Context -: Executing in the [suspending context](coroutine_execution_contexts.md#suspending-context-coroutines) means executing tasks in Kotlin coroutines. +: Executing in the [suspending context](execution_contexts.md#suspending-context-coroutines) means executing tasks in Kotlin coroutines. → _Blocking Context_ → _Coroutine_ diff --git a/topics/basics/architectural_overview/threading/background_processes.md b/topics/basics/architectural_overview/threading/background_processes.md index 37b28b9b5..3db864513 100644 --- a/topics/basics/architectural_overview/threading/background_processes.md +++ b/topics/basics/architectural_overview/threading/background_processes.md @@ -14,7 +14,7 @@ The IntelliJ Platform executes background processes widely and provides two main > Plugins targeting 2024.1+ should use [Kotlin coroutines](kotlin_coroutines.md), which is a more performant solution and provides the cancellation mechanism out of the box. > -> See [](coroutine_execution_contexts.md) for coroutine-based APIs to use in different contexts. +> See [](execution_contexts.md) for coroutine-based APIs to use in different contexts. > {style="warning" title="Use Kotlin Coroutines"} diff --git a/topics/basics/architectural_overview/threading/coroutines/coroutine_edt_and_locks.md b/topics/basics/architectural_overview/threading/coroutines/coroutine_edt_and_locks.md index 71a43433a..ad18541b7 100644 --- a/topics/basics/architectural_overview/threading/coroutines/coroutine_edt_and_locks.md +++ b/topics/basics/architectural_overview/threading/coroutines/coroutine_edt_and_locks.md @@ -1,4 +1,4 @@ - + # Coroutines on EDT and Locks @@ -161,7 +161,7 @@ Sometimes it is not desired, as the coroutine in question was scheduled on [`Dis Anyway, it is suspicious when a read action cannot be executed on a background thread and a part of coroutine code cannot be suspended and rescheduled on EDT. This may signal a code issue. -Note that this API cannot be used in the [blocking context](coroutine_execution_contexts.md#blocking-context). +Note that this API cannot be used in the [blocking context](execution_contexts.md#blocking-context). ### Suspending `readAndWriteAction()` @@ -176,7 +176,7 @@ Consider rewriting code to use it, if possible. Use them if a read action is required, but it is unacceptable to reschedule code execution on a different dispatcher. -These APIs are marked to use only in the [blocking context](coroutine_execution_contexts.md#blocking-context), so their usage in the [suspending context](coroutine_execution_contexts.md#suspending-context-coroutines) will trigger a warning. +These APIs are marked to use only in the [blocking context](execution_contexts.md#blocking-context), so their usage in the [suspending context](execution_contexts.md#suspending-context-coroutines) will trigger a warning. It is intentional, as coroutines should be prepared to be rescheduled and should use `readAction()`. ### Suspending `writeIntentReadAction()` and Blocking `WriteIntentReadAction.run()`/`compute()` diff --git a/topics/basics/architectural_overview/threading/coroutines/coroutine_execution_contexts.md b/topics/basics/architectural_overview/threading/execution_contexts.md similarity index 100% rename from topics/basics/architectural_overview/threading/coroutines/coroutine_execution_contexts.md rename to topics/basics/architectural_overview/threading/execution_contexts.md diff --git a/topics/ui/controls/progress_indicators.md b/topics/ui/controls/progress_indicators.md index 11d9e5542..8c7f8224a 100644 --- a/topics/ui/controls/progress_indicators.md +++ b/topics/ui/controls/progress_indicators.md @@ -1,4 +1,4 @@ - + # Progress Indicators @@ -6,7 +6,7 @@ -**Implementation**: Progress tracking in [Progress API](background_processes.md#tracking-progress) and [Kotlin Coroutines](coroutine_execution_contexts.md#progress-reporting) +**Implementation**: Progress tracking in [Progress API](background_processes.md#tracking-progress) and [Kotlin Coroutines](execution_contexts.md#progress-reporting)