当ブログは YAMDAS Project の更新履歴ページです。2019年よりはてなブログに移転しました。

Twitter はてなアンテナに追加 Feedlyに登録 RSS

Wikiがドキュメンテーションに適した5つの理由

なんというか、こちらもいまどき珍しく直球な Wikiドキュメンテーションへの利用のススメである。

果たしてその根拠は何か。

  1. Wiki は簡単な記法を提供するので、貢献者はほとんどマークアップを覚える必要がない
  2. 貢献者は専用のツールをインストールする必要がなく、ウェブブラウザがあればいい
  3. ホスティングサイトによってはサービス内容に Wiki が含まれるものもある
  4. Wiki には大概バージョン管理が組み込まれているので、編集のロールバックも数クリックで可能
  5. 一部の Wiki プラットフォームには「Talk」ページがあり、メタ議論が可能

うーん、理由もやはり直球だけど、日本から生まれた Wiki エンジンの多くは、バージョン管理や「会話」ページを持つにいたらないまま進化が止まってしまった、と書いてよいのだろうか。

というか新たに Wiki を単独でサーバに立てるというより、モダンな開発環境に Wiki も含まれてる、というので利用する開発者のほうが多いだろう。

Wiki Way―コラボレーションツールWiki

Wiki Way―コラボレーションツールWiki

[YAMDAS Projectトップページ]


クリエイティブ・コモンズ・ライセンス
YAMDAS現更新履歴のテキストは、クリエイティブ・コモンズ 表示 - 非営利 - 継承 4.0 国際 ライセンスの下に提供されています。

Copyright (c) 2003-2023 yomoyomo (E-mail: ymgrtq at yamdas dot org)