Document single_threaded_async feature

Open
#15 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
rust
Domain
documentation

Research direction

Start by locating the documentation for the single_threaded_async feature and the guidance for wasm targets. Explain when, how, and why users should enable the feature, including that it is not automatically enabled for wasm or other targets. Done means users can make an informed choice from the documentation alone.

Written by the indexing model from the issue text.

Description

Before proceeding, is there an existing issue or discussion for this?
Description

Until web assembly can support threading, users that target web assembly will need to activate the single_threaded_async feature.

I believe we shouldn't automatically turn on the single_threaded_async behavior for wasm targets because

  1. web assembly will probably support multi-threading before very long
  2. users may have reasons for wanting the single-threaded execution even without wasm

so we'll just keep it as its own feature, but we should provide clear documentation on when, how, and why to use it.

Dominant language
Rust
Stars
75
Forks
18
Avg merge
12d 12h
Merged PRs (30d)
3

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from open-rmf/crossflow

All issues in open-rmf/crossflow

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.