本Scrapboxの書き方ガイドライン
このCosense全体の書き方についてのガイドラインです
原則
ルールを設け過ぎると運用上破滅する
このCosenseは個人運用なのでまだマシだが、これが複数人管理とかになってくるとより破滅する
情報を検索・閲覧・記録しやすくする
ガイドライン
階層構造は原則作らない
これはCosenseを採用している時点で担保できている
See: /shokai/階層整理型WiKiはスケールしない
名前が重複する別ページが発生し得る場合、括弧やコロンを利用してがんばる
例: 畳 (画面)
例: Three.js: GLTFLoader
ページタイトルの禁止文字
混合を避けるため、全角数字・全角括弧は原則禁止とします
例外: 人名の一部の場合
ページタイトルは、主要Wiki上に同義のページがある場合、それに従う
Wikipediaの日本語版ならびに英語版・ニコニコ大百科・ピクシブ百科事典に同義のページがある場合、そのタイトルを参考にしましょう
Wikipedia日本語版を優先する
なるべく記事は小分けにする
1概念1記事
タグはページ冒頭に・密接な関係のあるものから順に置く
密接な関係のあるものから順に置くと、関連記事の順位がより適切になるんだよ
作業予定・作業中のページにはTODOへのリンクを付与する
膨大なTODOリストの出来上がりです
もの・ひとの実体を扱うページはEntityタグに属させる
Entityタグの一覧を見て、どういうものがEntityに属するべきかの勘所をつかむと良いです
Entityタグに属するページは、タイトルと記事構造を他のページと合わせる
情報をたどりやすいよう、Entityページのタイトルや記事構成はできるだけ揃えよう
詳細は各Entityページを参照
完璧に揃えだすとガチガチルールになってきもいので、ふんわりで結構です
なるべく出典を示す
お前が書いてること、100%正しいわけねーじゃん!
自分と他人が、出典の記述を参照しながら正しい情報にたどり着けるよう、出典を示そう
それ以外の文体は制約しない
思考と知恵を吐き出す効率を優先する
丁寧に書いてもいいし、俗語的表現が多くても良いし、雑多な箇条書きとなっても良いし、URLやYouTubeを貼っただけの記事でも問題ない
句点は打ったり打たなかったりするし、体言止めだったりしなかったり
ただ、ページをわかりやすくするため、以下のようなベストプラクティスは存在する。ルールではない
Wikipediaに倣い、記事の最初に記事名を太字にして書き始めるとわかりやすそう 🔗
作品名は『』で囲うと良さそう
内閣告示『外来語の表記』にできるだけ従うと良さそう