Document sub-trees

オープン 初心者向け
#750 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
75/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
静か
技術スタック
rust
領域
documentation

調査の方向性

ARCHITECTURE.md の提案されている Sub-trees セクションと、TreeId および crate の既存ドキュメントを確認してください。doc items からリンクできるように、crate のドキュメントまたは TreeId のドキュメントに同等の説明を追加し、subtree の namespacing、graft nodes、TreeUpdate の個別の送信が正確に説明されていることを確認してください。

索引モデルが issue の本文から書いたものです。

説明

Here's the section I wrote for the ARCHITECTURE.md PR.

Sub-trees

An app's accessibility tree can be composed of several subtrees.

The idea behind subtrees is to allow different actors to produce accessibility trees without coordinating (for example, because they're separate processes in a browser), and let the main application submit them to the adapters, which take care of combining them.

The main way this separation manifests is in namespacing: each subtree can pick whatever NodeIds it wants without worrying about colliding with other subtree's NodeIds.
NodeId(123) in one subtree and NodeId(123) in another subtree refer to completely different nodes

Subtrees are composed through "graft nodes", Node instances with a "tree_id" property set to the id of the subtree.

Each sub-tree has to be submitted to the adapter with a separate TreeUpdate. When presented to the platform's accessibility APIs, the sub trees will be stitched together and submitted as a single accessibility tree.

I think we should have something like this section somewhere in the crate doc, so that doc items can link to it.

An obvious place to put that section would be on the TreeId type, but it can go anywhere as long as rustdoc can link to it and it stays updated.

主要言語
Rust
スター
1.5k
フォーク
114
平均マージ
8時間 25分
マージ済み PR（30日）
28

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

AccessKit/accesskit のほかの issue

AccessKit/accesskit の issue をすべて見る

似ている issue

Rust の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。