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

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

【初心者用】CakePHPを学んでいこう⑧（APIその２）

前回はCakePHPでTwitterAPIを使用し、ツイートを取得して画面に表示する方法を紹介しました。 今回は実際にCakePHPで、JSONデータを返却するAPI処理をご紹介いたします。

【初心者用】CakePHPを学んでいこう⑩（プラグイン）

前回はバッチ処理について、CakePHPでのバッチ処理の作成方法について紹介しました。今回はプラグインとは何か、そしてCakePHPで実際にプラグインを使用する方法をご紹介いたします。

【iOS】初めてのSwiftUI 【Part2】

【iOS】初めてのSwiftUI 【Part1】が長くなりそうだったので、Part2としてこちらに記録します。それではSwiftUIで新規プロジェクトを作成済みの状態から始めていきます。環境・MacOS Ventura 13.0・Xcode 14.2・Swift version 5.7.2

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

SwiftUIの基礎学習とUIKitとの連携【iOS】

先日SwiftUIに初めて触れてシンプルなコードでUIが実装できることにとても魅力を感じました。SwiftUIについてもっと詳しく調べたくなったので、基礎的なことを組み合わせてどんな事ができるのかもう少し詳しく調べてみたいと思います。環境・MacOS Ventura 13.0・Xcode 14.2・Swift version 5.7.2

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

自宅のwindowsでRuby on Rails（導入編）

私はこれまで、C言語、Perl、Javaを習得してきました。これらの言語は、それぞれ特定の分野で活躍している優れた言語ですが、私は今、新たにRuby on Railsを習得しようとしています。その理由について、以下に述べたいと思います。

開発計画(インフラ)

開発に必要不可欠なテスト設計書について説明！

発プロセスとして欠かすことができない工程として、「テスト工程」があります。テスト工程とは実際に作り上げたシステムが、仕様通りになっているかを確認する工程で、不具合を効率よく検出するために必要な工程となっております。その中で今回はテスト設計書について説明します。なぜテスト設計書が必要であるか、また実際にどのように作成する必要があるかまでご紹介いたします。

システムエンジニアに必要なスキルって？現役のシステムエンジニアが教えます

システム業界で活躍して数年経つと、プログラマーとしてスペシャリストになるのか、システム開発に携わる領域を更に広げてシステムエンジニアになるのか、悩まれる方も多いと思います。本記事では、システムエンジニアを目指す方や、システムエンジニアとしてキャリアを積みマネージャーとしてステップアップしたい方に向けて、現役のシステムエンジニアが必要なスキルを解説します。

キャリアアップへの最短ルート！エンジニアにおすすめのJava資格とその取得方法

Javaは、世界中で最も広く使われるプログラミング言語の1つであり、多くの企業や開発者にとって重要なスキルとなっています。Javaを使ったアプリケーション開発やWeb開発に携わるエンジニアにとって、Javaの資格取得は、より高い技術力と信頼性を証明する重要な手段の一つです。この記事では、Java資格の種類や難易度、必要学習時間、おすすめの資格について解説します。

インフラエンジニアのキャリアアップに必要な資格とは？難易度別にご紹介！

インフラエンジニアとして活躍される方々の中には、社内の保守・運用案件に配属され、やりがいを感じながらも、日々ルーティンワークに追われて成長を実感できず、将来に不安を抱く方もいらっしゃるかもしれません。そこで、本記事では、そのような方に向けて、インフラエンジニアのキャリアアップに必要な資格についてご紹介します。

Go言語で超簡単なアプリケーションを開発してみた

こんにちは、今回はGo言語を使用したアプリケーションの作成を行っていきます。Go言語はGoogleが開発したプログラミング言語で、C言語のようなシンプルな構文とJavaのような並行処理のサポートが特徴です。Go言語を使用することで、高速で安全なアプリケーションを作成することができます。それでは、実際にアプリケーションを作成する手順を見ていきましょう。

テスト自動化ツールとは？メリットデメリットやオススメツールもご紹介！

皆さんはテスト自動化ツールについてご存じでしょうか。開発プロセスにおいて必要不可欠な工程としてテスト工程がありますが、そのテストを自動化して膨大な工数を削減することができるツールとなっております。また人がテストをしていてはどうしてもミスが生じてしまいますが、テスト自動化ツールの場合は自動で行ってくれるので使い方さえ間違えなければミスが発生することはありません。特に大規模なプロジェクトになるほど効果を発揮してくれるテスト自動化ツールについて今回はご紹介いたします。