マニュアル作成で心がけることとは

皆さんはシステム開発現場のマニュアルや仕様書などのドキュメントに対して、どのようなイメージをお持ちでしょうか。 実際にシステム開発の現場で整備されていたマニュアルが、めちゃくちゃ役に立ったと考えているかたは、ごく少数なのではないでしょうか。 各プロジェクトで、エンジニアの入れ替わりが当たり前になった昨今では、業務マニュアルやシステムの操作マニュアルがない会社はないと言っても過言ではありません。 ・分厚くて読む気がしない ・どこに何が書いてあるのか分かりにくい ・そもそも読んでも理解できない ・プロセスやトラブルの解決策が抜けがち ・書いてある内容が古い（アップデートされていない） 上記の内容はいずれも、マニュアルが風化する原因の1つです。 裏を返せば、マニュアルを作る側が、上記のような状態にならないように気をつけるべき項目とも考えることが出来ます。 実際、多くのシステム開発の現場で、マニュアルと実際に稼働しているシステムとの情報が乖離しており、マニュアルはストレージを圧迫する邪魔な存在。だと認識されているケースが多いです。 今回の記事では、システムの操作マニュアルに関して、みなさんが実際にマニュアルを作成する場合に、分かりやすく使いやすいマニュアルを作るために心がけるべき5つのポイントについて解説していこうと思います。

製造・コーディング(PG/バックエンド)

【初心者向け】Packet Tracerでネットワークを学ぶ（ルータの設定③）

Packet Tracerでネットワークを学ぶ記事です。

詳細設計(内部設計)(インフラ)

ネットワークの基礎⑧

ネットワークの基礎⑧

その他(インフラ)

JSTQB対策(テストの基礎)

現在システムは、自動車、Webサイト、ショッピングセンターなど様々な分野で使用されています。しかし、ソフトウェアが正常に動作しないとユーザーに不都合を与え、最悪の場合障害や死亡事故が発生してしまいます。そこでシステムを開発をした後は、テストを実施して故障が発生する可能性を低くします。今回の記事では、JSTQB対策としてテストについての基本について学習します。

【JSTQB(FL)対策】第3章静的テスト

こちらの記事ではJSTQBのシラバスのうち、第3章静的テスト分野における以下の分野の学習内容及び学習してみて私が思ったことについて記載します。

テスト(運用・保守・サポート)

プロジェクト管理ツールの選び方とおすすめのツール5選

近年のビジネス環境では、複雑化するプロジェクトを効率的に管理することが成功のカギとなっています。プロジェクト管理ツールは、この複雑な課題に対応するための強力な武器であり、プロジェクトの透明性を高め、意思決定を迅速化します。しかし、プロジェクト管理ツールには様々な種類や機能があり、どれを選ぶか迷ってしまうことも多いと思います。そこで、この記事では、プロジェクト管理ツールの選び方と、よく使用されるプロジェクト管理ツールの特徴やメリット・デメリットを解説します。

【CSS】基本のまとめ | セレクター編

今回は、Webページの見た目を設定するCSSのセレクターについてまとめました。CSSは、Web開発をするにあたって欠かせない知識となっています。ぜひ最後までお読みください！

製造・コーディング(PG/フロントエンド)

【HTML】さまざまなタグ | Part 2

今回は、HTMLのさまざまなタグについてまとめました。HTMLは、Web開発をするにあたって欠かせない知識となっています。ぜひ最後までお読みください！

製造・コーディング(PG/フロントエンド)

【初心者用】AWS基礎⑦

前回はクラウドプラクティショナーの出題範囲のうちのAWSの主要サービスの識別までを学習してきました。今回はAWSの主要サービスの識別のところについて、さらに学習していきたいと思います。

その他(インフラ)

【選び方ガイド】おすすめのスマホアプリ開発言語とその将来性

スマートフォンアプリの開発に取り組む際、適切なプログラミング言語を選ぶことが重要です。しかし、初めてのプロジェクトや多くの選択肢がある中で、どの言語を選ぶべきか悩むこともあるでしょう。本記事では、スマホアプリ開発における言語選びのポイントを解説します。

基本情報技術者試験は意味ないはウソ？資格取得のメリット・試験概要・難易度を解説！

IT業界に携わるビジネスパーソンや、これからITスキルを身につけたいエンジニア候補生にとって、基本情報技術者試験は最初に挑戦したい国家試験の一つです。しかし、基本情報技術者試験は難易度が高く、合格率も低いというイメージがあります。また、最近では学校や会社で薦められて基本情報技術者試験を取得したが、全く使うシーンがなく意味がないといった声も聞きます。この記事では、なぜ意味がないと言われるのか、その理由や、エンジニアにとってのメリット、基本情報技術者試験の概要や難易度・合格方法を解説します。

単体テストとは

単体テスト(ユニットテストと呼ばれることもあります)は、プログラムを構成する比較的小さな単位(ユニット)が個々の機能を正しく果たしているかどうかを検証するテストです。通常、関数やメソッドが単体テストの単位(ユニット)となります。 プログラムが全体として正しく動作しているかを検証する結合テストは、開発の比較的後の段階でQAチームなどによって行なわれることが多いのとは対照的に、単体テストは、コード作成時などの早い段階で開発者によって実施されることが多いのが特徴です。