プロダクトのドキュメントにプルリクエストを送れる仕組みがすごい - Qiita

これ↓なんですけど、意外と RT や Like が付いてたので、ちゃんと書きますね。 しっかしMicrosoftのドキュメントシステム良く出来てるなー。右のEditボタン押すとGitHubが開いてすぐPR送れる。あちらでマージされれば即サイトに反映される。Contiributorsに自分のアイコンが増えた♪ これはフィードバックするのに「面倒」は理由にできないですぞ。https://t.co/9KhAwhV5PP pic.twitter.com/r46zFUvkEp — あめいぱわーにおまかせろ! (@amay077) 2018年6月12日 このツイは Microsoft の製品やサービスのドキュメントについてなんですが、 Microsoft Docs というポータルがありまして、同社のサービスの多くはここでドキュメント公開されている模様です。 ここで公開されているドキュメント群は、バック

[megazalrock]

wikiって意外とドキュメント書いたり、ましてや議論するのには全く向いてないからいい方法だなぁ。というかこれソリューションとして一定の需要ありそうだな。／すでにあった。id:eller さんの情報感謝。

[eller]

https://readthedocs.org とか https://www.gitbook.com とか使えば気軽に実現できます。アイコンはないけど。

[gfx]

elasticsearchのdocも同様で、すぐマージされたし体験良かった。

[indication]

MDNも忘れないで！MDNは2006年以前からその仕組みがある。MSのこの改善は素晴らしい。もっと早くに欲しかった。

[dh16t]

ドキュメントは開発するものだからこうでないとね。本質である中身のブラッシュアップに集中できる仕組みが大事。

[cpw]

これいいな。wikiとかだと誰のレビューも受けずに変更されちゃうから怖いというところのケアもできる。素晴らしいな。

[Kil]

自分のアイコンがつくあたりが自己満足感満たされて良いなぁ。

[akulog]

素晴らしい（Word滅びろ

[maguro1111]

法律もこうしよう

[tkmoteki]

この仕組みいいなぁ。真似したい。 プロダクトのドキュメントにプルリクエストを送れる仕組みがすごい

[akiramaz]

これはよい

[luccafort]

いい話なんだけどはてなという会社が公開しているJavaScriptの教科書のサンプルコードにミスを見つけたときにマージされて嬉しかった記憶があるのでこういう凡ミスでも貢献できるという体験は大事。

[braitom]

Microsoft Docsのドキュメント修正のしくみについて。GitHubと連動していて間違いなどに気づいたら簡単にPRできる。

[hogeai]

社内のレビューこれにしたい

[shoutatani]

息抜きにドキュメント日本語化のPRしてみるか

[Wacky]

“誰でもすぐにドキュメント修正が行える仕組み、よくできてるなあ、と感動しました2。 やりたい／やってほしい事が抵抗なくできるシステム、理想的なんじゃあないでしょうか。”

[tick2tack]

GitBookは大学の先生がよく使ってる印象ある。

[bb_river]

機械翻訳の指摘はキリがないな

[tenkoma]

自動化は結構見かけるけど、元ドキュメント Contributors に表示されるのは初めて見た

[t2y-1979]

企業が扱っているプロダクトのドキュメントソースも公開してみんなで直すという oss 文化の躍進がすごい

[mirucons]

Gitbookとかで簡単にできるし、今までもこういうDocsサイト結構あったと思ってたんだけど、まだこれが「すごい」となるような浸透度しかないのか。

[lbtmplz]

普通にさいこうではないか

[hitsujiniku-sugita]

すげーなこれ

[gla69]

ほうほう

[snicmakino]

ドキュメントは全部この方法で管理したい。このドキュメントのポータルをさくっと立てる方法あるんかな？Excelとか使ってる場合じゃないでしょ。

[Cherenkov]

pull request

[hogege]

φ(..)ﾒﾓﾒﾓ

[digital-twins-papa]

会社の営業資料とか、あらゆるドキュメントで応用したい仕組み。

[htnmiki]

会社のドキュメントもこれにしたい

[TakamoriTarou]

ここまで使ってたら、妙なところに買収される前に自社で捕まえておこう、って選択肢になるわなあ。

[mumumu-tan]

PHP Manual でもこうできたらええなぁ、というか PhD ハックすれば難しくないや、と思うけど、公式リポジトリがまだsvnだから、こういう仕組みを入れてもどうしても野良になっちゃうのよね...

[otihateten3510]

ドキュメント修正におけるプルリクという手は有りだよね。チーム内ドキュメントで一番効力を発揮すると思うが、最適なプラットフォームが未だに無い。

[kanu-orz]

この仕組みいいなぁ、ローカルでも使いたいなぁ

[tripleflat]

これイントラドキュメントの管理方法にしたらめちゃくちゃ便利そう。

[pinzolo]

Github Pages にこの機能が付くと多くの人が幸せになるであろう。MS様お願いします

[ms2sato]

時間できたら作りたいからメモっとく。このやり方素敵。