さらばGoogleDocs、ドキュメントをWebマニュアルに移行したおはなし(ShanonAdventCalendar2017・3日目)
Docker gitbook kzhirata さらばGoogleDocs、ドキュメントをWebマニュアルに移行したおはなし(ShanonAdventCalendar2017・3日目) こちらの記事から2年半。今年は、仕事でdockerばかり使ってました。 docker使うと、デプロイ方法の細かいところをインフラ担当者と話す手間がなくなるからお互い嬉しいですね。 今回は、なるべく手をかけずにWEBのマニュアル smpdoc.shanon.co.jp を構築した話を書きます。 今までは、google docsに書いたマニュアルをPDF化してサポート担当者に連絡してサポートサイトに公開していました。この作業が非生産的で改善したいけど、社内でプロジェクト化するには、優先順位の低い課題でした。 いかに手をかけずにWEB化するか。出来る限りOSSを使って維持管理を楽にするというポリシーで設計しました
The NEXT of REST - onk.ninja
The NEXT of REST 前後リンク RESTful API のおさらい Rails での JSON API 実装まとめ スキーマファースト開発 The NEXT of REST REST で解決していない問題 REST っていうのは本当に難しくて、 開発者のお気持ちで API が異なる 指針であって仕様じゃないのが理由 POST がワイルドカードとして使われるとか クライアントとサーバ間のまだある精神的な溝 API はサーバが作るもので、クライアントは手出ししづらいという意識 REST だとクライアントごとに最適化した API を作りづらい Web とスマホで同じ API を使うときに不要なレスポンスがある 提供されている API が不十分なときにクライアント側で JOIN するハメに のような問題を抱えています。 これかを解決するために、API Query Language (
開発現場に根強く残る8個のバグレポートアンチパターン - Qiita
ex-mixi Advent Calendar 2017 - Qiita 9日目をいただいた @kkakizaki です。 株式会社ミクシィの在籍期間は2008年から2016年までで、 QAマネージャーとして、次々に巻き起こる品質保証上の課題を何とかするお仕事をしていました。 現在は株式会社サイバードにて、同じく品質保証部門の長として、 品質保証だけではない様々な課題解決に勤しんでおります。 折角の ex-mixi なので、今回は この記事 の続きです。 前回の記事は2012年に書かれたものですが、 現在も繊細なエンジニア達が死にやすい状況に変わりはなく、 影響の大きな死因の1つとして「イケてないバグレポート」が存在しています。 BTS にイケてないバグレポートが増殖してしまう現場の方は、 この記事をテスターに叩きつけてやってください。 アンチパターンその1：敬語 テスト業務が受発注関係で
現場で役立つシステム設計の原則にあるUMLをPlantUMLで書いてみる - Qiita
フューチャーアーキテクト Advent Calendar 2017の2日目です。 はじめに システム設計が大好きで大嫌いな皆さん、こんにちは。 突然ですが、皆さんはどのようにシステム設計における ドキュメント腐る問題 に立ち向かっていますか？ ドキュメント腐る問題とは、設計時に作成した各種ドキュメントがGoogle Driveやファイルサーバ上で陳腐化してしまい、現状の正しい状態を指していないことです。せっかく新規参画者がキャッチアップしようとしてもドキュメントが真実を示していないという怖いやつですよね。 解決策としては、各種ドキュメントを、MarkdownやAsciiDoc、UMLはPlantUMLやmermaid、ERDはPlantUMLやerd、画面遷移図はUI Flow、REST-API設計はSwaggerなど、なるべくテキストベースで管理し、GitHubなどのリポジトリで管理する
2万5000円のスティック掃除機で毎日の掃除が楽しくなる！
2009年に創刊したテストする広告なしのモノ批評雑誌 & おすすめ情報メディア。生活用品や家具、ガジェットに加え、メンズコスメなども実際に比較検証してレビュー。 すべて実際に使用して検証しています 商品のテストについては 「LAB.360について」をご確認ください。 ※「商品の比較検証結果」は監修者と共に実際に使用して評価しています。「選び方」など、その他の部分については、監修者または編集部の知見をもとにまとめたものです。
ソニーのMESH™が、Raspberry Piに対応したMESHハブアプリケーションを配布開始。IoTがもっと身近に。
ソニー株式会社（以下、ソニー）のMESHプロジェクト（https://meshprj.com）は、Raspberry Pi向けMESHハブアプリケーション（以降、MESHハブアプリ）をMESH公式サイト（https://meshprj.com）上で配信開始いたしました。 本アプリケーションをRaspberry Piにインストールすることで、MESHアプリで作成したIoTの仕組みを、スマホやタブレットが近くになくても常時動作させることが可能になります。 ■MESHについて MESHはソニーの新規事業創出プログラム（Seed Acceleration Program）から生まれた新規事業のひとつです。無線でつながるハードウェア・ブロックと専用アプリ内のソフトウェア・ブロックを組み合わせていくだけで、「あったらいいな」と思うIoTの仕組みをつくれる、ユニークなプラットフォームです。難しい電子工作
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
