チームに無能がいなくなる『メンバー全員で公式ドキュメントを読みあわせる』に感銘をうけた話。 - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? これは、同じエンジニアである妻から聞いた話なのですが、彼女の案件で「メンバー全員で公式ドキュメントを読みあわせる」という取り組みがあったそうです。 で、この方法「チーム全体にとって大きなメリットがあるんじゃないか？」と思ったので、共有させていただきます。 「誰も知らない」から「みんな知ってる」に 私は開発職なので、めずらしいことなのかそうではないのか判断がつかないのですが、その案件では、導入対象の製品について詳しい知識を持っているメンバーが一人もいなかったというのです。 誰もその製品をさわったことがなく、とりあえず強そうなメンバーを入れ
esaからconfluenceへの移行 - Qiita
ドキュメント管理ツールのesaをチームでトライアルで使ってみたのですが、「やはりconfluenceを使いたい」という声が挙がったため、移行のスクリプトを書いてみました。 シンプルなスクリプトですが、confluenceのドキュメントを読むのに多少時間がかかったので、共有します。 個人的にはesaだったのですが残念……………。 前準備 esaからデータをエクスポートする。markdown形式でzipでダウンロードできます。 attlasianのAPI KEYを取得する REST APIについてはこちらをご覧ください。 https://developer.atlassian.com/cloud/confluence/basic-auth-for-rest-apis/ script 以下を実行します。コメントやタグなどの情報については移行していません。 名前空間をちゃんと移行したい場合は CA
Terraform職人入門: 日々の運用で学んだ知見を淡々とまとめる - Qiita
はじめに この記事は CrowdWorks Advent Calendar 2017 の8日目の記事です。 Terraform職人の @minamijoyo です。Infrastructure as Codeしてますか？ インフラのコード管理に Terraform を使い始めて2年ちょっと、本番環境で運用していると日々色んな学びがあるので、Terraformやってみた系の入門記事では語られない、現場の運用ノウハウ的なものを共有してみようかと思います。 Terraformを使い始めた or 使っている人が、こんなときどうするの？っていうときに参考になれば幸いです。 書き始めたら超長文になりました。概要は以下のとおりです。 公式ドキュメントを読もう tfファイルを書く技術 インデントを揃える 組み込み関数に親しむ lifecycleブロックを使う リソースの差分を無視する リソース再生成のとき
Pythonのデコレータにはwrapsをつけるべきという覚え書き - Qiita
Pythonのデコレータは最初理解するのが難しい。 そして理解したと思っていても実はベストプラクティスな実装ではないという事がしばしばある。 そんな中私が今まで知らなかった functools.wraps とは。 公式ドキュメント @functools.wraps(wrapped, assigned=WRAPPER_ASSIGNMENTS, updated=WRAPPER_UPDATES)(原文) これはラッパー関数を定義するときに update_wrapper() を関数デコレータとして呼び出す便宜関数です。 これは partial(update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated) と等価です。 def hoge_decorator(f): def hoge_wrapper(*args, **kwar
TypeScriptのドキュメントが一瞬で作れるんだ、そうTypeDocならね - Qiita
仕事でTypeScriptを書きながら「あ〜、真面目にドキュメント作るって面倒くさいよな〜」とか考えていたのですが、 そんな時に便利な素敵ツールTypeDocなるものがあったので使ってみたらとても捗りました。 TypeDocって何? TypeScriptのソースを解析してドキュメントを自動で作ってくれるツールです。まあ、jsdocのTypeScript版ですね。 jsdocより便利な点としては、アノテーションを書く必要がほぼありません。型情報とか全部ソースに書いてるんで。 jsdocのために @param {number} とか@classとかコメントで書くのダルいですよね。 人類はツールのためにコメントを書く責務から解放されつつあるのです。 使ってみた インストール TypeDocはnpmでインストールします。 npm install typedoc --save 個人的にグローバルイン
TypeScriptのコード(d.ts)からAPIドキュメントを自動生成する - Qiita
TypeScriptで書いたライブラリのAPIリファレンスをコードから生成したいときに使えるツールがなかったので、簡単な仕組みで作ってみました。 Almin.jsというJavaScriptのライブラリを書いているのですが、コードベースをTypeScriptに変更してからAPIリファレンスが自動生成できなくて困っていました。 almin/almin: Almin.js provide Flux/CQRS patterns for JavaScript application Inroducing Almin 0.10.0: TypeScript, FlowType, Logger | Web Scratch TypeScriptでJSDocやESDoc、documentationjsのようなツールとしては、typedocがあります。 しかし、typedocはdocumentationjsのよ
2018年のCommon Lispのドキュメントはここだ! - Qiita
色々ありますが、 言語仕様/マニュアル Common Lisp HyperSpec ANSI Common Lisp (Franz) Common Lisp Quick Reference Common Lispのformat関数 Common Lispマニュアルまとめ ライブラリドキュメント Quickdocs CLiki クックブック/解説 The Common Lisp Cookbook Common LISP users jp 逆引きCommon Lisp stackoverflow: common-lisp ja.stackoverflow: common-lisp コード例 Rosetta Code: Common Lisp その他参考文献 Common Lisp the Language, 2nd Edition CLtL2は古いので参考程度に こんなものでしょう。 ANSI
Ansibleのドキュメントを読んでみたメモ - Qiita
少しくらいAnsibleを使ってみようと思ってブログや公式ドキュメントを読んでみたのでメモ。 参考にした主なものは以下のリンク。 Ansibleとは？みたいないのはリンクを読むとよくわかった。 Ansibleの公式ドキュメント http://docs.ansible.com/index.html Playbookのサンプル https://github.com/ansible/ansible-examples Ansibleの概要を知るのにとてもよかった。 http://apatheia.info/blog/2013/04/06/about-ansible/ 構成 ChefとかPuppetとは違ってこちらはAnsibleから対象のサーバに接続していく感じ。 対象のサーバにはとくにエージェントとかはいらない。 インストール ほとんどパッケージ管理とかでいけるのでとても簡単。 Via Pip
twemproxy 本家ドキュメント日本語訳 - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? このドキュメントについて twemproxy (nutcracker) が一体何者であり、また、運用にあたり理解が必要であろう箇所について、本家ドキュメントを雑に意訳したものです。 仕事上のメモとして作成したのをそのまま公開するので日本語が残念なところも正直多々あるのですが、これを完成させるまで眠らせておくよりは(いつになることやら)さっさと公開して、今 twemproxy の導入を検討している方や、運用されている方の何かしらの力になればと思っています。 粗い内容ですので、何かございましたら編集リクエストを頂けると幸いです。 READM
Docker Machine ドキュメント参考日本語訳 - Qiita
Docker Machine 0.3.0 のドキュメントの参考日本語訳です。手許に翻訳したまま死蔵しておくのもアレなので、内容未保証の参考訳として公開します。 メモ：Machine は原点ではベータ版のため、ここにある記述は変わる場合があります。本番環境（プロダクション）での利用は推奨しません。 Docker Machine は自分のコンピュータ上やクラウド・プロバイダ上や自身のデータセンタ内で Docker ホストを作成します。サーバを作成し、Docker をインストールしたあと、Docker クライアントが通信できるように設定します。 Docker ホストを作成後は、管理用の多くのコマンドが使えるようになります： 起動、停止、再起動 Docker のアップグレード Docker クライアントとホストが通信できる設定 ヘルプを得るには Docker Machine は未だ初期段階であり活
Riot.js ドキュメント日本語版 - Qiita
このドキュメントは、Riotの公式ドキュメントのWhy Riot?とRiot developer guideの全訳です。修正あれば、こちらにプルリクエストください 追記・公式に取り込みました! 記事はこのまま置いておきますが、最新版は公式サイトを参照してください。 公式ドキュメント: http://riotjs.com/ja/ なぜ Riot? 答え1: カスタムタグ RiotはIE8以降の全てのブラウザで、カスタムタグを実現します。 <todo> <!-- layout --> <h3>{ opts.title }</h3> <ul> <li each={ item, i in items }>{ item }</li> </ul> <form onsubmit={ add }> <input> <button>Add #{ items.length + 1 }</button> </f
swagger-expressを使って簡単にAPIドキュメントを作成する - Qiita
APIドキュメントツールにswaggerというものがあります。 公式のデモ ドキュメントに記載したAPIの一覧を表示し パラメータなどを直接入力してその場で試せるというものです。 facebookのGraph API Explorerや twitterの https://dev.twitter.com/console と同じような位置づけです。 すべて設定するととても便利なのですが、 ドキュメント元となるJSONの作成が必要であったり、 使いこなすのが結構大変だったりします。 ただswagger-expressを使うと 出来るだけ簡単にドキュメント化することができます。 swaggerの構成 ブラウザでの表示のためのindex.htmlやjs,css,imgなどがある、swagger-ui APIの情報がまとめられている 設置の仕方 expressを使ったアプリ sampleApp 上で、
LevelDBの設計ドキュメント和訳 - Qiita
Cassandraのストレージには、SizedTierCompactionと、Google LevelDBをもとにしたLeveledCompactionという二つのコンパクション戦略が存在し、ワークロードによって開発者が自由に選択できるようになっています。しかしLeveledCompactionの具体的な挙動がいまひとつ、よく分からず、選択の決め手に欠ける状態でした。 そこで、オリジナルであるLevelDBの実装を調べてみることにしました。インターネット上にLevelDBの解説は多いですが、具体的にどのようなファイルI/Oが発行されているのかはっきりしなかったので、LevelDB開発者向けドキュメントを和訳しました。結果、よく出来てるなーという事がわかったので安心してLeveledCompactionを使おうと思います。 参考 - LevelDB入門 (基本編) - from scratc
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
[Solr]全てのドキュメントをインデックスから削除する - Qiita![[Solr]全てのドキュメントをインデックスから削除する - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/b0a4e0d39961f3728d07079b9b077fe92890750e/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9JTVCU29sciU1RCVFNSU4NSVBOCVFMyU4MSVBNiVFMyU4MSVBRSVFMyU4MyU4OSVFMyU4MiVBRCVFMyU4MyVBNSVFMyU4MyVBMSVFMyU4MyVCMyVFMyU4MyU4OCVFMyU4MiU5MiVFMyU4MiVBNCVFMyU4MyVCMyVFMyU4MyU4NyVFMyU4MyU4MyVFMyU4MiVBRiVFMyU4MiVCOSVFMyU4MSU4QiVFMyU4MiU4OSVFNSU4OSU4QSVFOSU5OSVBNCVFMyU4MSU5OSVFMyU4MiU4QiZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZ0eHQtY29sb3I9JTIzMUUyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTU2JnM9MDI0YTFmYjhlOTE2YTZhZTg0MGY1YWNiY2U1YzA3ZmI%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBzYWJhMTAyNCZ0eHQtY29sb3I9JTIzMUUyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9Y2NjMjk4YmE4ZmNiMDEyMmFiZjQ3MzZiNTVkNDBmNTk%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3D047c2972936aa156fba4e780f09a4023)