背景: GitHub wiki への不満 私の所属する研究室では、メンバー全員が１つの GitHub Organization に所属しており、情報共有はその Organization 上のリポジトリの GitHub wiki で行われています。 研究室がコンピュータサイエンス系であることもあってメンバーは GitHub や Markdown に慣れており、普段 GitHub wiki を使っていて困ることはそんなになかったのですが、それでも時々不満が出ることがありました。 不満として多いのは、色々記事を書いているうちに全体構造がよくわからなくなってしまうという点にあると思います。GitHub wiki ではディレクトリ構造を持てないので、全ての情報がリンクを経由してアクセスされることになり、段々と整理がつかなくなってしまいます。 複数のリポジトリにそれぞれ wiki を書くこともできます

Jira SoftwareやTrelloなどを中心としたPMが経験してきたプロダクト管理ツールの失敗や改善を語る「本当に使いこなせてる？プロダクト管理ツールの失敗&改善PMトーク【開発PM勉強会 vol.20】」。ここで株式会社ビズリーチの菊池氏が登壇。ドキュメント管理とプロダクトバックログの失敗から学ぶツール運用のコツについて紹介します。 菊池氏の自己紹介菊池信太郎氏（以下、菊池）：ビズリーチの菊池から、10分枠で話をします。今日のテーマは「失敗から学ぶドキュメントとチケット運用のコツ」ということで、今まで経験したところで「こういうアンチパターンがあったよ」「こういう改善をしたよ」というようなところをお話しできればと思っています。 自己紹介を軽くすると、（私は）2018年からビズリーチで働いています。ビズリーチサービスを作っていて、プラットフォーム開発部の部長をしています。また、2019

Wiki.jsはNode.jsベースのWikiシステムです。モダンな作りとスタイリッシュなデザインで、「⁠とりあえずWikiだけあれば良い」という用途には最善な選択肢のひとつでしょう。今回はそんなWiki.jsをUbuntuにデプロイしてみます。 あなたのWikiはどこから？ 一般的に「Wiki（ウィキ⁠）⁠」と言えば「Wikipedia」を暗黙的に意味することが多い昨今の状況ですが、本連載の読者ならおそらく誰でもご存知のように、現在ではウィキソフトウェアで動いている、ウェブブラウザーで複数のユーザーが共同で編集可能なコンテンツ管理システムの総称です。 生のHTMLを書くのに疲れた人にとって、Wikiの「人に優しいマークアップ言語[1]⁠」は魅力的に映り、現在では非常に多くの環境で様々なWikiが活用されています。その最も成功した例が、Wikipediaを支えているMediaWikiでしょ

ドキュメント文化は健全な組織のスケールのために必要　組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明がいらないから、メンバーの数が増えた時でもスケールしやすくなる。過去の結論にアクセス可能になるので、議論を積み上げていき、意思決定のクオリティを高めることにもつながる。そもそも何かを読むということは何かを聞いて教わるよりも時間あたりの処理量が多いし、非同期に実施できる。良いドキュメントをアセットとして社内に蓄積していくことはスタートアップのみならず、ありとあらゆる組織が成長していく上でとても重要であると言える。 しかしその一方で、良質なドキュメント文化を徹底できている会社は多くないように見える。例えば、社内のドキュメントを蓄積させていく場所とし

社内のノウハウ蓄積やソフトウェアの説明書としてWikiを導入する場合、Confluenceなどの有料サービスが第一候補としてあげられますが、決して安くはないライセンス料金を支払う必要があります。無料で利用できるオープンソースソフトウェア「Wiki.js」は、Dockerで手軽に構築でき、権限管理や外部サービスの連携も可能な、無料とは思えないほど多機能なWikiシステムです。 Wiki.js https://wiki.js.org/ Wiki.jsはDockerイメージが公開されているので、今回はLinux上のDockerでWiki.jsを構築してみます。まずは下記コマンドを実行してDockerとDocker Composeを導入。 curl -fsSL get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo curl -L "h

最近の開発者が最も好むドキュメント形式を挙げるとしたら断然マークダウンになるでしょう。マークダウンは、GitHub、GitLab、Bitbucketなど、タスクやイシュー管理に対応するほとんどのサービスにおいて、基本のドキュメント形式として使用されています。また、IntelliJ、VSCode、Vim、Emacsなど、ほぼすべてのテキスト編集ツールでも、プラグインを通じてマークダウン文書の強調構文やプレビュー機能を使用することができます。 TOAST UI Editorはここからさらに一歩進んで、マークダウンエディターとウィジウィグエディターを統合した形式のインターフェースを提供しています。ウィジウィグエディターを使用すると、テーブルなどの複雑な文法をより直感的に簡単に編集することができ、マークダウンに慣れていないユーザーでもマークダウン基盤の文書を簡単に編集できます。特に、開発者と非開発

みなさんの職場では、社内wikiやドキュメントツールは何を使用されていますでしょうか。 Crowi esa Kibela Qiita:Team などMarkdownで書けてコラボレーションが可能なツールが出てきていますが、 その中でも昔から根強い人気を誇るのがAtlassian製のConfluenceです。 日本語検索が貧弱だったり、ドキュメント自体がプラグインを入れないと暗号化できなかったりといろいろつらかったりしますが、 非エンジニアでも使える、マクロが豊富であるなどがあり選択されているところも多いかと思います。 しかし、そのマクロも有料版になると課金がユーザー数分跳ね上がり経費が多くかかることもあります。 今回はちょっとしたプラグインであれば、お金をかけずに拡張できるユーザーマクロを実例と交えて紹介していきます。 ユーザーマクロとは ユーザーマクロを作成する方法 Macro Body

最近、職場で Wiki について話していて、Wiki のページの作り方は2通りあるよね、って話になりました。 ページ本文のなかに [[タイトル]] と書いて保存し、あとからそのリンクを踏んで「タイトル」ページの作成画面を表示する いきなりページの新規作成画面を開いて、タイトルを記入する 僕はだいたい1番で作る方なんですが、毎回2番で作る、という人もいました。 そんなことがあって「僕の Wiki の使い方は普通じゃなかったのかな？」と思って調べてみたら、最近の Wiki の一部（Qiita:Team や esa.io）は 1番のようなページの作り方ができない んですね。 そうなのか！これは面白い！と思って、Wiki の歴史を遡って色々調べてみました。今回はそんなネタです。 Wiki ソフトウェアそれぞれのリンク記法 まず、Wiki の機能を持つソフトウェア（以下、Wiki ソフトウェア）につ

この記事は Attlassian (JIRA, Confluence, Trello, Bitbucket) の Tips Advent Calendar 2017 の 23 日目の記事になります。 メディアマックスジャパン株式会社では JIRA, Confluence, Bitbucket をサーバー版で運用しています。今日は Confluence でエンジニア受けしやすいオススメアドオンを紹介しようと思います。 エンジニア受けしやすいってどういうこと？ Advent Calendar 経由で読んでいただいている方には当たり前だと思いますが Confluence はとても強力なドキュメント管理システムです。非エンジニアでもわかりやすい wysiwyg エディタや階層化機能、権限管理、多機能なマクロ、アドオンによる機能拡張など、プロジェクトで情報を共有する上で必要な機能は十分過ぎるぐらいに

🚨 CẢNH BÁO TỐI ĐA: Để đảm bảo an toàn, chỉ vào geechs-magazine.com – Địa chỉ CHÍNH THỨC của DA88! ❌ Truy cập nhầm link giả mạo có thể khiến bạn trở thành nạn nhân của lừa đảo. Hãy cẩn thận – Bảo vệ tài sản và thông tin cá nhân của bạn ngay hôm nay! geechs-magazine.com là ĐẠI LÝ DUY NHẤT của DA88 ⚠️‼️ Những Tên Miền Khác Đều Là GIẢ MẠO 👉 NÓNG | Xuống Chân Trang Để Nhận Code Khuyến Mãi 👈 🎉 DA88

FiNCのエンジニアの人数も50人を超え、チームを横断した情報共有の機運が高まっています。 もともと社内には情報共有ツールとしてConfluenceやGitHub Wikiなどがありましたが、前者はMarkdownなどのエンジニアがドキュメントを書きやすい機能が不足しており、後者は情報の検索性に難がありました。 エンジニアのコミュニケーションを活性化させるため、カジュアルに記事を投稿できて誰でも見ることができる、新しい情報共有ツールを導入をすることにしました。 今回は候補として検討した際に、以下の要件を満たしていた情報共有ツールを紹介します。 Markdownを使ってプレーンテキストで記述できる記事の更新履歴のdiffを見ることができるフィードで記事の一覧を見ることができるわかりやすい検索機能コメント欄でのやりとりができるWebhook(チャットツール連携)UML記法やスライドの埋め込みの

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? ※この記事は僕のブログ（最近始めました）のクローン記事です。 なんとなく、グループ内部用のWikiに最適なやつって無いのかなあと思ったのです。特にどのグループというわけじゃありませんが、ええ、なんとなく。 サーバー設置型のWikiソフトウェアというと国内で有名なのはPukiWikiでしょうか。設置も手軽で拡張性も高く、すでに慣れ親しんだWikiですが、最近では各方面がMarkdownを採用してそれに慣れ親しんでしまい、このブログもプラグインを入れてMarkdownで書いているぐらいなので、Markdownで書けるWikiを探していたので

最近はどこもかしこもMarkdownの活用で争っているように見えます。それだけ汎用的に使えて利便性の高いフォーマットであると言うことでしょう。ということで今回もまたMarkdownの新しい使い道を探す旅です。 MDwikiはMarkdownをベースにしたCMSまたはWikiとなっています。JavaScriptでMarkdownファイルを読み込み、JavaScriptでレンダリングしている点がユニークな点です。 HTMLが出力されていますが実際に読み込まれているのはMarkdownです。 画像は表示されている件数によって並びが変わるようになっています。 テーブル表示にも対応しています。 その他Gimmicksという記法が追加されており、YouTubeやGistの埋め込み、Facebook/Discusといったコミュニケーション機能も追加できるようになっています。Wikiとして新しいページが追

『「Github」のアカウントは登録するけど「Github」にはちっとも触らない』ちょっとおバカなGithub「超『超』入門」 いまさらだけどGithubなにそれおいしいの？ 先日のWP-D主催のMeganeFesでは煙草係でしたショートホープです。 巷で耳にすることが非常に多くなった「Git」と「Github」。まだ使っていないけれど気になる、という方は多いのではないだろうか。あるいは「アカウントを作ったけどそれっきり…」という人もいるだろう。 僕らWP-E（仮 内でもWP-Dのこんな記事をきっかけに『「Git」「Github」の入門から実際までやってみたい！』という声が多くあがっている。かく言う自分自身も勉強の途中で止まったまま…orz 更にこの記事を読むに至って俄然やる気になってきた。是非この後に連載予定の記事を楽しみにして欲しい（と丸投げ ところで、釣りっぽいタイトル通り『「Git

重要なニュースと情報を明らかにすることを目的とし、ジュリアン・アサンジ氏によって「ジャーナリズムの新しいモデル」として2007年に設立された「Wikileaks(ウィキリークス)」、その威力は奇しくもインターネットの持つ力を世界中の人々に再認識させたと言っても過言ではなく、主に国家権力や巨大企業が抱える秘密を暴露することで世界のルールを一変させようとしています。 我々日本人にとって、ちょうど尖閣諸島沖での中国漁船衝突問題のオリジナル映像がYouTubeに公開され、インターネットの力が既存の新聞やテレビといった旧来メディアを時として上回ることを認識したことよりもさらに上回るレベルでWikileaksは全世界に対し、「インターネットは国家権力すら揺るがすパワーを秘めている」ことを証明してしまいました。 そこで疑問となってくるのが、そもそもなぜWikileaksは世界中の国家権力を敵に回そうとし