チームで Scrapbox を運用するときに役立ちそうなメモ

[ma96o]

• ページ頭に要約やページ自体の説明を書く
  • 一文で収まるとよい
• 一文は完結に，情報密度の薄い部分は省く
  • 〇〇のように，〇〇のため，〇〇の場合，などで一文を繋ぐと冗長になりがち
• 句点いらない
• 固有名詞，専門用語はとりあえずリンクにしておく
• リンクは # をなるべく使わずに，[] を使い文章で関係をつくる

  • は名詞の書き投げになってしまいがちで，意味がハイコンテクストになる

• 書きかけの記事は #wip などではなく，[TODO] 運用する
  • コーディングにおけるコメントアウトのように [TODO]:${やること} を書いておく
  • 定期的に TODO リンクをスクリーニングするメンテナンス体制を整えるの重要
• なるべくリンクは入力補完で選択する
  • 表記ゆれを防ぐ
• ページ間はなるべく疎結合に，意味を完結させる
• 一つのページが長いと感じた場合は，部分的に他ページに切り出す

[ma96o]

• 単なるインデックス（一覧）ページはいらない
  • 基本的にリンクがインデックス機能をもっているので，単に羅列されたページはいらない
  • ただし，各概念の関係や関係から生まれる情報を記すための一覧ページはあり