More details for oneTBB migration

[e4lam]

While the current documentation for migrating to oneTBB is good, I feel that it's still lacking some details. Perhaps a one to one port of the old https://www.threadingbuildingblocks.org/docs/help/index.htm#reference/task_scheduler/catalog_of_recommended_task_patterns.html to the new interfaces would help for some of the low-level API migration.

[alexey-katranov]

@e4lam, can you please point which topics are the most important to start with?

Notify: @aleksei-fedotov @alexandraepan

[e4lam]

For me, it would be the "Recycling Parent as Continuation" and "Recycling Parent as Child" sections. It strikes me that the new API unnecessarily induces extra heap allocation that didn't occur before?

[aggieNick02]

Note the link above no longer works, and just redirects to the main github page

[e4lam]

New link courtesy of google:
https://scc.ustc.edu.cn/zlsc/tc4600/intel/2015.1.133/tbb/tbb_ugref/reference/task_scheduler/catalog_of_recommended_task_patterns.htm

[anton-potapov]

(Unofficial) Link that works (at least for now) http://wwweic.eri.u-tokyo.ac.jp/computer/manual/eic2015/doc/intel/en_US/tbb/tbb_ugref/index.htm#reference/task_scheduler.htm

[isaevil]

The builds of documentation for TBB 2020 (or older) are available at Release section on GitHub (tbb-2020.3-doc.zip): https://github.com/oneapi-src/oneTBB/releases/tag/v2020.3.

[arunparkugan]

@isaevil is this still relevant?

[e4lam]

It's been improved somewhat but I don't know. 🤷