About

このサイトについて

目的

このサイトは自分の得た知識や経験をアウトプットすることを目的とした"ログ"である。
アウトプットをする理由としては、自分の能力向上とWeb上の知識の蓄積が期待できるためである。

誤表記や誤字脱字の修正依頼等について

誤字や脱字、内容の修正等の要望がある場合は、GitHubの PullRequest 又は Issue を使ってください。

方針

記事は大きく2つに大別し、それぞれ以下の運用方針をとる。


ブログ

一般的なブログ記事と同じもので、事象を単に記録したものや、 ライブラリやソフト等の紹介・使い方・バグに対するワークアラウンドなど、一時的な情報を記載する。 誤字や重大な誤記、直すべきところは修正するが、内容の更新は原則行わない。 最終更新日から一定期間が経過したものについてはその旨記事の頭に注釈を表示する。 blogタグをつけて区別する。


記事

技術的な概念や基礎技術/知識、方法論など、長く変わらないものや恒久的な情報を記載する。 記載した内容が変わったのであれば、可能な限り更新を行う。 内容の更新を行う理由としては、内容の更新をせずに古い情報がのさばっていたり、 コメントや追記でわかりづらく更新が追加されている等、 ユーザビリティを大きく欠くサイトに自分がうんざりしているためである。 また、何らかの理由で更新がかなわなくなった場合は、 更新停止した旨及び最終更新からどの程度経過しているのかを記事の頭に記載する。 articleタグをつけて区別する。


また、以下の点は2つとも共通とする。

  • Gitのコミットログを更新履歴とする
  • 原則的に更新の形跡を記事に残して汚すことはしない
  • 記事の修正、更新はGitHubのPullRequest機能を用いて行う