tractor/docs/api
Gud Boi d6bed7c4a0 Port docs off `run_in_actor` + `Portal.wait_for_result`
The 8-page docs sweep of the #477 removal, ahead of the API's
excision,

- `start/quickstart.rst`: the first-actor-tree walkthrough now
  narrates the (migrated) `to_actor.run()` example — no portal
  in hand until the daemon section introduces `start_actor()`.
- `guide/spawning.rst`: the one-shot section becomes
  `to_actor.run()` (blocking call, placement opts, "built on the
  primitives" note); lifetime/teardown rules update — one-shots
  never make it to nursery exit since each is reaped inside its
  own call.
- `guide/rpc.rst`: the `wait_for_result()` section (an API that
  dies with the reap cluster, incl. the `NoResult` sentinel)
  becomes a `to_actor.run()` one-shot section.
- `api/core.rst`: drop `run_in_actor`/`wait_for_result` from the
  autodoc member lists, drop the `Portal.result()` deprecation
  note, add a "One-shot task actors" `tractor.to_actor.run`
  autodoc section.
- `guide/{asyncio,context,cancellation,parallelism}.rst`:
  mention swaps to the successor API.

Gate: `make -C docs html` builds clean; `to_actor.run` autodoc
renders in `api/core.html`.

(this patch was generated in some part by [`claude-code`][claude-code-gh])
[claude-code-gh]: https://github.com/anthropics/claude-code
2026-07-06 12:31:02 -04:00
..
context.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
core.rst Port docs off `run_in_actor` + `Portal.wait_for_result` 2026-07-06 12:31:02 -04:00
devx.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
discovery.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
errors.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
index.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
ipc.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
msg.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
to_asyncio.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
trionics.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00