技術文書の書き方
howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。
意外ととっつきやすいOSS開発参加方法まとめ - Qiita
Ruby開発者のMatz(まつもとゆきひろ)さんが、こう語られています。 今までは、仕事は会社から与えられるもので、面白い仕事が当たればラッキーだけどそうじゃない場合もあったわけです。ところが、オープンソースの活動で自分の名前が表に出れば、今までとは違って「武器」を手に入れることができる (オープンソースへの取り組みはエンジニアにとって強力な「武器」になる より) いつかはやってみたいOSS開発。 とはいえ、OSS開発参加って別次元のギークたちの世界だろうと思っていました。 しかし、どうやらそんなこともないようで、素晴らしいコミッターの方々のメンタリングの元、僕のgithubアカウントがこうなりました。 ...おわかりだろうか。 ！！！！ ruby系の超大型OSS二つにcontributeして、githubが少々派手になりました。(が、最後まで読んでいただければ、これ自体は意外と簡単なんだ
開発者のタスク管理をGitHubで行ったらうまくいった話 | DevelopersIO
はじめに こんにちは、6月からAndroidの開発を担当している荒川です。 この記事は以下の方を対象にしています。 リモートリポジトリにGitHubを使っている タスクや課題の管理を小〜中規模のプロジェクトで行っている 複数の開発タスクが並行して進むプロジェクトにアサインされている 開発者のみのタスク管理を主体的に行いたい タスク管理ツールを使っているがイマイチうまくいっていない この記事では、私が実践して良かった経験則を紹介します。誰でも真似すれば必ずうまく行くという保証はありません。この記事の読者の方が、担当しているプロジェクトに合わせてアレンジを加えるとより効果が増すかと思います。 開発者のタスク管理 モバイルアプリサービス部では、コミュニケーションツールにBacklogやTrello、Pivotal Trackerを用いている事を突撃！隣の開発環境 パート3【クラスメソッド編】の記
Github Pagesでブログ構築ができる静的サイトジェネレーター総まとめ - Qiita
概要 Github Pagesでブログ構築ができる静的サイトジェネレーターの総まとめです。 もともと使っていたOctpressからの移行で、HugoとHexoで迷い、デプロイのしやすさや、Node.jsで完結できることなどからHexoに決めました。なので、Hexoの情報は多めになっています。 Assembleも、Grunt・Yeomanでがりがり動かすことができそうで、いつか試してみたいです。 リプレース要件 以下を満たすもの。 Markdownでブログ記事を記述できる(Githubとかで管理したいから) Octopressから移行が可能(最悪手動でもOK) デザインがモダンであること(スマートフォン対応していること) イケてること(色んな意味で) Jekyll｜Rails｜Github Star 18848 メリット Github Star数No1と人気。 日本語の記事も多い なんでもで
Primer - GitHub製。みんなで使えるデザインフレームワーク MOONGIFT
企業やプロジェクトによってデザインガイドラインは自ずと必要になってきます。それが社で働くデザイナーの共通認識になる訳ですが、例えばFacebookアプリを作る際にはボタンやデザインをFacebookっぽくしたくなるのではないでしょうか。つまりデザインガイドラインは社内だけでなく社外の人にとっても有益なのです。 そこで登場したのがPrimerです。PrimerはGitHubが作り、使っているデザインガイドラインになります。 Primerの使い方 スクリーンショットを多めで紹介します。まずはグリッド。 ヘッダー。h1〜6まで対応。 テキスト。若干小さめ？ インラインテキストの装飾。 ボタン。ここはGitHubっぽいですね。 ボタングループ。こういうのもGitHubで使われていますよね。 フォーム。シンプルです。 フォームグループ。縦に並べる時に使えます。 メニュー。アイコンはオプションです。
正式版がリリースしたAvocodeの便利な使い方をご紹介（コリス限定の優待コードもあるよ） | コリス
制作の効率が劇的にアップする『Avocode』の正式版が、1/29にリリースされました！ Avocodeは簡単に言うと、PSDのプレビューや書き出しをPhotoshop無しで行うもので、書き出しは画像だけでなく、SVGやCSSにも対応しています。画像のスライスやスタイルシートのコーディング作業がググッと楽になるWin/Mac/Linux対応のアプリです。 正式版で、特に大きく変わったのがデザイナー用簡単GitHub。これは無料で単体利用できる機能で、PSDファイルの共有やリビジョン管理が非常に簡単にできます。 ベータ版の時から、そして正式版がリリースされてからみっちりと試したので、Avocodeの使い方や登録方法を紹介します。 Avocode Avocodeには無料と有料のプランがあり、有料プランの優待コードがコリスのビジター限定でもれなく使用できます。無料プランだけを使ってもよし、有料プ
Swift開発で参考にしたいGitHub社の「Swift Style Guide」と日本語版 | ソフトアンテナ
Appleのアプリ開発用言語として大きな注目を集めているプログラミング言語「Swift」。まだ新しい言語だけあって、様々な定石や規約が出揃っておらず、どのように書けばベストなのか迷っている開発者の方も多いかもしれません。 そのようなときに参考になりそうなGitHub社のスタイルガイド、「Swift Style Guide」と、その日本語訳「Swiftコーディング規約」が公開されています。 同スタイルガイドは、Swiftプログラムの精密さや厳密さを向上させ、エラーを減少させることを目的としたガイドラインで、例えば、「(タブよりスペースを使うといった)空白の使い方」から、「可能な限りlet宣言をvar宣言より優先する」、「オプショナル型の開示指定は避ける」、「暗黙的開示オプショナル型の使用を避ける」などシンタックスの細部に至る、様々な指針が提示されています。 if let foo = foo
「Web制作者のためのGitHubの教科書」という本を執筆しました
サイバーエージェントの平木さん(@Layzie)、原さん(@herablog)、紫竹さん(@79yuuki)との共著で、「Web制作者のためのGitHubの教科書 チームの効率を最大化する共同開発ツール」という本を執筆しました。 10/24、インプレスジャパンさんから発売予定です。昨日無事校了との連絡がありました。 どんな本？「Web制作者のための＊＊＊の教科書」シリーズに連なる本で、エンジニア以外の人にもGitHubを使ってもらうための入門書です。Gitの基本的な概念と使い方、CUIとGUIでの操作、GitHubの機能とユースケースなどを、やわらかくわかりやすく紹介しています。 詳細は発売してからのお楽しみ…ですが、バージョン管理なにそれ？黒い画面怖い！な人でもGitHubを使ったチーム開発に参加できるよう、わかりやすく解説しています。ご期待ください！ 執筆に至った経緯GitHub勉強会
サイバーエージェントのGitHub活用 ～ 導入から運用体制、開発フロー、勉強会による現場への普及活動まで
また、Organization[1]の数も360を超え[2]、リポジトリ数もOrganizationのものだけでも2000近く作られています[3]。 新規のプロジェクトは基本的にGitを利用しており、既存プロジェクトもほとんどがSubversion（以下SVN）などからGitに移行しました。 本記事では、Ameba事業本部がどのようにGitを組織内に普及させていったか、その運用体制、現場でどのように利用されているのかをご紹介します。 [1] 複数アカウントをまとめるグループ機能です。リポジトリは個人単位だけでなく、Organization単位で作ることもできます。 [2] プロジェクト単位で1つのOrganizationを用意しています。 [3] 個人アカウントで作成したり、他からforkしたリポジトリは除いた数です。 GitHub Enterprise導入への道のり GHE導入以前の標準
ちょっとしたHTMLはGitHub Gistに置いてbl.ocks.orgで表示するのがお手軽です - Qiita
はじめに 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 【概要】 次々と新しい技術やサービスが公開され、いろいろ挑戦してみたい・・・とは思うのですが、それが複雑なものだったり高機能であったりすると、どうしても最初のハードルが高く、なかなか踏み出せないと感じます。 そんな時、私の場合は、とりあえず、できるだけ簡単なマニュアルを探してきて、良く分からないところは全部無視して無理やり使ってみることにしています。訳が分からないままでも、使っていることで、ちょっとずつイメージが湧いてきて、画面が見慣れたものになってきます。そして、それから改めて入門書を読み始めます。そうすることで、最初のハードルが、少しは下がるのではと考えています。 githubも非常に高機能なシステムですので、初めての方は、きっとハードルが高いのではと考え、このプレゼンを作成して
GitHub for Windows
ProductGitHub for WindowsThis article hasn't been updated in a while. For the most current information, please refer to the official Help documentation and the Desktop website. Ever wish there was an easy… This article hasn’t been updated in a while. For the most current information, please refer to the official Help documentation and the Desktop website. Ever wish there was an easy way to get up
はじめてのgithub
世界一簡単なGithub入門（githubは無料で使用する場合、全てのファイルが公開されていることにご注意ください） ややこしいコマンドを全スルーして個人用バックアップとして使ってみる 2013.01.26 LDD13 LT 【概要】 次々と新しい技術やサービスが公開され、いろいろ挑戦してみたい・・・とは思うのですが、それが複雑なものだったり高機能であったりすると、どうしても最初のハードルが高く、なかなか踏み出せないと感じます。 そんな時、私の場合は、とりあえず、できるだけ簡単なマニュアルを探してきて、良く分からないところは全部無視して無理やり使ってみることにしています。訳が分からないままでも、使っていることで、ちょっとずつイメージが湧いてきて、画面が見慣れたものになってきます。そして、それから改めて入門書を読み始めます。そうすることで、最初のハードルが、少しは下がるのではと考えています。
踊るPerfumeのモーションキャプチャデータ公開 GitHubに「perfume-dev」ページ
Perfumeの3人が踊るモーションキャプチャデータが3月30日、公開された。Perfumeの世界進出プロジェクトの1つで、公開データを使った作品作りを世界のクリエイターに呼び掛けている。GitHubにはサンプルコードを公開する「perfume-dev.github.com/」が開設された。 Perfumeのグローバルサイトにダウンロードコーナーがオープン。約1分間のモーションキャプチャデータ（BVHファイル）と中田ヤスタカさんによるサウンド（WAVファイル）をダウンロードでき、規約（非商用利用のみなど）に従って利用可能だ。モーションキャプチャデータは「aachan」「kashiyuka」「nocchi」の3人分が用意されている。
50+ JavaScript & HTML5 Frameworks and Related Tools : Remote Synthesis
This is the first draft of a document I am using and handing out along with my upcoming presentations at 360Flex and cf.Objective(). It is a list of every JavaScript (and, to a lesser degree HTML5) framework I have come across over the past 6 months. I have organized them according to categories, given the URL, license details, source availability and a brief summary. My goal in posting this now,
入社2週間で書類1枚書かずに大きな決裁！グリーのスピード感：Rails Hub情報局：エンジニアライフ
「オレ、入社2週間で大きな決裁を通しましたよ！ まだ試用期間中だったのに（笑）」。JRubyのコミッターで、Rubyコミュニティで広く知られた大場光一郎さんに久しぶりにお会いしたら、ちょっと興奮気味にこうおっしゃるのですよ。具体的な数字は書けませんが、確かに、ふつうの企業なら1週間や2週間で決まるような金額ではありません。まして入社2週間の試用期間中の社員の提案です。 大場さんは2011年12月に、日本で5本の指に入る大手SIerを退職し、ソーシャル・ネットワーキング・サービス「GREE」を運営するグリーに入社したというではありませんか。そして、あまりの2社のスピード感の違いに驚いているというのです。Developers Summit 2012（通称デブサミ）が終わった後の飲み会でお話を伺ったのですが、水を得た魚とはこのことかというほど楽しそうに、新しい仕事上のチャレンジについて話をされて
GitHubをもっとソーシャルに使いこなすための7つ道具：安藤幸央のランダウン（60） - ＠IT
新サービスが続々登場してアツい！ 「GitHub」とは 皆さんは「GitHub」を活用しているでしょうか？ 「GitHub」（ギットハブ）はソースコード管理用の分散型バージョン管理システム「Git」を使ったホスティングサービスです。 Gitの特徴は、作業用として自分のコンピュータ上にあるローカルリポジトリがあれば、ネットワークに接続できない状態だったとしても、ソースコードの更新や、履歴を調べたりできる点にあります。その特徴はGitHubにも生かされていて、オープンソースとして公開中の既存のコードを分岐（fork）して、新しいプロジェクトとして開発できます。 また、自分が手元のローカル環境でバグ修正したり、拡張したソースコードを本家のオープンソースプロジェクトに取り込んで（pull）もらうことも手軽にお願いできます。 さらに、READMEテキストファイル（README.md）などを独特のマー
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub の基礎 - 管理の基本と製品の機能。 - Training
Githubページを利用したブログを構築できる・「HubPress.io」
dfltweb1.onamae.com – このドメインはお名前.comで取得されています。
