質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
慣れてきたらチャレンジしてみよう！BigQueryのパフォーマンス最適化 - ABEJA Tech Blog
自己紹介 I/Oや通信的観点 分割されたクエリを取り除く 過剰なワイルドカード テーブルを避ける テーブルを日付別にシャーディングすることを避ける & テーブルの過度な分割を回避する JOIN を使用する前にデータを削減する コンピューティング的観点 結合パターンを最適化する 結合で INT64 データ型を使用して費用を削減し、比較パフォーマンスを向上させる 同じ共通テーブル式（CTE）を複数回評価するのを避ける クエリのアンチパターン 自己結合 データスキュー 公式にはない項目ですが個人的に気になったので 単一行を更新または挿入する DML ステートメント 非正規化の検討 ネストされて繰り返されているフィールドを使用する 採用情報 自己紹介 こんにちは、真壁（@Takayoshi_ma）です。先日読んだGoogle Cloudの公式ドキュメントが個人的に勉強になったので内容についてまとめ
お悩みハンドブック
一人ひとりの悩みごとに合わせて適切な支援を案内するサービスです。あてはまる悩みにチェックをつけていくだけで200種類を超える公的支援を中心とした解決手段から利用できる可能性のある支援を提案します。
サイゼリヤの完全攻略マニュアル｜マッシ｜エッセイスト&通訳
更新日:2022.10.19 全アレンジ12件以上、目次の追加 120万PV達成！ 更新日:2022.01.02 記事更新とアレンジ追加 更新日:2021.07.20 8月11日にサイゼリヤとの公式トーク 2021.06.02 本記事を公開 皆様へ愛を込めて感謝のメッセージ このマニュアルをたくさんの人に読んでいただいただけではなく、実際にサイゼリヤに行って試して喜んでもらえるなんて思っていなかったからとても嬉しい。ツイッターでたくさんのリプとDMをいただき、サイゼリヤで声をかけてくれたり、フォロワーと一緒に食べたり、サイゼリヤのスタッフまで嬉しそうに声をかけてくれたりして、僕にとってファミリーが増えたような温かい気持ちになった。このマニュアルがきっかけでnoteの方たちも喜んでくれてサイゼリヤとの公式トークまで企画してくれた。感謝してもしきれない。これからも新しいアレンジを紹介したいと思
note版 突然画力が伸びだした時、僕が発見した事｜安倍吉俊
これは、僕のYouTube動画の台本です。台本、というと、これを朗読しているみたいですが、これをこのまま読み上げているわけではなく、話す内容を整理したり、それを頭に入れるために、まずこのくらい書かないといけないので、コツコツと文字を打って、何度も読み返して、それから話すようにしています。 普段はもう少しメモ書きに近いのですが、今回はしっかり書いたので、noteに置いてみます。 動画はこちらです。あっ、台本の時とタイトル違う……。 これは、僕の予備校時代のある気づきに関する話です。漫画やイラストではなく、鉛筆の石膏デッサンの話ですが、イラストでもこの考え方はそのまま使えます。 絵は基本的には手を動かさないと上手くなりません。でも、ただ枚数をこなしても、上手くなるとは限りません。予備校時代、何年も浪人していて、でもあるレベルで止まってしまう人もいたし、現役生でスイスイと上達していく人もいました
セキュアにGoを書くための「ガードレール」を置こう - 安全なGoプロダクト開発に向けた持続可能なアプローチ - Flatt Security Blog
The Go gopher was designed by Renee French. (http://reneefrench.blogspot.com/) The design is licensed under the Creative Commons 3.0 Attributions license. 種々の linter が様々なプロダクトの品質を高めてきた、というのは疑う余地のない事実です。実装の初歩的な問題をエディタ内や CI/CD パイプライン中で機械的に検出できる環境を作れば、開発者はコーディングやコードレビューの邪魔になる些末な問題を早期に頭から追い出し、本質的な問題に集中できます。 また、そのような環境づくり（e.g. linter のルールセットの定義、組織独自のルールの作成、…）は、まさに開発組織のベースラインを定義する作業として捉えることができます。一度誰かが定義
美容内服薬ラボットメディカルクリニック【公式】
オンライン診療とは、自宅にいながら医師に直接毎日のスキンケアを相談したり、医薬品や漢方薬の処方を受けることができたりする診察のこと。お薬が処方された場合は郵送で薬局等にお薬を取りにいかなくても、自宅に届けられます。 普段、病院では発生する診察費用や処方箋費用はもちろん、お薬代以外の費用は一切かかりません。
22 SSH Examples, Practical Tips & Tunnels | HackerTarget.com
Practical SSH examples to take your remote system admin game to the next level. Commands and tips to not only use SSH but master ways to move around the network. Knowing a few ssh tricks will benefit any system administrator, network engineer or security professional. Even if you are an experienced *nix guru there are a couple of examples further down that are only available in later versions of O
Goでproxy serverを作るときにハマるポイント | メルカリエンジニアリング
Mercari Advent Calendar 2018 の5日目はSREチームの @catatsuy がお送りします。 メルカリではGoで書かれたproxy serverをサービスの各所で使っています。今回はGoでproxy serverを作るときにハマりそうな、標準ライブラリの挙動や特徴について紹介します。 本エントリーは2018/12/04現在の最新であるGo 1.11.2を元にして書きます。 Hostヘッダーはreq.Header.Set(“Host”, “example.com”)しても上書きできない https://github.com/golang/go/blob/e8a95aeb75536496432bcace1fb2bbfa449bf0fa/src/net/http/request.go#L1023 https://github.com/golang/go/blob/e8
自分用Google Cloud コマンドリファレンス(分析系) - Qiita
$ gcloud auth activate-service-account \ <service account 名>@<project-name>.iam.gserviceaccount.com \ --key-file <IAM画面で発行したキーjsonファイル> \ --project <<project-name>>
（翻訳）Apache Arrowと「pandasの10項目の課題」 - Qiita
始めに：pandasの作者であるWes McKinneyさんがPythonのデータツール関連でとても興味深いblogを書かれているので、翻訳して日本のPyDataコミュニティに公開してもいいでしょうか、とお聞きしたところ、快諾をいただきましたので少しずつ訳して公開していこうと思っています。 2017/9/21（木） Apache Arrow、pandas、pandas2、そして最近の私の作業の大まかな方向性と視界が開けてきている未来に関して、これから一連のポストを書いていきます。このポストはその第一弾です。少々量があり、全体に技術的な色合いが濃くなっていますが、興味を持たれたなら読み進めていってください。 このポストでは、pandasの内部構造に関する主要な問題のいくつかと、それらに対して私が着実に進めてきた現実的な解決策の計画と構築について、できる限り簡潔に説明しようと思います。外から見
あっと驚かせるJavaプログラミング(をやめよう） - Qiita
はじめに 驚き最小の原則（法則）という言葉があります。 Wikipediaの記事を引用すると http://ja.wikipedia.org/wiki/%E9%A9%9A%E3%81%8D%E6%9C%80%E5%B0%8F%E3%81%AE%E5%8E%9F%E5%89%87 ユーザインタフェースやプログラミング言語の設計および人間工学において、インタフェースの2つの要素が互いに矛盾あるいは不明瞭だったときに、その動作としては人間のユーザやプログラマが最も自然に思える（驚きが少ない）ものを選択すべきだとする考え方である。 要するに、使うときに「おやっ？」という驚きが少ないほうが良いプログラムであるといえます1。 この記事では敢えて驚きの多いプログラムの書き方を紹介します。驚きの多いプログラムを読むとどんな気分になるか、実際に体験してみてください。もちろん、本当は驚きが少ないプログラムを書
Pandasの辞書的使い方 - 西尾泰和のScrapbox
PandasでNameとValueというカラムのあるCSVを読み込んで、「Nameが特定の値の時のValueを知りたい」という場合。なおNameは一意だとする。
なぜあなたのPull Requestは読まれないのか - Qiita
Pull Requestを出してレビューしてもらってから反映。 どこにでもあるありふれた開発フローに付きまとう、どこにでもあるありふれた問題。 「Pull Requestがレビューされない」 もちろん開発フローにレビューが含まれている以上、レビューをしないメンバーにも非がないとは言えませんが、多くの場合はレビューされないPRには問題があるものです。 デカい 兎にも角にもデカいPRは読むのがつらいです。 もちろん要件が明記されていないなど、他にもPRが読みにくくなる原因はたくさんありますが、一番はこれです。 極端な話、1行変更のPRは他に何も書かれていなくても実装内容を察することができますが、10ファイル100行の差分と箇条書き20点の要件が書かれたPRは内容を把握するだけで一苦労です。 しかし、このこと自体は数カ月でもコードを書いていれば自然と勘づくもの。 問題はなぜPRが大きくなってしま
40歳以上で無名でダメなエンジニア（元エンジニア）が勉強会で登壇するときの注意：：村上福之の「ネットとケータイと俺様」：オルタナティブ・ブログ
イベントや勉強会とか出ると、40代、50代、60代の人が発表することもありますね。有名サービスを作った若いエンジニアとかだったり、発表内容がトレンドだったりすると、すごい話を聞きたくなるけど、たいして有名でもないし、すごいものを作ったこともない、俺みたいに無駄に年を重ねた人のトレンドからはずれたダメダメオッサンの登壇内容ってクソいんですよ。自戒の念を込めて書く。 最初の自己紹介30秒以下にしろよ： おまえがちょまどみたいに若くてキレイでかわいい女子だったら何時間でも聴きたいけど、ダメなオッサンのつまんない自己紹介は5秒以上も聞きたくない。無駄に長いこと生きている人の長い自己紹介ってつまんない。「89年に大手SIの子会社に入社」とか聞きたくない。もうねダメなオッサンは「idと好きなAWSサービス」だけでいいよ。長いこと生きてるからいろいろ言いたいことがあるだろうけど、いらない。無名無能力な4
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
自由研究で作った「食材保存方法早見表」が超有用！全国のご家庭の冷蔵庫に貼られてほしい便利さ
こういう発想ができる人を天才という19の事例
pandasでよく使う文法まとめ - Qiita
BigQueryの課金、節約しませんか
Mac に SentencePiece をインストール - Qiita
