howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。

このブラウザーはサポートされなくなりました。 Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? Ruby開発者のMatz(まつもとゆきひろ)さんが、こう語られています。 今までは、仕事は会社から与えられるもので、面白い仕事が当たればラッキーだけどそうじゃない場合もあったわけです。ところが、オープンソースの活動で自分の名前が表に出れば、今までとは違って「武器」を手に入れることができる (オープンソースへの取り組みはエンジニアにとって強力な「武器」になる より) いつかはやってみたいOSS開発。 とはいえ、OSS開発参加って別次元のギークたちの世界だろうと思っていました。 しかし、どうやらそんなこともないようで、素晴らしいコミッターの

はじめに こんにちは、6月からAndroidの開発を担当している荒川です。 この記事は以下の方を対象にしています。 リモートリポジトリにGitHubを使っている タスクや課題の管理を小〜中規模のプロジェクトで行っている 複数の開発タスクが並行して進むプロジェクトにアサインされている 開発者のみのタスク管理を主体的に行いたい タスク管理ツールを使っているがイマイチうまくいっていない この記事では、私が実践して良かった経験則を紹介します。誰でも真似すれば必ずうまく行くという保証はありません。この記事の読者の方が、担当しているプロジェクトに合わせてアレンジを加えるとより効果が増すかと思います。 開発者のタスク管理 モバイルアプリサービス部では、コミュニケーションツールにBacklogやTrello、Pivotal Trackerを用いている事を突撃！隣の開発環境 パート3【クラスメソッド編】の記

概要 Github Pagesでブログ構築ができる静的サイトジェネレーターの総まとめです。 もともと使っていたOctpressからの移行で、HugoとHexoで迷い、デプロイのしやすさや、Node.jsで完結できることなどからHexoに決めました。なので、Hexoの情報は多めになっています。 Assembleも、Grunt・Yeomanでがりがり動かすことができそうで、いつか試してみたいです。 リプレース要件 以下を満たすもの。 Markdownでブログ記事を記述できる(Githubとかで管理したいから) Octopressから移行が可能(最悪手動でもOK) デザインがモダンであること(スマートフォン対応していること) イケてること(色んな意味で) Jekyll｜Rails｜Github Star 18848 メリット Github Star数No1と人気。 日本語の記事も多い なんでもで

企業やプロジェクトによってデザインガイドラインは自ずと必要になってきます。それが社で働くデザイナーの共通認識になる訳ですが、例えばFacebookアプリを作る際にはボタンやデザインをFacebookっぽくしたくなるのではないでしょうか。つまりデザインガイドラインは社内だけでなく社外の人にとっても有益なのです。 そこで登場したのがPrimerです。PrimerはGitHubが作り、使っているデザインガイドラインになります。 Primerの使い方 スクリーンショットを多めで紹介します。まずはグリッド。 ヘッダー。h1〜6まで対応。 テキスト。若干小さめ？ インラインテキストの装飾。 ボタン。ここはGitHubっぽいですね。 ボタングループ。こういうのもGitHubで使われていますよね。 フォーム。シンプルです。 フォームグループ。縦に並べる時に使えます。 メニュー。アイコンはオプションです。

制作の効率が劇的にアップする『Avocode』の正式版が、1/29にリリースされました！ Avocodeは簡単に言うと、PSDのプレビューや書き出しをPhotoshop無しで行うもので、書き出しは画像だけでなく、SVGやCSSにも対応しています。画像のスライスやスタイルシートのコーディング作業がググッと楽になるWin/Mac/Linux対応のアプリです。 正式版で、特に大きく変わったのがデザイナー用簡単GitHub。これは無料で単体利用できる機能で、PSDファイルの共有やリビジョン管理が非常に簡単にできます。 ベータ版の時から、そして正式版がリリースされてからみっちりと試したので、Avocodeの使い方や登録方法を紹介します。 Avocode Avocodeには無料と有料のプランがあり、有料プランの優待コードがコリスのビジター限定でもれなく使用できます。無料プランだけを使ってもよし、有料プ

2024 著作権. 不許複製 プライバシーポリシー

Appleのアプリ開発用言語として大きな注目を集めているプログラミング言語「Swift」。まだ新しい言語だけあって、様々な定石や規約が出揃っておらず、どのように書けばベストなのか迷っている開発者の方も多いかもしれません。 そのようなときに参考になりそうなGitHub社のスタイルガイド、「Swift Style Guide」と、その日本語訳「Swiftコーディング規約」が公開されています。 同スタイルガイドは、Swiftプログラムの精密さや厳密さを向上させ、エラーを減少させることを目的としたガイドラインで、例えば、「(タブよりスペースを使うといった)空白の使い方」から、「可能な限りlet宣言をvar宣言より優先する」、「オプショナル型の開示指定は避ける」、「暗黙的開示オプショナル型の使用を避ける」などシンタックスの細部に至る、様々な指針が提示されています。 if let foo = foo

また、Organization[1]の数も360を超え[2]、リポジトリ数もOrganizationのものだけでも2000近く作られています[3]。 新規のプロジェクトは基本的にGitを利用しており、既存プロジェクトもほとんどがSubversion（以下SVN）などからGitに移行しました。 本記事では、Ameba事業本部がどのようにGitを組織内に普及させていったか、その運用体制、現場でどのように利用されているのかをご紹介します。 [1] 複数アカウントをまとめるグループ機能です。リポジトリは個人単位だけでなく、Organization単位で作ることもできます。 [2] プロジェクト単位で1つのOrganizationを用意しています。 [3] 個人アカウントで作成したり、他からforkしたリポジトリは除いた数です。 GitHub Enterprise導入への道のり GHE導入以前の標準

はじめに JavaScriptを含んだHTMLを表示するのにGitHubでレポジトリを作ってGitHub Pagesを作るという手もありますが、ちょっとしたHTMLだと、わざわざレポジトリ作るのも面倒です。 FirefoxのBugzillaを見ていたら、984796 – SVG path getTotalLength returns large incorrect numberでたまたま見つけた bl.ocks.org - aboutが便利だったので紹介します。 使い方 index.html というファイル名でGistを作成します。 あとは、GistのURLの https://gist.github.com を http://bl.ocks.org に置き換えてアクセスすれば表示されます。 bl.ocks.org - aboutに上げられている https://gist.github.co

世界一簡単なGithub入門（githubは無料で使用する場合、全てのファイルが公開されていることにご注意ください） ややこしいコマンドを全スルーして個人用バックアップとして使ってみる 2013.01.26 LDD13 LT 【概要】 次々と新しい技術やサービスが公開され、いろいろ挑戦してみたい・・・とは思うのですが、それが複雑なものだったり高機能であったりすると、どうしても最初のハードルが高く、なかなか踏み出せないと感じます。 そんな時、私の場合は、とりあえず、できるだけ簡単なマニュアルを探してきて、良く分からないところは全部無視して無理やり使ってみることにしています。訳が分からないままでも、使っていることで、ちょっとずつイメージが湧いてきて、画面が見慣れたものになってきます。そして、それから改めて入門書を読み始めます。そうすることで、最初のハードルが、少しは下がるのではと考えています。

AI & MLLearn about artificial intelligence and machine learning across the GitHub ecosystem and the wider industry. Generative AILearn how to build with generative AI. GitHub CopilotChange how you work with GitHub Copilot. LLMsEverything developers need to know about LLMs. Machine learningMachine learning tips, tricks, and best practices. How AI code generation worksExplore the capabilities and be

2. 自己紹介 名前: 濱田康貴 HN: (っ´∀｀)っ ゃー Twitter ID: @nullpopopo Facebook: http://www.facebook.com/nullpopopo 職業: インフラエンジニア 趣味: 勉強会運営 自転車 Linux 7つ道具: vim awk grep ps netstat パイプ リダイレクト 将来の夢: geek団地 (iDC併設) 建設 3. githubって何？ • gitのプロジェクトホスティングサービス • 100MBまで無料で使える • gitリポジトリを自分で作って公開できる • WEB上から変更履歴などが参照可能 • githubで公開されている他のOSSのコードをforkして開発することが可能 • ただしバグトラッキングシステムがない • バグトラッキングはIssueでできます ※ 出展： はてなキーワード http

Perfumeの3人が踊るモーションキャプチャデータが3月30日、公開された。Perfumeの世界進出プロジェクトの1つで、公開データを使った作品作りを世界のクリエイターに呼び掛けている。GitHubにはサンプルコードを公開する「perfume-dev.github.com/」が開設された。 Perfumeのグローバルサイトにダウンロードコーナーがオープン。約1分間のモーションキャプチャデータ（BVHファイル）と中田ヤスタカさんによるサウンド（WAVファイル）をダウンロードでき、規約（非商用利用のみなど）に従って利用可能だ。モーションキャプチャデータは「aachan」「kashiyuka」「nocchi」の3人分が用意されている。

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

新サービスが続々登場してアツい！ 「GitHub」とは 皆さんは「GitHub」を活用しているでしょうか？ 「GitHub」（ギットハブ）はソースコード管理用の分散型バージョン管理システム「Git」を使ったホスティングサービスです。 Gitの特徴は、作業用として自分のコンピュータ上にあるローカルリポジトリがあれば、ネットワークに接続できない状態だったとしても、ソースコードの更新や、履歴を調べたりできる点にあります。その特徴はGitHubにも生かされていて、オープンソースとして公開中の既存のコードを分岐（fork）して、新しいプロジェクトとして開発できます。 また、自分が手元のローカル環境でバグ修正したり、拡張したソースコードを本家のオープンソースプロジェクトに取り込んで（pull）もらうことも手軽にお願いできます。 さらに、READMEテキストファイル（README.md）などを独特のマー