Skip to content

メニュー中のアイテムを参照する時の書き方を変更 #928

@chvmvd

Description

@chvmvd

現状、メニュー中のアイテムを参照する際には、`Settings`>`SSH and GPG keys`>`New SSH key`のようにして参照している。
cf.

登録ページへの移動方法は、`Settings`>`SSH and GPG keys`>`New SSH key`と順に移動すればたどり着けます。
登録が完了したら、`origin`として登録したリモートリポジトリにコミットを送信します。この操作を**プッシュ**と呼びます。プッシュをするには、`Pull, Push`>`Push to...`>`origin`を押します。

このような参照時の書き方は何かのガイドラインに基づいているわけではなく、あまり適切とはいえない。そのため、このような場合にどのような書き方をするべきかについて再考する必要がある。

Google developer documentation style guideにおいて、このような場合にどのように書くべきかについて記載されている。これをもとに次の3つの方針を考えた。cf. https://developers.google.com/style/ui-elements#term-menus

  1. **File&nbsp;<span aria-label="そして">></span> Open Folder**のように直接Markdownファイル中に書く
    これはGoogle developer documentation style guideにできる限り準拠した書き方となっており、改行位置やアクセシビリティなどがしっかりと考慮されている。
  2. 上記の書き方にするが、このような書き方をするためのコンポーネントを作成してそれを利用する
  3. 単に**File > Open Folder**のように直接Markdown中に書く

一旦、3の方法を採用することにする。現状教材中でアクセシビリティの考慮が十分なされているとは言い難い中で、1のような複雑な書き方を採用することは難しいと考えられるからである。一旦は簡単な書き方を採用し後々アクセシビリティの考慮などを行うことにする。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions