KhronosGroup / KhronosGroup/SYCL_Reference

"Host task" chapter desing

Open
#129 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
C++
Stars
31
Forks
26
PR merge metrics
No merged PRs in 30d

Description

Currently, the [Host tasks](https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#subsec:interfaces.hosttasks) chapter is not represented in the Reference Guide.

We propose to add it with the following structure:

- Host task
- Host task basic concept ([4.10.1. Overview](https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#sec:interfaces.hosttasks.overview))
- ``sycl::interop_handle`` ([4.10.2. Class interop_handle](https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#subsec:interfaces.hosttasks.interophandle))
- Additions to the ``sycl::handler`` class ([4.10.3. Additions to the handler class](https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#subsec:interfaces.hosttask.handler))

This chapter will be added between the "Expressing Parallelism" and "Error Handling" chapters in the current structure:
![image](https://github.com/KhronosGroup/SYCL_Reference/assets/122783909/e9742e59-dbbf-402f-b91f-e7f954f72e57)

Could you please review and provide your opinion and recommendations for this chapter?
We will create PR after a discussion.

Contributor guide

No contributing guide indexed for this repository

Research direction

Review the proposed Host task structure against the linked SYCL 2020 sections 4.10.1–4.10.3 and the current Reference Guide chapter order. Done means recommendations are recorded and the chapter scope and placement are agreed before a PR is created.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.