タグ

githubに関するatsuizoのブックマーク (6)

  • markdownlintで設計書の品質を高める | フューチャー技術ブログ

    はじめにフューチャー技術ブログのリレー形式の連載である、春の入門祭り2023の1日目です。TIG真野です。 ここ数年、Markdown設計書をチームで書き、GitHubGitLab)上でレビューするフローを採用しています。なるべくテキストベースで設計開発フローを統一するため、私の所属するチームでは以下のようなツールを採用しています。 シーケンス図、業務フロー図 Markdown中にPlantUMLで記載 参照はGitHub上からも見れるように、pegmatite を利用 システム構成図など画像系 Diagrams.netdraw.io)で作成し、.drawio.png の拡張子でMarkdownから参照 これだけは目視で差分チェックとなる Web API定義 OpenAPI SpecのYAMLファイル 参照はGitHub上からも見れるように、swagger-viewer を利用 ER

    markdownlintで設計書の品質を高める | フューチャー技術ブログ
  • 技術本を読む時にリポジトリを作る - 圧倒亭グランパのブログ

    @t_wadaさん翻訳の「新訳版 テスト駆動開発」の第Ⅰ部を終えました。 テスト駆動開発posted with ヨメレバKent Beck オーム社 2017-10-14 AmazonKindle このを読むにあたってgitリポジトリを作って読み進めたので、その方法を記しておきます。 読んで終わりにしたくない 読む前に、注意点として「読んで終わりにしないこと」「エンジニアリングに活かせるようにすること」を掲げました。以前、ピアソンから出版されている旧訳版を読んだのですが、今の自分に残っているのは「テストから書き始めること」くらいでした。あまりにも身についていないことに気付き、読み方を変えてみようと思いました。以前は「スキマ時間にさらっと読む」というスタイルだったので、それが原因かもしれません。 まずはリポジトリを作る そのため、今回はリポジトリを作って「開発」を行うようにしました。以下が

    技術本を読む時にリポジトリを作る - 圧倒亭グランパのブログ
  • 水野祐+平林健吾 Edit × LAW 第13回「GitLaw」- DOTPLACE

    第13回「GitLaw」 水野祐 差分という鑑賞方法は、〔中略〕その鑑賞者が一番最適と思っている「解」を自分に見せている仕組みがある 佐藤雅彦、菅俊一、石川将也著『差分』(美術出版社、2009年) 「コードは法である」と論じた、ローレンス・レッシグの主著『CODE インターネットの合法・違法・プライバシー』(山形浩生・柏木亮二訳、翔泳社、2001年)を引くまでもなく、法とソースコード・プログラムの近似性は指摘されているところである。筆者もまた実務において、法律や契約などの法の設計・デザインは、人や企業から成る社会関係を正しく動作させるためのプログラミングであるとの実感をもって、契約書をドラフトしている。Google Docsでクライアントと一緒に契約書を「コーディング」していると、そこには確かに新しい感覚が存在する。 近年、ソフトウェア開発者に人気があるソースコード共有サービスが「GitH

    水野祐+平林健吾 Edit × LAW 第13回「GitLaw」- DOTPLACE
  • GitHubはオープンソースのプロセスを標準化した。これからはコード開発以外にも使われていく。AWS Summit Tokyo 2015

    GitHubはオープンソースのプロセスを標準化した。これからはコード開発以外にも使われていく。AWS Summit Tokyo 2015 Amazonクラウドのイベント「AWS Summit Tokyo 2015」が都内で開催されています。1日目の6月2日、デベロッパー向けのDevConセッションの基調講演には、GitHub, Inc.共同創業者 Scott Chacon氏が登壇。GitHubの登場がオープンソースの世界をどう変化させ、これから企業や社会にどのような影響を与えていくのかについて語りました。 基調講演の内容をダイジェストで紹介します。 この会場にいる人たちはこの10年でもっとも重要な人たち GitHub, Inc.共同創業者 Scott Chacon氏。 現在、あらゆる企業はソフトウェア企業だと言える。電気自動車を作っているテスラでさえ、製品のために多くのソフトウェアを作り続

    GitHubはオープンソースのプロセスを標準化した。これからはコード開発以外にも使われていく。AWS Summit Tokyo 2015
    atsuizo
    atsuizo 2015/06/03
    ソース管理じゃなく文書管理観点でのGitHubの環境整備と活用についてまとめて偉い人。
  • 第51回 開発効率向上を目指してGitHub Enterpriseを導入 | gihyo.jp

    経営部部門に異動して開発環境の整備に専念 アプリケーションやサービスの開発、あるいはWebサイトの制作などにおいて、欠かせないツールとなっているのがバージョン管理システムです。とくに多人数で開発を行う際、いつ誰がどのファイルを編集したのかをすばやく把握できる、あるいはファイルに加えた変更履歴を簡単に参照できるといったメリットを持つバージョン管理システムは、プロジェクトを円滑に進めるうえで極めて有用です。 サイバーエージェントのアメーバ事業では、このバージョン管理システムとしてApache Subversion(SVN)をメインで使っていましたが、エンジニアの間から「Git」を使いたいという声が高まり、それに応える形で「GitHub Enterprise」を導入、2013年4月から格的に運用を開始しています。この導入プロジェクトを主導した奥田順子氏は、そもそものきっかけを次のように説明し

    atsuizo
    atsuizo 2013/06/26
    gitじゃなきゃいけない確固たる理由が弱い中でロジック組み替えたところがいいね。
  • 入社2週間で書類1枚書かずに大きな決裁!グリーのスピード感:Rails Hub情報局:エンジニアライフ

    「オレ、入社2週間で大きな決裁を通しましたよ! まだ試用期間中だったのに(笑)」。JRubyのコミッターで、Rubyコミュニティで広く知られた大場光一郎さんに久しぶりにお会いしたら、ちょっと興奮気味にこうおっしゃるのですよ。具体的な数字は書けませんが、確かに、ふつうの企業なら1週間や2週間で決まるような金額ではありません。まして入社2週間の試用期間中の社員の提案です。 大場さんは2011年12月に、日で5の指に入る大手SIer退職し、ソーシャル・ネットワーキング・サービス「GREE」を運営するグリーに入社したというではありませんか。そして、あまりの2社のスピード感の違いに驚いているというのです。Developers Summit 2012(通称デブサミ)が終わった後の飲み会でお話を伺ったのですが、水を得た魚とはこのことかというほど楽しそうに、新しい仕事上のチャレンジについて話をされて

    入社2週間で書類1枚書かずに大きな決裁!グリーのスピード感:Rails Hub情報局:エンジニアライフ
    atsuizo
    atsuizo 2012/02/28
    さすがに稟議のところは注釈入ったか。/ポイントは、「中身を理解できる人に、十分な決裁権が与えられていること。」に尽きるよな。
  • 1