Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
詳細設計書ってあるじゃないですか。 - 室長のひとりごち
「詳細設計書ってあるじゃないですか。」 「あるね。」 「『必要ですか』って聞かれたんですけど。」 「そう。」 「必要ですかね。」 「何て答えたの。」 「成果物で決めているなら必要でしょう、って。」 「成果物なら必要だね。」 「『じゃあ、成果物じゃなければ必要ないんでしょ』って聞かれて。」 「何て答えたの。」 「詳細設計書で何を伝えたいか決まっているの、って。」 「質問で返したんだ。」 「まぁ、そうですが。でも、質問の意味が解らないし。」 「そしたら。」 「設計する人とコード書く人が同じならいらいですよね、って。」 「質問が変わった気があるね。」 「まあまあ。」 「それで。」 「同じ人なら確かにいらない、って。」 「マジで。」 「はい。」 「とっても限定されている条件下での話、だよね。」 「うーん、そうかも…しれないですね。」 「今のビジネスでそんな条件下、存在するんかい。」 「わからないで
MarkdownをWord形式(docx)に変換する - Qiita
考えを整理しながらドキュメントを書くのにMarkdownが便利ですが、資料を印刷して持ってきてとか言われると困ったりします。 そんな時にPandocを使ってdocxなどの形式に変換して印刷すると便利です。(PDFにも出来ますが、フォントサイズなどの微調整も出来るのでdocxにすることが多いです) pandocは、Haskell製のドキュメント変換ツールです。 対応している形式などは以下を参照してください。 Pandoc - About pandoc インストール インストールは以下を参考にしてください。PDFへ変換するには別途依存するライブラリを入れる必要があります。 http://johnmacfarlane.net/pandoc/installing.html MacとWindows向けにはインストーラが提供されているので、それを使ってインストールすると楽です。 Releases ·
正しい「議事録」の書き方
連載「エンジニアのためのビジネス文書作成術」は、書籍「外資系コンサルのビジネス文書作成術」（吉澤準特著 東洋経済新報社）を基に、出版社の許可を得て、筆者自身が＠IT読者向けに再構成したものです。画像はWindows 7 + Word 2013上のものです。機能はWord2013、2016のいずれでも使用できます あなたは仕事でドキュメントを作る際、どのソフトウェアを使っているでしょうか。 これは業界次第で傾向が大きく異なります。広告業界やコンサル業界は「PowerPoint」が大好きですし、官公庁や出版業界は「Word」文書で溢れています。 IT業界は「Excel」が多いですね。進捗（しんちょく）管理に使う「WBS」や「課題一覧」、設計フェーズの成果物となる「設計書」に至っては、Excel以外のフォーマットで作られたものを見たことがほとんどありません。 しかし、IT業界でも「これだけはWo
Symfony2の簡単な使い方 インストールからHelloWorldまで - TetraThemesブログ
Symfony2初心者のための簡単な使い方、インストール編。 2015年の夏頃に公開されたEC-CUBE3でSymfonyが使われているということで、注目度も大幅アップ（？）なSymfony。実際使ってみるとわかりますが、結構使いやすいフレームワークなんです。 ターミナルからコマンド入力で出力されたコードをベースに、ちょこっと追記するだけで大抵のことができてしまうため、非プログラマーでも扱いが簡単な印象です。 このページではこれからSymfony始める方向けにSymfony2の使い方をさくっとまとめてみたいと思います。 Symfony2の簡単な使い方 インストール編 Symfony2とは？ 一言で言うとプログラマーでなくても簡単に使えるPHPフレームワーク。強力なテンプレートエンジンのTwigや、分かりやすいルーティング設定などとにかく使いやすい印象です。 また、Symfony2は英語だけ
EC-CUBE開発ドキュメント
EC-CUBE 3.0 開発ドキュメント・マニュアル EC-CUBEの開発ドキュメント（マニュアル）サイトです。 EC-CUBEのインストール方法、開発ガイドラインや要素技術の概念、本体開発やプラグイン開発のチュートリアル、Cookbookなどの情報を提供しています。 ドキュメントへの追記、記載内容の修正についてはEC-CUBE本体と同様にGitHubで受け付けております。 運用者向け情報 運用者向けには以下のサイトをご覧ください。 EC-CUBE 3運用マニュアル（株式会社クロスキューブ様） EC-CUBE 3管理・運用 マニュアル（株式会社シロハチ様） Quick Start システム要件 インストール方法 プロキシサーバの設定 urlからhtmlを無くす手順 バージョンアップ方法 本体の仕様 ディレクトリ構成 設定ファイル 設定ファイルの概要 doctrine_cacheの設定 セッ
HOWTO Fetch Internet Resources Using The urllib Package
HOWTO Fetch Internet Resources Using The urllib Package¶ Author: Michael Foord Introduction¶ urllib.request is a Python module for fetching URLs (Uniform Resource Locators). It offers a very simple interface, in the form of the urlopen function. This is capable of fetching URLs using a variety of different protocols. It also offers a slightly more complex interface for handling common situations -
LaravelベースのCMS OctoberCMS入門 - Qiita
OctoberCMSとはタイトルの通り人気のPHPフレームワークLaravelをベースにしたCMSです。 追記 (2021/02/27) まず初めに、個人的な意見ですが、CMSと言ってますがWordPressと比較するようなものではありません。 WordPressとどちらにしようか検討している場合はWordPressをおすすめします。CMSとしてはWordPressの方が歴史が長くユーザも多いため圧倒的に使いやすいと思います。 一方、Octoberはリッチなフレームワークとして非常に優秀です。つまりエンジニア向けです。（追記ここまで） Webエンジニアの自覚が無かった私ですが、なりゆきで幾つかのサイトを開発運営していますが、開発力を持たない企業だと、SEOとか気にしだすと結局CMSが必要になってくるんですね（はじめは要らないって思っていても）。 なので、実装の自由を奪われるのが嫌で使用して
Rich Text Format(RTF)の構造（の覚え書き） - Part 1 - うぃずのひとりごと
Visual Studioのコードは、コピーすることでリッチテキスト形式のドキュメント(RTF)を取り出すことが出来る。が、リッチテキスト形式からHTMLにダイレクト変換するツールが案外少ないので、作ってしまおう。ということになり、現在作成中。 リッチテキストといえば、ワードパッドである。つまり、ワードパッドで作成されるファイル(*.rtf)を解析すれば、Visual StudioのコードをHTML化することが可能。 RTFは、Microsoftが開発したドキュメントフォーマットであり、その仕様（英語のみ）はMSのサイトでも公開されているのだが、最新版のVersion 1.9では仕様書だけで11MB超・・・。A4サイズでなんと281ページに及ぶ。RTF⇔HTML変換ソフトが有料版な訳もうなずける。 さてこれだけの規模の仕様を、1～100まで対応するのは到底無理＆無駄なので、コードをコピーし
CakePHP3 rails のように部分テンプレートを使用する方法
Rails を真似て作られたといわれている CakePHP で、 部分テンプレートの使用例を説明します。 英語ドキュメントを見ると正しく設定できるのですが、 日本語ドキュメントは古い状態なので、日本語ドキュメントを見ていると解決できません。 環境 PHP 5.5.9 CakePHP 3.0.9 Rails での 部分テンプレート の使い方 rails では 例えば rails g scaffold xxxx で自動的に作成した場合、 _form.html.erbというファイルが作成されます。 これが部分テンプレートです。 ファイルの先頭は _ になっており、 new.html.erb などの中で次のように呼び出します。
「要件定義書のアウトライン作成」完全マニュアル
他の文書と同様、要件定義書はまず文書全体のアウトライン（骨格、構成）をしっかり作り上げてから内容を記述します。今回は、読みやすく分かりやすい要件定義書にするためのアウトライン作成方法を紹介します。 階層構造で読みやすい文書にする 要件定義書を作るためには、全体を大見出し＝中見出し＝小見出し（章＝節＝項）の階層構造にします。 「大見出し」「中見出し」「小見出し」の数を、それぞれ5から10程度にするのは、前回（第3回「分かりやすい提案書はアウトラインが美しい」）紹介した提案書と同様です。見出しの数が多すぎると、読み手が文書の全体像を把握できなくなります。また、1つの項目の記述量を1ページ内に収めるようにします。 要件定義書を構成する項目 要件定義書に必要な大見出しの項目としては、次のようなものが挙げられます。 システムの概要／システムの構想 機能要求 入力要求と出力要求 システム導入後の業務フ
Railsの基礎知識 | Railsドキュメント
xxx : コントローラ名、モデル名 yyy : アクション名 mmm: マイグレーション名 YYYYMMDDhhmissは作成日時が入る テーブル定義についての規約 テーブル名とクラス名 テーブル名は複数形 単語の区切りはアンダーバー(_) 対応するクラス名は単語の先頭を大文字にして _ を取り除いたもの キーのカラム名 主キーのカラム名は「id」 外部キーのカラム名は「テーブル名の単数_id」 日付関連のカラム名 DATE型のカラムには名前を「受動態_on」 TIMESTAMP型のカラムには名前を「受動態_at」 更新日時、作成日時は「updated_at」「created_at」 結合テーブル 関連させたいテーブル名をくっつけた名前 カラム「id」を作らずに、関連させる2つのキーのセットを主キー Railsの実行環境 概要 実行するときの3つの実行環境 development tes
設計書仕様書テンプレート PocketDOC | 株式会社イーイノベーション
弊社サービスをご利用頂き、誠に有り難うございます。 ドキュメントのダウンロード件数が2007年5月の開設以来300000件を突破しました！ 今度ともご愛顧の程よろしくお願いいたします。 PocketDOC(ポケットドック)とはシステム開発に必要な設計書や仕様書などのドキュメントやテンプレートはもちろんのこと、 議事録、納品・検収書、近年話題になっている個人情報に関しての取扱管理表などの ドキュメントやテンプレートも提供しています。 実際に弊社のプロジェクトで使用されているため精度も高く、カスタマイズなしでも利用可能なほどです。 上流工程から下流工程まで広い範囲をサポートしているので、 必要なテンプレートだけをダウンロードして利用することも可能です。 ドキュメントやテンプレートのファイル形式はWord(doc形式)やExcel(xls形式)です。 ダウンロード後、すぐにお使いいただけるように
GoogleドキュメントをDropboxのように扱える「Insync」が容量無制限で無料化！｜男子ハック
まずはトップページからGoogleアカウントでログイン。 続いてInsyncのアプリケーションをダウンロードします。 ダウンロードしたアプリケーションをアプリケーションフォルダにドラッグ&ドロップ。 あとはInsyncを起動するだけです。同期されているデバイスが表示されています。 同期が完了するとホームフォルダ直下に「Insync」というフォルダが作成され、下階層にアカウント名のフォルダができドキュメントが同期されています。 同期する容量を増やしたい場合はGoogleのアカウント容量を増やせばOK。単純な料金を比べるとDropboxよりもコストパフォーマンスが高くなりますね。 あとはDropboxのような応用的な使い方ができるようになるのか？というところですが、現在はまだDropboxの勝ちという感じ。 Googleドキュメントを使っている人は導入してみてはいかがでしょうか？
GitHub Pagesホスティングサービス（ほぼ）完全活用ガイド | ゆっくりと…
GitHub がオープンソースの場として魅力的な理由は、Git という優れた分散・協調型リビジョン管理システムのリポジトリー・ザーバーとして誰でも利用できるということはもちろん、README などのドキュメント生成機能やコメンティング機能、問題のトラッキング機能など、Git を補助し、オープンな分散・協調開発を支えるサブシステムが充実している点が挙げられるでしょう。無料でもかなりのことができるのに、ビジネスとしてもちゃんと成立している理由はこんなところにあるように思います。 ただ、同種サービスの Google Code や Bitbucket と決定的に異なり、GitHub の最大の魅力となっているのは、GitHub Pages という1種のホスティング・サービスではないかと思います。成果物をただずらずらと味気ないページに並べるのではなく、趣向を凝らした紹介ページを自由に作り、プロジェクト
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
システム変更を安全かつスピーディに進めるための極意とは？～CRUD表で今すぐできるコスト削減
ブートストラップスターターテンプレート
SettingApp Schema - 設定画面をサッと表示するURLスキーマ [まとめ]![SettingApp Schema - 設定画面をサッと表示するURLスキーマ [まとめ]](https://cdn-ak-scissors.b.st-hatena.com/image/square/562d2d6b32c1a40d1d476bdbef6f0dc9f46cb6b1/height=288;version=1;width=512/https%3A%2F%2Flh7-us.googleusercontent.com%2Fdocs%2FAHkbwyJWnVVXxeRDAJgEjeXb0yKreqNu2PFng6iWvlgp0AnP9SoGMSVdlXlISRsgTY6lpWOZRQxd_4TGHGDgoWGT62kj0Kqm4JWXSGVPwOwnPHwhCQ%3Dw1200-h630-p)
Excel 方眼紙撲滅委員会 活動報告 2012.11 #odstudy
syslog-ngの導入