Update documentation

[x42005e1f]

What do these changes do?

This PR updates the documentation to reflect the latest changes: recommends to use the new aclose() method (ad2b1bd) and clarifies that the slowdown "can be", but not necessarily "will be" (4a57895). In fact, in no-wait tests Janus can now be comparable to standard queues, but in worst cases where notification methods are often called, it can still show significant performance slowdown, so "only when used as intended" remains. In particular, in Culsans benchmarks Janus is still slower than the naive solution.

Are there changes in behavior for the user?

There are no behavior changes for users.

[codspeed-hq]

CodSpeed Performance Report

Merging #713 will not alter performance

_{Comparing x42005e1f:master (ef166f1) with master (4a57895)}

Summary

✅ 4 untouched benchmarks

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 94.42%. Comparing base (4a57895) to head (ef166f1).
Report is 1 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #713   +/-   ##
=======================================
  Coverage   94.42%   94.42%           
=======================================
  Files           5        5           
  Lines        1472     1472           
  Branches      127      127           
=======================================
  Hits         1390     1390           
  Misses         55       55           
  Partials       27       27           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[asvetlov]

Thanks!