CG サイトデザインとサイト構成の検討 - Githubissues

w3c / wot-jp-cg

W3C Web of Things Japanese Community Group

https://wot-jp-cg.netlify.app/

Other

9 stars 10 forks source link

CG サイトデザインとサイト構成の検討 #41

Closed dynamis closed 2 years ago

dynamis commented 2 years ago

CG サイト https://wot-jp-cg.netlify.app/ はまずはチュートリアル数ページを掲載する形で docsify デフォルトのシンプルなデザイン、構成で作り始めましたが、内容も増えてきましたしそろそろ全体のデザインや構成の見直しもしていくと良いかと思います。

現状の課題:

サイドバーの目次だけ見ても全体の構成、知りたいことが何処にあるか分かりにくい
サイトバーリンクになっているものとそうでないものがあるが分かりにくい
デバイス毎の説明なのか、ライブラリ毎の説明なのか、仕様の説明なのか分からない

やるべきだろうこと:

トップページをちゃんと書いて何が何処に書かれているか分かるようにする
仕様の位置づけであったり仕様の説明であったりするページを追加する
ドキュメントサイト用にもう少ししっかりしたテンプレートなどを採用する
- Docusaurus v2 https://docusaurus.io/ ベースで適当なテンプレを選んで採用すると良いかと思う

叩き台とするサイトマップなどの案を考えて提案させて頂くつもりですが、最低ここは入れて欲しいとかポイントなどあればどんどんコメントください。

dynamis commented 2 years ago

同時に立てられた #42 の方で議論が始まってるのでそちらをベースに話を進めるものとしてはこちらの issue は duplicate close しますね