ページを作る上で注意すること
コンテンツ
表記ゆれ
製品等は公式の表記を使う
タイトル
特定の言語やツールに関する内容はタイトルの先頭に【】で囲ってその名称を入れる
Google等で検索結果に表示されたときにわかりやすくするため
1ページにいろんな要素を詰め込まないようにするため
タグ
大きく関連する項目のタグを#TAG形式でページ先頭に書く
末尾にはScrapBoxのリンクが作られるので、こちらは先頭に
複数個あるときは改行しない(タグで冒頭の表示を浪費しない)
タグはできれば日本語のほうが良い気がする
【ツール】のほうが【Tool】より文中に入れやすい
文中の[TAG]は気が向いたら書く
キーワードっぽいなって単語が出てきたらとりあえず囲っておく程度でOK
強制ルール化しても忘れる、文章を公正してると邪魔になる
その他
画像を入れる
記事一覧で俯瞰したときになんか見た目が良いので
公式アイコンやロゴがあるなら、それを入れておくだけでも見栄えが良くなる
日付・バージョン等を入れる
技術情報は情報の鮮度や対象となるバージョンが重要になることも多いので忘れないようにする
ScrapBoxにもその行の編集日時がわかる機能があるけど、マウスオーバーする必要がありこの目的にとっては不足