本サイトの全面リニューアル(1st, #3928) でpendingにしていたタスクを列挙

[KATO-Hiro]

WHY

• 1stリリースでは、最優先で取り組む内容に絞った
• 2ndリリースでは、色々直したい or 新たに追加したい要素がある

WHAT

優先度: 高

• GAのプロパティを更新 #5859
• Herokuを利用しているサービス・ツールを探す
  • 理由: 2022年11月末で無料プランが廃止されるため、サービスの終了の可能性もあるため
• 上記のサービス・ツールの作者にサービス継続について尋ねる
  • 理由: 有志がサービスの引き継ぎを考えてくださっているため & 最新の情報を掲載するため
• gifの差し替え
  • 理由: 現在のUIと合わせるため
• プライバシーポリシーの英語版を追加
  • 理由: 絶対数は少ないが、海外の利用者への配慮と法的な対策のため
• Jekyll関連のファイルを削除 #4548
  • 理由: サイトジェネレータを変更して、不要になったと思われるため
• TOCを廃止 Solved by Jekyll関連のファイルを削除 #4548
  • 理由: 同上
• サイトのリニューアルに関するアンケートを取る
  • 理由: ユーザにとって本質的な改善になっているか?を確認するため
• 目次を追加
  • 理由: これまでと同じ操作感で利用できた方がいい思われるため
• 昼間モード: ヘッダーをプロジェクトのテーマ色となるように修正 #4773
  • 理由: サイトのイメージカラーと異なるので、直したい。2022/10/09に、Dockerコンテナをrebuidlしたところローカル環境でも発生することを確認
  • See: https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#__tabbed_2_1
• Libraryページに、メンテナンスの状態を表すバッジを追加
  • 理由: ユーザがライブラリを選択する基準を提示した方がいいと思われるため
• 設定ファイルで環境変数を使う
  • 理由: セキュリティのリスクを少しでも減らすため
• 更新が止まっていると思われるサービス・ツールや古くなった記事をarchivesへ #6204
  • 理由: 最新の状態を保つため
• 各媒体のトップページから、詳細ページに移動できるリンクを追加
  • 理由: スマホユーザへの配慮が必要であると思われるため
• FAQページを用意
  • 理由: ユーザの利便性向上のため
• Contributingページに、サービス・ツール・記事などの紹介や本サイトを宣伝していただいた方を掲載
  • 理由: 本サイトに多大な貢献をされているため

優先度: 中

• 逆引きページを追加
  • 理由: quick startページだけでは、見たいサービスに到達できない可能性があると思われるため
  • ユーザにアンケートを取り、需要があるか確認
• 色変記事: 同じ年で達成した場合は、新しい順に並べる #5695
  • 理由: 上から新しい情報を並べることで、利用者がスクロールの回数を減らすため
• 2022年2月以前のChangelogのリンクを修正 #4551
  • 理由: 利用者が履歴から見たい内容へすぐに飛べるようにするため
• ベージやカテゴリの再分類
  • For Beginners
  • Books ページを分類 #6106
  • Article - 実装テクニックページの再分類 #6386
  • Lib
  • 理由: 初期に修正した部分は、とても大雑把な区分になっていて探しづらいと思われるため
• masterブランチからmainブランチに変更
  • 理由: 以前のデフォルトではあるが、masterという表記が良くないという記事を読んだため
• GitHub スポンサーに登録 #4502
  • 理由: AtCoder関連のサービス・ツールを継続的に開発・運営するため
  • 懸念事項: スポンサーに明確なメリットを示せるか?
• web archiveを使っている場合は、そのことを明記
  • 理由: 正確を期するため
• マシュマロアカウントの取得 & リンクを追加
  • 理由: Twitterアカウントを持っていないユーザへの配慮が必要であると思われるため & TwitterのDMでは言いづらいこともあると思われるため
• プロジェクトの方針・方向性を加筆
  • 理由: 明文化できていない部分があるように思われるため

優先度: 低

• 英語版ページの導入 #6208
  • 理由: 海外ユーザの割合が徐々に増えており、多言語対応が必要だと思われるため
  • 海外ユーザは、アジア圏が多いため、漢字でなんとなく読めるという状態なっている?要確認
• ユーザ名を最新or highestのレーティング帯の色でハイライト
  • 理由: 視認性を高めるため
• mkdocsのスポンサーになって、Card UIを導入
  • 理由: quick startの利便性を向上させるため
  • 懸念事項: この機能を導入するためだけに、10$ / 月は高いと感じる（15$ / 月に値上げされる可能性もある）

参考

• Awesomeリストに掲載するバッジ

https://zenn.dev/yutakatay/articles/neovim-pluginlist
https://github.com/yutkat/my-neovim-pluginlist

• mkdocsで環境変数を使う

https://www.mkdocs.org/user-guide/configuration/#environment-variables
https://github.com/waylan/pyyaml-env-tag

[KATO-Hiro]

参考

• mkdocsの活用例

https://github.com/Siv3D/siv3d.docs/blob/master/mkdocs.yml