SEってよく質問に対して「○○という認識です」って言い回し使うけど「事実を教えてくれ」って思ってしまう→いや、「認識です」にはちゃんと理由があるんだというツッコミ

2024/03/19 435 users ツッコミ 事実 認識 質問 理由

ちょめ子 @chome2xx 私「この機能って今使われてますか？」 ？「今は使われてない認識です」 私「設計書って更新されてます？」 ？「更新されてる認識です」 いや、認識じゃなくて事実を教えてくれって思ってしまうのだが、SEこういう言い回し好きだよね 2024-03-18 10:02:14 続きを読む

サイカの即戦力を生む2つの設計書 - XEP と Architecture Guide - XICA Tech blog

2023/07/14 18 users サイカ 鹿島 株式会社サイカ Design Doc プロセス

はじめに 皆さんこんにちは。株式会社サイカでソフトウェアエンジニアをやっている鹿島(kashitaka)です。 皆さんの開発組織では設計書（Design Doc）をどのように運用していますか？ Design Docをめぐる運用は開発組織全体の広い取り組みとしてプロセスに落とすことが難しく、チームごとに独自で運用しているなど取り組... 続きを読む

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

2023/04/17 125 users GitHub Markdown GitLab TIG真野 品質

はじめにフューチャー技術ブログのリレー形式の連載である、春の入門祭り2023の1日目です。TIG真野です。 ここ数年、Markdownで設計書をチームで書き、GitHub（GitLab）上でレビューするフローを採用しています。なるべくテキストベースで設計開発フローを統一するため、私の所属するチームでは以下のようなツールを採用... 続きを読む

【インフラ】障害事例から学ぶ設計/手順レビューの勘所 - Qiita

2022/12/17 10 users 領域 レビュー 手順書 属人化 インフラ屋さん

はじめに 設計書や手順書のレビューって最後まで残る 属人化・人のスキル次第の領域ですよね。 私の属人的知識を共有し、それを活用して2人分の属人化知識に 昇華する人が現れ、がどんどん回っていくことを願い、 The属人知識を公開します。 インフラ屋さんなので完全インフラ向け 障害事例を詳細に出すことはできないの... 続きを読む

GoogleのDesign Docsから学ぶソフトウェア設計 - Qiita

2022/06/23 271 users ドキュメント ソフトウェア 要素 Qiita ソフトウェア設計

概要 Design Documentと聞くと何を想像しますか？ 一般的にDesign Documentが指すのは設計書であることが多いのではないでしょうか。 設計書、簡単に説明するのであればソフトウェアを「どうやって作るの？」を説明したドキュメントです。 Googleではソフトウェアエンジニアリング文化における重要な要素として、今回お... 続きを読む

設計書・仕様書のレビュー方法を定めたJIS規格登場　チェック体制を標準化しやすく

2021/11/22 692 users JIS規格 観点 チェック体制 ソフトウェア 仕様書

経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「... 続きを読む

設計書・仕様書のレビュー方法を定めたJIS規格登場　チェック体制を標準化しやすく（要約）

2021/11/22 89 users 工程 観点 JIS規格化 要約 経済産業省

経済産業省が設計書・仕様書などのレビュー工程をJIS規格化標準的なレビューの工程や観点などを規定成果物の品質や開発の効率化に期待 続きを読む

設計書には何を書くべきなのか - terurouメモ

2020/07/28 272 users terurouメモ

設計とは、 要求（やりたいこと）をヒアリングする 要求を要件（何を満たさないといけないのか）に落とし込む 要件を実現するために考えられる手段を洗い出す 手段の検証を行う 検証結果を元に、どの手段を使うかを選定する 選定した手段を合意する（一部要件を満たさない事項がある場合は、代替策や妥協ラインについて... 続きを読む

日本のプログラマはレベルが低い

2020/02/02 241 users プログラマ コーダー オフ Excel方眼紙 マズ

日本のプログラマでマスを占めてるのは、大規模SIのコーダーじゃん？ そんで、そこでのお仕事はExcel方眼紙に書かれた設計書を、ひたすらプログラム言語に翻訳するだけという。 だから翻訳するために最低限の言語仕様だけ知っていれば良くて、あとはまあ上手に立ち回るコミュ力があれば上出来とされるけど、あくまでオプ... 続きを読む

SIerに生息する「おじさんSE」の生態を知る - Qiita

2019/09/11 46 users Qiita SIer コーディング 生態 エンジニア

ここでいうおじさんSEとは、主にSIerに生息する、 ・30歳以上で ・モダンな技術を知らない ・レガシーな技術しか知らない ・主に設計書などのドキュメント類を弄っており、コーディングをしない ・現状から変わる気がない（キャリアアップに対し具体的なアクションがない） 人たちを指す。 決して単に妙齢のエンジニアを... 続きを読む

SIerに生息する「おじさんSE」の生態を知る - Qiita

2019/09/10 590 users Qiita SIer コーディング 生態 エンジニア

ここでいうおじさんSEとは、主にSIerに生息する、 ・30歳以上で ・モダンな技術を知らない ・レガシーな技術しか知らない ・主に設計書などのドキュメント類を弄っており、コーディングをしない ・現状から変わる気がない（キャリアアップに対し具体的なアクションがない） 人たちを指す。 決して単に妙齢のエンジニアを... 続きを読む

MarkdownとPlantUMLでソフトウェアの仕様書や設計書を書くための環境構築手順 - EurekaMoments

2018/12/17 126 users Markdown plantUML Graphviz 仕様書

背景・目的 Markdownで書くメリット Markdown記法一覧 環境構築手順 1. Visual Studio Codeをインストールする 2. PlantUMLをインストールする 3. Javaをインストールする 4. Graphvizをインストールする 5. Markdown Preview Enhancedをインストールする 環境構築後の動作確認 Markdownでドキュメントを書く際に便利な... 続きを読む

draw.io で書いた画面設計書いてみたらストレスフリーになった 〜 続・gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ

2018/06/28 113 users GitBook フォトシンス draw.io 試行錯誤 僕自身

こんにちは フォトシンスでソフトウェア開発のマネージャーをやっている @ishturky です。 今日のエントリーは、以前書いた 「gitbookで設計書を作成したら最高だった話」の続きです。 akerun.hateblo.jp こんなコメントいただいております。 はい。これはとても悩ましいですね。僕自身もとても悩んでまさに試行錯誤して... 続きを読む

「設計書」が書けない設計者 | 日経 xTECH（クロステック）

2018/04/12 168 users xTech クロステック 日経 設計者

私の兄は建築士です。建築士の場合、例えば「森と調和する美術館」や「3世帯同居の一戸建て」などを設計する際に、そのコンセプトや予算に応じた規模、メンテナンス箇所、強度計算を含んだ「設計書」を作成し、コンペ（建築設計の競技）に臨んでいます。どうして、機械設計には「設計書」の単語がないのでしょうか？ この質問に対する私の回答はこうです。 【回答18】 恐らく、実務経験のない学者か誰かがそうした設計フロー... 続きを読む

開発とテストの段取りを工夫する | Think IT（シンクイット）

2018/02/20 18 users 区分け Think メインテーマ シンクイット 段取り

はじめに 本連載は開発を加速・効率化させる「ソフトウェアテスト」がメインテーマです。 前回 はこのテーマを実現するための全体的な戦略やアプローチを解説しました。今回は、そういった戦略やアプローチを考えるための、テストの種類や区分けを俯瞰的に解説していきます。 開発との関係から見るテストの役割 ソフトウェアテストは、テスト対象とテストベース（仕様書、設計書などテストのための資料）を入力にテストを実施... 続きを読む

エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita

2018/02/13 1319 users Qiita word Excel 本稿 前提

はじめに 時の経つのは早いもので、私がIT業界に身を置いて四半世紀になってしまいました。 その間、膨大な数の「設計書（仕様書）」を書いて来ましたが、未だに悩み・迷いは尽きません。 それでも、 亀の甲より年の劫 とも申しますので、私なりの経験則を「個人」と「チーム」の両観点でまとめてみました。 本稿で前提とする設計書は、ExcelやWordで書かれた、フォーマルな設計文書、です。 したがって、自社サ... 続きを読む

gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ

2017/12/26 416 users GitBook ishturk フォトシンス 要件 ツール

2017 - 12 - 26 gitbookで設計書を作成したら最高だった話 こんにちは。Akerunエンジニアの @ishturk です。 Akerun Advent Calendarの記事です。 今日は設計書の話です。 設計書をどんなツールで書くかは、僕らソフトウェアエンジニアの尽きない悩み（楽しみ）ですね。 最近はまったツールが最高に良かったので紹介させてください。 僕のツールに求める要件は... 続きを読む

すごい設計書 - システムに不可欠なセキュリティ対策、漏れを食い止める設計書3点セット：ITpro

2017/11/27 58 users ITpro クロスサイトスクリプティング セキュリティ対策

「セキュリティ対策はシステム開発で不可欠だが、設計書でうまく表現できている開発現場はまだ少ない」――。 ラックの永井英徳氏（エンタープライズ・セキュリティサービス事業部セキュリティディレクションサービス部長 兼 第一グループ部長）はこう指摘する。よく見られるのが、「クロスサイトスクリプティングの脅威には、Aフレームワークを利用することで対処する」などと、個別の脅威ごとに対策を記述するケースという。... 続きを読む

プログラマは裁量労働制の対象外、SEも場合によっては対象外に | スラド

2017/08/22 23 users Anonymous Coward 裁量 スラド 職種 一方

あるAnonymous Coward 曰く、 日本では同じような職種だと思われやすい「プログラマ」と「システムエンジニア（SE）」だが、SEは裁量労働制の対象である一方、プログラマは対象外であるという違いがあるそうだ（ Yahoo!ニュース ）。 プログラマは設計書に従って作業をするだけの職種で、「業務遂行の手段や方法、時間配分等を大幅に労働者の裁量にゆだねる必要がある職種」とはみなされないため。... 続きを読む

32TBにも及ぶ｢Windows 10｣のソースコードなどがウェブに流出 | 気になる、記になる…

2017/06/24 229 users 流出 ウェブ ソースコード 32TB Windows 1

The Register によると、32TBにも及ぶMicrosoftの｢Windows 10｣に関するソースコードがウェブ上に流出している事が分かりました。 流出したのは合計で32TBという巨大なファイルサイズになる公式及び非公式のインストールイメージやソフトウェアの設計書などで、今年の3月頃にMicrosoftの社内システムから密かに抽出されたものとみられています。 流出したコードなどの内容を... 続きを読む

astahで設計書とモデル、プロセスをつなぐ為の資料のリンク: プログラマの思索

2017/06/15 11 users Redmine 思索 プログラマ word Redmine大阪

astahの事例を探していた時に、設計書とモデル、プロセスをつなぐ為のアイデアが書かれた資料を見つけたのでメモ。 以下はラフなメモ書き。 間違っていたら後で直す。 【参考】 モデルへの参照を含む多様な設計情報の継続的統合ドキュメント化に向けて 【1】以前、Redmine大阪で宿口さんの講演を聞いた時、機能安全規格を満たすプロセスをRedmineで実現する話があった。 その実装方法を聞くと、Word... 続きを読む

法律用語解説｜システム開発契約（基礎編）（1）：請負契約（うけおいけいやく） - ＠IT

2017/02/07 12 users 争点 民法 細川義洋氏 原則 エンジニア

契約書に書かれている法律用語、トラブル時にIT訴訟で争点となるかもしれない契約の種類。エンジニアなら知っておきたいシステム開発契約にかかわる法律用語を、IT紛争解決の専門家 細川義洋氏が分かりやすく解説します。 請負契約とは何か 請負契約（うけおいけいやく）とは、原則として「仕事を完成させること」が支払い条件となる（※）タイプの契約です（民法第632条）。 システム開発であれば、作成した設計書やプ... 続きを読む

GUIでコンテナ仮想化ツールDockerをつかう「Kitematic」のご紹介 (1/3)：CodeZine（コードジン）

2015/10/27 63 users CodeZine Kitematic GUI ソフトウェア

本連載では、業務アプリケーション開発を行う熱血若手エンジニアのために、面倒な作業が楽になる便利なツールをご紹介します。「定時になったらスマートに帰社してアフター5を存分に楽しみたい！」や「設計書やレビューの準備に煩わされるのは嫌だ、コーディングに集中したい！」などを実現してくれる便利なツールやソフトウエアを紹介します。今回は、GUIでコンテナ仮想化ツールDockerをつかう「Kitematic」を... 続きを読む

SEの僕が業務でバリバリ使うExcel術14選＋おまけ - 技術を磨くだいぱんまん

2015/07/18 1464 users だいぱんまん donchan922 Excel 議事録 業務

2015-07-19 SEの僕が業務でバリバリ使うExcel術14選＋おまけ Web ビジネス こんにちは、だいぱんまん(@donchan922)です。SEの僕は、仕事でExcelをよく使います。報告書、設計書、議事録など、文書を作成するときには必ずと言っていいほど用います。1日の業務の中でExcelを触らない日はないほどです。それだけ触っていると、どうにか作業を効率化できないかと考えるわけです。... 続きを読む

スラッシュドットに聞け：ソフトウェア開発の現場で設計書は必須か | スラッシュドット・ジャパン IT

2015/03/03 57 users Anonymous Coward プログラマ タレ 見積もり

あるAnonymous Coward 曰く、先日、「ソフトウェアの開発における見積もり」が話題になっていたが、ふと設計書についても同様の事を感じていたのでタレコミしてみた。 以前大手SIでプログラマをしていたとき、自分一人のワンマンプロジェクトをいくつか持っており、それに加えてチームプロジェクトにプログラマとして参加していたのだが、自分のプロジェクトではプログラミング時に設計書を使う事はなかった。... 続きを読む