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

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

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

【五日目】Java学習

Java学習5日目

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

【三日目】Java学習

Java学習3日目

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

イチから学ぶデータベース・SQL（７）

イチから学ぶデータベース・SQL（６）では、サンプルデータベースに登録されているデータから合計や平均などの計算をしていきました。 今回も、これまでと同様にpaizaラーニングを参考にし、オンラインRPGを題材としてSQLについて学習していきます。

製造・コーディング(インフラ)

イチから学ぶデータベース・SQL（１０）

イチから学ぶデータベース・SQL（９）では、サブクエリについて学習していきました。 今回も、これまでと同様paizaラーニングを参考に、オンラインRPGを題材としてSQLについて学習していきます。

製造・コーディング(インフラ)

AADとAADCについて

Azure Active Directory(以下Azure AD)とは、Microsoftが提供するクラウドベースで「認証」と「許可」を一元管理するサービスです。Azure ADで認証を行えば、連携しているシステムにログインなしでアクセスできるようになります。Azureアカウントで、他のクラウドサービスが利用できます。例：Dropbox、Slackなど

その他(インフラ)

ネットワークセキュリティの重要性と技術

インターネットの発展に伴い、インターネットを悪用する側の技術も進歩しています。「利便性」と「安全性」を両立させるために多くの技術革新が進んでいます。ネットワーク技術に加え、セキュリティ関連の技術に対しても、正しく理解して、適切なセキュリティポリシーを作成し、管理・運用することが重要になってきます。ネットワークセキュリティの重要性と技術について学習していきたいと思います。※セキュリティポリシーとは、企業や組織が定める、情報の取り扱いやセキュリティ対策についての考え方などを統一し、明文化したものになります。

テスト(IT事務全般)

システム開発で行うテスト工程と概要のまとめ

開発するシステムの品質を担保するために開発工程に応じてシステムのテストを行う必要があります。開発工程ごとに行うテストではどのようなものがあるのか、そこではどのようなことを行うのかを説明します。「ウォータフォール型開発」と「アジャイル型開発」の開発手法がありますが、ここでは「ウォータフォール型開発」の手法に絞って説明します。

ネットワークの基礎⑥

TCP/IPネットワークでよく使われるデータリンクであるイーサネット、無線LAN、PPPなどについてさらに学習していきます。

その他(インフラ)

ネットワークの基礎⑦

前回、PPPについて触れてきました。さらにPPPについての学習とその他のデータリンクについても学んでいきましょう。

その他(インフラ)

ファンクション（関数）を使ったデータ操作の基礎

他の言語では取得する結果に対して何かしらの処理を行うファンクション（関数）が用意されています。SQLでも同様にファンクション（関数）が用意されています。そこに絞ってデータの操作について記載していきます。

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

人気のRubyフレームワークを徹底比較！

Rubyの世界では、フレームワークの選択がプロジェクトの成功に大きな影響を与えます。多様なフレームワークが存在する中で、それぞれの特性を理解し、プロジェクトに最適なものを選ぶことは、時には難しい課題となることでしょう。特に、フリーランスのエンジニアにとっては、求人や案件で特定のフレームワークの経験が求められることが一般的です。これにより、適切なフレームワークの知識とスキルは、より良い機会と高い報酬を引き寄せる要因ともなります。Ruby on Railsは、Rubyのフレームワークとして広く知られていますが、他にも多くの優れたフレームワークが存在します。それぞれのフレームワークは、特定の用途や状況に適しており、その選択はプロジェクトのニーズによって変わります。この記事では、Rubyのフレームワークの概要と、それぞれの特徴を深掘りします。また、現在のトレンドや、各フレームワークの利点と欠点、そしてどのような状況で最適なのかについても詳しく解説します。これにより、あなたのプロジェクトやキャリアに最適なフレームワークの選択を、より簡単に、そして的確に行うことができるでしょう。