[DOC] Please make separate (sub) section for each functionality.

[pysan3]

In the current README, all explanation of nio.* classes are provided as simple paragraphs.

As per the limitation on GitHub, only sections are provided with a link (eg https://github.com/nvim-neotest/nvim-nio#usage ).

I would appreciate if it would be possible to make the feature paragraphs their own distinct sections, such as ### nio.control.

Thanks in advance ;)

[pysan3]

@rcarriga

Unrelated but,

How should I describe to be inside a nio.run?

nio.run(function ()
  -- inside a <???>
  -- - an asynchronous environment?
  -- - a nio task?
  -- - a nio job?
  -- - a nio environment?
  -- - a nio run?
end)

[rcarriga]

Good question :sweat_smile: I refer to them as "async contexts" in the docs and error messages.

[pysan3]

Ah, nice. Thanks ;)