現状、メニュー中のアイテムを参照する際には、`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
**File <span aria-label="そして">></span> Open Folder**のように直接Markdownファイル中に書く
これはGoogle developer documentation style guideにできる限り準拠した書き方となっており、改行位置やアクセシビリティなどがしっかりと考慮されている。- 上記の書き方にするが、このような書き方をするためのコンポーネントを作成してそれを利用する
- 単に
**File > Open Folder**のように直接Markdown中に書く
一旦、3の方法を採用することにする。現状教材中でアクセシビリティの考慮が十分なされているとは言い難い中で、1のような複雑な書き方を採用することは難しいと考えられるからである。一旦は簡単な書き方を採用し後々アクセシビリティの考慮などを行うことにする。
現状、メニュー中のアイテムを参照する際には、
`Settings`>`SSH and GPG keys`>`New SSH key`のようにして参照している。cf.
utcode-learn/docs/3-web-servers/10-git-github-init/index.mdx
Line 144 in 27d5138
utcode-learn/docs/3-web-servers/12-github/index.mdx
Line 91 in 27d5138
このような参照時の書き方は何かのガイドラインに基づいているわけではなく、あまり適切とはいえない。そのため、このような場合にどのような書き方をするべきかについて再考する必要がある。
Google developer documentation style guideにおいて、このような場合にどのように書くべきかについて記載されている。これをもとに次の3つの方針を考えた。cf. https://developers.google.com/style/ui-elements#term-menus
**File <span aria-label="そして">></span> Open Folder**のように直接Markdownファイル中に書くこれはGoogle developer documentation style guideにできる限り準拠した書き方となっており、改行位置やアクセシビリティなどがしっかりと考慮されている。
**File > Open Folder**のように直接Markdown中に書く一旦、3の方法を採用することにする。現状教材中でアクセシビリティの考慮が十分なされているとは言い難い中で、1のような複雑な書き方を採用することは難しいと考えられるからである。一旦は簡単な書き方を採用し後々アクセシビリティの考慮などを行うことにする。