ソースコードの可読性を上げるためのTips - Qiita
仕事でもオープンソースで活動する際も、可読性の高いコードを書くというのは非常に重要なポイントです。 ただ、「可読性」という言葉がとてもあいまいであるのもまた事実。 可読性を上げろ、という号令は売上を上げろ並みに漠然としていますし、またその結果として「俺にとってはわかりやすいコード」が氾濫するということもままあります。 そのため、ここではまず可読性とは何ぞやということを簡単に定義し、それを実現するための方法について紹介していくという感じにしたいと思います。 可読性について 個人的に重要と感じる点は以下3点です。 一般的である 例えば、文字列を分割する処理は「Split」という名前が一般的です。そのため、これ以外の名前をつけると(BunkatsuとかDivideとか)基本可読性が下がります。 どういう名前が一般的かは言語によっても異なるため、プログラミング一般と使っている言語双方を加味して、自
Jupyter 知っておくと少し便利なTIPS集 - Qiita
今まで仕事で使ってきた、メジャーなものからマイナーなものまで含めたJupyter NotebooksのTIPS集です。 入力補完 とりあえずこれが無いと生きていけません。 Nbextensions（Jupyterの拡張機能）自体が未設定であれば、一旦そちらをインストールして、その後にHinterlandという機能にチェックを入れると有効化されます。 AnacondaのJupyter notebookでnbextensionsを使う ※Nbextensionsインストール後、Jupyterのファイルリスト的な画面で、タブで「Nbextensions」という選択肢が追加されます。 Azure Notebooksなどだと、最初からインストール不要で選択できるようになっています。 Google Colaboratoryなどでは、そういった設定ができるのかまだよくわかっていません。（ご存じの方コメン
【今日からできる】コミットメッセージに 「プレフィックス」 をつけるだけで、開発効率が上がった話 - Qiita
はじめに 今まで commit message を「なんとなく」書いていたが、プレフィックスをつけることで、コミットメッセージに対する考え方が変わった。 そのおかげで開発効率が上がったので、その内容をシェア。 プレフィックスをつけるってどういうこと？ 以下のようにコミットメッセージの先頭に、なんらかの文字をつけること。 feat: xxx という機能を追加 fix: yyy で発生するバグを修正 refactor: zzz の機能をリファクタ のように feat, fix, refactor などがプレフィックスです。 最近 OSS の Contribution Guide などでよく見かけます。 導入したプレフィックスルール Angular.js/DEVELOPERS.md Angular.js の開発者ガイドに書いてあるメッセージを参考にしました。 以前のコミットメッセージ（例 ちなみ
Emacs で時の流れを感じる - Qiita
なにをやったの ふらっと外に出てみたらちょうど空が夕焼けていて「ずいぶん日が短くなってきたなあ」とか、あるいは夜、なんとなく空を見上げてみたら綺麗な満月で「もうひと月たったか」とか、そんな、ふと時の流れを感じる瞬間が僕は好きです。 が、社会人になってから、退社したら外はもう夜、という日がほとんどになって、そんな瞬間を感じることが減ってしまったなあとふと思いました。 そんなわけで、その時刻の空の色（イメージ）、月齢、天気を反映した時計ウィジェットを作ってみました。モードラインなどに置いておくと、ふと目をやったときに、ちょっとほっこりできるかもしれません。 スクリーンショット モードラインに設置 色のサンプル インストール GitHub: https://github.com/zk-phi/sky-color-clock load-path の通ったディレクトリにダウンロード (clone)、
新人達を1ヶ月でガチvimmerにした方法 - Qiita
vim以外のエディタでコード書くと私の手は産まれたての子鹿みたいになります。 効率よくコーディングをしてもらうために、新人やvimを学びたい人にvimの研修を実施しています。今回は研修で非常に有効だった内容についてまとめておきます。 ※ なんだか誤解を生んでしまっているようなので追記しておきます。vimの研修は新人研修の一環として行ったわけではなく、vimを使って開発をしたがっていた新人へテスト駆動開発の研修を実施した際に並行して盛り込んだだけです。会社がvim強制とかではないのでご安心ください。言葉足らずで申し訳ありません。 2つの繰り返しキーの存在を認識させる vimは一度実行したコマンドの組み合わせを記憶する.(ドット)とfを使った移動の際のキーストロークを記憶しておく;(セミコロン)があります。これらを駆使することで他のエディタよりも高速な編集作業を行えます。 セミコロンはus配列
その資料ちゃんと伝わってる？ノンデザイナーに贈る、3つのポイントで格段に伝わる資料になる方法 - Qiita
みなさん、こんにちは！ エイチームライフスタイルアドベントカレンダー2017の21日目の 今日は株式会社エイチームライフスタイルのデザイナー@mgmg121が担当します。よろしくお願いいたします はじめに みなさんは業務や勉強会でスライドの資料を作成することはありますか？ 私は普段、社内で営業やエンジニアのプレゼンを聞くことが多いのですが、話すのが上手い人、言語力が優れた人が多いためか「プレゼンうまいなぁ、いいなぁ！」とよく感心します。 ただ…実は… 資料がすこーし見づらくて「もったいない…！」と思うことが多いのも事実。 さらに伝わるプレゼンにするために、資料のデザインを見直してみませんか？ 「デザインがいい資料＝伝えたいことが伝わる」ということ。 伝えたいことが伝われば、コミュニケーションが円滑になり、あなたも相手もうれしいですよね！ 今回、社内のエンジニアに資料作成で悩んでいることを聞
知って「おっ！」てなったGitHubの知識7選 - Qiita
GitHubダイスキー！ ということで、知った時に「おっ！」と感じたGitHubに関する事項を選出してみました。 あなたに「おっ！」と思ってもらえたら幸せです。 １．入れておくと、意味を持つファイル名がある。 README.md README.mdは有名ですよね。リポジトリのトップにREADME.mdという名称でマークダウンを入れておくと、GitHubで解釈されて表示されます。 それ以外にも、あるのです。意味のあるファイル。 ISSUE_TEMPLATE.md トップか、.github/というフォルダにISSUE_TEMPLATE.mdという名のファイルを入れると、GitHubでIssueを作った時にこのファイルの内容が入ります。書くべき項目を羅列しておくとルール化できていいですよね。 それ以外にも PULL_REQUEST_TEMPLATE.md を入れておくと、Pull request
macOSでディスプレイ1枚で作業する技術 - Qiita
今まで、自宅・職場では外部ディスプレイを使って作業をしてましたが最近はRoostを使い始めて、家でも外でもRoostと外部キーボード、マウスで仕事するようになりました。これで肩の痛みが激減したので下を向いて作業する時間が多いと首の筋肉に引っ張られて肩が凝るみたいですね。 ここできになるのはディスプレイ1枚だと画面切り替え大変じゃないのってところなのですが、以前 @reoring さんに教えてもらって自分にすごいフィットしたので共有しておきます。あまりmacのデスクトップについての記事がないような。 [追記2020/11/16] macOS 11.0 Big Sur(Intel) で動作確認できました。Total Spaces2をBig Surより前から使っている場合は最新版(v2.9.6~)を再インストールする必要があります。 TL;DR デスクトップを10画面作成する ショートカットキー
これまで知らなかったGit機能を調べたまとめ - Qiita
変更のdiffを見ながらコミットメッセージを書く 教えてもらってから活用してる。見ながら書いたほうが具体的に書けるような気がする。 $ git commit -v 変更のdiffを見ながらコミットメッセージを編集できます # Please enter the commit message for your changes. Lines starting # with '#' will be ignored, and an empty message aborts the commit. # On branch commit-v # You are currently bisecting, started from branch 'test-git-bisect'. # # Changes to be committed: #>modified: fruits.txt # # -------
Mac標準「プレビュー」の意外と知られていないTips - Qiita
※ "意外と知られていないか"の基準は筆者の主観です。 ※ 動作確認環境は、MacOSX Yosemite、プレビュー v8.0です。 ※ MacOSX Sierra, プレビュー v9.0で動作確認しました。 ※ mac OS Mojave, プレビュー v10.1 で動作確認しました。 更新履歴 2019/03/06 macOS Mojave 10.14.1 での動作を確認 2017/05/01 Mac OS Sierra での動作を確認 2016/10/12 7. クリップボードから開く 2016/09/27 6. 画像を回転させる 2016/09/27 5. PDFを暗号化する 2016/09/27 4. PDFのファイルサイズを圧縮する 1. インスタントアルファ😄 同じような色のエリアを選択し透過してくれる機能 これを何回かやってみると？ ポテトチップスの袋もあっという間にで
C++11スマートポインタで避けるべき過ち Top10 | POSTD
(注：2017/10/25、いただいたフィードバックを元に翻訳を修正いたしました。修正内容については、 こちら を参照ください。) 私は新しいC++11のスマートポインタをとても気に入っています。自分でメモリを管理するのが嫌だと感じる多くの仲間たちにとって、これはいろいろな面で天の助けでした。私の場合、このおかげで新人にC++を教えるのがずっと楽になりました。 しかし、C++11のスマートポインタを幅広く使っていた2年ちょっとの間で、使い方を誤ると、プログラムの効率が落ちたりクラッシュして壊れたりするという事態に何度も遭遇しました。参照用に、以下に例を載せました。 まずはこれらの”過ち”を、簡単なAircraftクラスを例に取って見てみましょう。 class Aircraft { private: string m_model; public: int m_flyCount; weak_p
コードの品質を維持したまま開発スピードを上げる | POSTD
高品質のコードベースは、反復作業やコラボレーション、メンテナンスを簡単にすることで、長期的な開発のスピードを上げてくれます。Quoraではベースコードの品質は重要だと考えます。 高品質のコードを維持することは利点がありますが、その反面かなりのオーバーヘッドが発生し、実際の開発のサイクルに時間が掛かってしまいます。このオーバーヘッドと利点の折り合いを付けるのは難しい問題です。この場合、2つの選択肢しかないように思えます。低品質でコードスピードが速いか、もしくは高品質でスピードが遅いか。スタートアップは素早い開発サイクルに最適化しているので、多くの人は低品質で進めたほうがいいと思っています。 このジレンマは解消できます。ツールやプロセスを工夫することで、コードベースの品質を維持したままスピードを速めることができるのです。この投稿では、コードの品質に関しての私たちの考えや、2つの世界を共存させる
眼鏡なしのコードレビュー | POSTD
例えば、あなたが驚くほど聡明な開発チームのメンバーで、コードレビューのみに一日の時間を確保しているとします。しかし作業を開始して2時間後、眼鏡を忘れてきてしまい、午前中はぼんやりとしたカラフルな表示を見つめていただけだったということに気づいたとします。さて、あなたはどうしますか? 家まで歩いて10分もかからないし、天気も良ければ、眼鏡を取りに帰るのが一番です。でも朝家を出るとき、攻撃的なスズメバチの群れが眼鏡の置いてある部屋に巣を作って、邪魔されたくない様子だったらどうしますか？ そういう時はもちろん、コンタクトレンズを付けてきたふりをして、恥ずかしい思いをしないようにするのがよいでしょう。実際に読むことなく膨大な量のファイルを見分けることができるということを覚えておいて下さい。 参考コード 1 不安の種は隔離するべきだということに誰も異論はないでしょう。そしてもちろん、あらゆるクラスは一
[Agile]スプリントのタスクに関するTips29個 | Ryuzee.com
みなさんこんにちは。@ryuzeeです。 Scrum CrazyというサイトでスプリントのタスクについてたくさんのTipsがまとめられているのでご紹介します。 Sprint Tasking Tips ここではTipsのタイトルだけ紹介しておきますので、詳しくは上記サイトを参照してください。 Scrum Crazyでは他にも色々なTipsがあるので是非見ておくと良いと思います。 正直に見積もり、見積りが正確であることに価値をおく環境を作ることタスクを見積もる際は時間で見積もることを強く推奨実時間ではなく理想時間を使うことが望ましいより粒度を小さくしたタスクにすることを強く推奨1日は5〜6理想時間とすること作業量を見積もるのであって期間を見積もるのではないできるだけアトミックな単位にタスクを分ける「作業中」の状態が2日以上にならないようにするタスクはチームで見積もるスプリント途中での再タスキン
![[Agile]スプリントのタスクに関するTips29個 | Ryuzee.com](https://cdn-ak-scissors.b.st-hatena.com/image/square/2739e548348eb41752b3cb6bf863f6de2d5fd0f4/height=288;version=1;width=512/https%3A%2F%2Fwww.ryuzee.com%2Fcontents%2Fblog%2Fimages%2F3959%2Fthumbnail.png)
rm -rf でやらかした時すかさず実行する復元コマンド(Linux編) | aucfan Engineers' blog
初めまして、新卒入社の桑折(@2k0ri)と申します。 入社から今日まで約３ヶ月間、研修およびOJTを受けさせて頂いておりました。 その初OJTのステージング環境で、デプロイ先ディレクトリのシンボリックリンクを消すつもりが デプロイディレクトリを中身ごとrm -rfする という重度のやらかしをしでかしました。 30秒うちひしがれた後、ググって extundeleteというコマンドを見つけてからの 自分が行ったリカバリーの手順を残します。 なお、このコマンドはext3/ext4フォーマット専用になります。 1. サーバーへのアクセスを出来る限り抑えるように周知 最近のLinuxのデファクトFSであるext4フォーマットは、rmされたデータの跡地に 待ったなしで容赦なく新しいデータが書き込まれていきます。 そのため、何よりもまず失われたデータが上書きされないように、 該当サーバーでやらかしたこ
Graphvizとdot言語でグラフを描く方法のまとめ - Qiita
概要 Graphvizはdot言語で記述されたグラフ構造を任意のフォーマットの画像ファイルへ出力するツールです。 グラフ構造はdot言語でdotファイルというプレーンテキストに記述します。 この記事はdot言語でグラフを書く方法を簡単にまとめたものです。 環境 下記の環境で動作確認を行いました。 Windows7 (64bit) Graphviz 2.38 参考 下記のサイトを参考にさせて頂きました。 Graphviz - Documentation Graphviz - Gallery Gvizの目次 - Rubyの世界からGraphvizの世界にこんにちは！ Rank attribute is confusing to me - stackoverflow Basic Graphviz - GitHub Graphviz チュートリアル (http://homepage3.nifty.
シェルスクリプトの処理境界が鮮明になる「名前付きブロック記法」なるものを考えてみた
シェルスクリプトは長くなると処理の境界が不鮮明になりがち。 コメントで処理の境界を表現する工夫はよく見かけるが、もっと良い方法はないか考えてみた。 :コマンド、&&演算子、複合コマンド()や{}を組み合わせて書くと、処理の境界線がはっきりする。
WF型開発にとらわれすぎたTiDDのアンチパターン #tidd - プログラマの思索
チケット駆動開発を運用してみて、悪いWF型開発のアンチパターンを頻繁に見かける。 考えたことをメモ。 【1】WF型開発がうまくいっているプロジェクトは、手戻り作業をできるだけ減らすように、前工程の品質チェックに力を入れる。 過去の経験値が生きる場合、いわゆるフロントローディングのやり方は有効に作用する。 しかし、僕はWF型の開発スタイルで上手くいった経験はあまりない。 ソフトウェア開発では、技術革新のスピードが早いため、過去の経験値が有効に作用せず、試行錯誤する回数がとても多い。 WF型開発が前提とする手戻り作業を減らす手法は、あまりにも綺麗過ぎる。 試行錯誤やリスクをあまりにも恐れている気がする。 Redmine・Trac・Mantisでチケット駆動開発をやってみると、リリースに至るまでの作業はいつも初めての問題にぶつかって試行錯誤して、どのイテレーションでも同じようにはならない。 チケ
講演１ Redmine導入のアンチパターン
Redmineの実際の運用事例から、各機能の使いこなし方法や運用方法を探ります。扱っている事例は、Redmine公式サイト(www.redmine.org)でのチケット運用、月次の事務処理に利用しているケース、Redmineで構築したヘルプデスクシステムによる顧客サポートです。 3月21日開催 RxTStudy #12 「ITS活用最前線 〜現場からの実践報告〜」発表資料。 Redmineをより使いこなすために、存在に気づきにくいために知らない人が多そうな、でも知っておくと便利な、ぜひ使っていただきたい機能を紹介します。 【基本編 — ぜひ知っておきたい基本操作】 ・ショートカットキー ・チケット一覧の右クリックでコンテキストメニュー表示 ・チケットの一括編集 ・コメントの表示順 ・特定の番号のチケットを素早く表示 ・ドラッグ＆ドロップでの画像埋め込み ・クリップボードからの画像ペースト
Redmineを活用するためのtips - Qiita
一人で案件を回すことになったため、RedmineとGitHub周りの機能を試しながら使い倒して気づいたことのメモ。（他のプロジェクトであまりRedmineが活用されていなくて、ただひとりのヘビーユーザになってしまった...） 1.バージョンを切ろう どんな仕事にも〆切があるはず。なくても暫定の〆切をつくって、そこまでの作業をバージョンして区切れば、そのときまでやるべきことがはっきりする。 2.タスクが見えたらチケット化しよう 作業・タスクはどんどんチケットにする。やるべきこと、やったことが見える化される。見える化されてないものがたくさんあると、何で時間がかかっているのか、問題があるのかわからなくなってしまう。 3. チケットに担当者を割り当てる どのタスクが、誰がボールを握っているのかをはっきりする。野球の「お見合い」みたいなことでタスクをとりこぼすことを防げる。個々人の負荷や進捗率も見え
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
