タグ

wikiに関するbraitomのブックマーク (27)

  • 信用できる社内 Wiki をつくるために守ってほしい、たったひとつのルール - 無印吉澤

    このページについて この記事は、以前書いた「社内Wikiに情報を書くときに守ってほしい、たったひとつのルール」の続編です。前回は、個々のページをどう書くべきかという話をしましたが、今回は社内 Wiki 全体を信用できるものにする方法について考えます。 muziyoshiz.hatenablog.com 想定する環境 この記事は、ソフトウェア開発プロジェクトに関する Wiki が社内にあって、そこに各人がドキュメント(仕様書や手順書など)を書けるようになっている環境を想定しています。 私自身、ソフトウェア開発のときしか Wiki を使わないので、具体例もそのような環境に寄っています。ただ、ある程度は社内 Wiki 全般に通じる話かと思います。 ルール:「更新され続ける」ページと「更新されない」ページをはっきり分ける ここ1年ほど社内プロジェクトをいくつか渡り歩いていたのですが、個人的には、こ

    信用できる社内 Wiki をつくるために守ってほしい、たったひとつのルール - 無印吉澤
    braitom
    braitom 2017/01/14
    信用できる情報をストックする方法のノウハウ
  • Markdownで書けるドキュメントコラボレーションサービスを比較する|TechRacho by BPS株式会社

    注: "␣"はスペースを意味します。 特にPukiWikiを書く頻度が下がると、更新のたびに書き方をググって思い出すこともしばしばです。 ドキュメントが長くなってメンテしづらい PukiWikiを含む従来のWikiではドキュメントを比較的自由に構成できるので、ともすると長大な目次、長大な文ができあがってしまいます。こうなってしまうと後から分割するのも面倒ですし、文以外に目次もメンテナンスしなければいけません。 表示のレイアウトが崩れることがある PukiWikiを含む従来のWiki記法(残念ながらWikipediaのMediaWiki記法も含め)は、なまじレイアウトをある程度コントロールできるために記法が複雑になり、気をつけて書かないとレイアウトが崩れることがあります。 Markdownについて GitHubGitLabで標準採用されたこともあり、近年はMarkdown記法が急速に定

    Markdownで書けるドキュメントコラボレーションサービスを比較する|TechRacho by BPS株式会社
    braitom
    braitom 2016/12/13
    ドキュメントコラボレーションサービスに求める条件をもとにConfluence、Qiita:Qiita:Team、esa.ioなどを比較している。価格面での比較も欲しいところ。
  • Vimwiki by vimwiki

    Vimwiki is a personal wiki for Vim – interlinked, plain text files written in a markup language With Vimwiki you can organize notes and ideas and quickly create links between them manage todo-lists write a diary Features three markup syntaxes supported: Vimwiki's own syntax, Markdown, MediaWiki export everything to HTML link to other wiki pages and external files search through all wiki pages outl

    Vimwiki by vimwiki
    braitom
    braitom 2016/12/13
    Vim上で動くpersonal Wiki。HTMLへのコンバートもできる。
  • 最近の社内Wikiの書き出し - その手の平は尻もつかめるさ

    最近,社内Wiki書く時にその記事の頭に「この記事で分かること」というセクションを持ってくるようにしている.こんな感じ. wikiのページを開いた時に真っ先に「どういう情報が得られるか」が書いてあると,取捨選択を早い段階から行えるので調べ物のスピードが上がって良いような気がしている. あと所属している組織ではConfluenceを使っていて,Confluenceの検索機能に引っかかるような (引っかけやすいような) ワードを「この記事で分かること」に含めるように心がけている. 地味に便利になりつつある気がしている. [追記] そう言えばConfluenceの検索結果は「タイトル」と「サマリ」が出るんだけど,冒頭にこういう情報を書いておくとそれがサマリ部分に表示されるから,検索結果一覧の段階から情報の取捨選択できて便利というのもあった.

    最近の社内Wikiの書き出し - その手の平は尻もつかめるさ
    braitom
    braitom 2016/11/20
    良い。こういうちょっとした工夫が情報共有をより良いものにしていくんだろうな。"記事の頭に「この記事で分かること」というセクションを持ってくるようにしている"
  • Scrapbox - A new style of team wiki

    Cosense turns experience into knowledge with effortless writing and linking. Cosense is a tool for the ingenious and creative.The key to productivity is knowledge. The more experience you accumulate, the more you can do. And you grow faster when you fight together. Now you can share experience and compound knowledge in your organization easily. Because it’s so easy-to-use, your team behavior evolv

    Scrapbox - A new style of team wiki
    braitom
    braitom 2016/11/18
    Gyazoが始めたWikiサービス。Slack通知、コードハイライトの機能あり。privateプロジェクトの作成もできる。これは気になる。
  • BookStack

    Simple & Free Wiki Software BookStack is a simple, self-hosted, easy-to-use platform for organising and storing information. GitHub  - Demo  - Install Latest Blog Post: Using BookStack as a Linux File System Free & Open Source BookStack is fully free and open, MIT licensed. The source is available on GitHub. There is no cost to downloading and installing your own instance of BookStack. View the so

  • Crowi

    編集はすべて Markdown で行います。 Markdown を使えば、わかりやすい平易な文法で記載でき、美しく整形されます。 また編集中はリアルタイムにプレビューで確認することができます。

    Crowi