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

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

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

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

イチから学ぶデータベース・SQL（３）では、SQLの読みやすい書き方や間違いやすいポイントなど、実務でSQLを使っていく上での基本的なことについて学習しました。今回は、前回同様paizaラーニングを参考にし、より深くSQLについて学習していきます。

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

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

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

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

【初心者用】CakePHPを学んでいこう①（基礎知識）

そもそも、PHPとは？ Cake「PHP」とあるように、そもそもPHPとは何かをまずは確認していきましょう。 PHPは、1995年に登場したWebページやWebアプリケーションを作成する際に使用するプログラム言語です。 静的なWebページを表示するHTMLとは違い、ユーザがアクセスしたタイミングによってページ内容が変化する、動的なWebページを開発することができます。 PHPを使用して作成された有名なWebサービスに、WikipediaやFacebook、ぐるなびなどがあります。

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

【初心者用】CakePHPを学んでいこう③（モデルの作成とデータ更新）

前回はCakePHPのインストールから簡単な画面表示までをご紹介しました。 今回は前回の続きとなる、簡単なModelの作成と取得したデータベースのデータを更新するところまでご紹介いたします。

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

簡単にオンライン通信を実装できるライブラリ「Socket.io」について調べてみた｜Node.js

リアルタイムWebアプリケーションにおいて、双方向通信は必須です。そのためには、WebSocketというプロトコルが使われますが、Socket.IOというライブラリを使うことで、より簡単にWebSocketを使った双方向通信を実現することができます。この記事では、Socket.IOについて分かりやすく説明していきます。

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

【初心者用】AWS基礎③

AWSの基礎レベルの知識を身につけるために、範囲に沿って学んでいきましょう。前回は、クラウドの概念、セキュリティのAWSの責任共有モデルについて学習してきました。続きからはじめていきたいと思います。

その他(インフラ)

スマホエンジニアに必要なスキルとは？役立つ資格や仕事内容もご紹介！

https://pixabay.com/ja/illustrations/%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF%E3%83%BC-%E3%82%B9%E3%83%9E%E3%83%BC%E3%83%88-%E3%83%95%E3%82%A9%E3%83%B3-1231889/

【初心者用】SQLのクエリ操作基礎１

次回の案件からSQLを使用することになったので、改めてSQLのクエリ操作について学びなおそうと思います。SQLはテストをするにも開発をするにも、使用することになるので基礎的な部分はしっかりとわかりやすくまとめます。

その他(PG/バックエンド)

【初心者用】SQLのクエリ操作基礎4

タイトル通りですが、SQL初心者がクエリ操作に関して学んだことまとめていきます。操作方法について忘れていることが分からないことが多いので、基礎を学んでいきます。

その他(PG/バックエンド)

ローコードについて(kintone)

近年、IT人材不足やクラウド技術の普及、環境の多様化などの理由から、プログラミングの知識がなくても画面や機能が作成できるローコード開発が注目されています。そこで、今回はローコード開発とローコード開発で代表的なkintoneを実際に使用してみて便利だと思った機能についての記事を作成します。

ヘルプデスクの仕事内容と必要なスキルは？エンジニアとしてのキャリアを考える

IT業界で働くエンジニアの中には、ヘルプデスクという職種に興味を持っている方も多いでしょう。ヘルプデスクの仕事は、エンジニアとしての経験やスキルを身につけるのに適しています。しかし、どのようなスキルや知識が必要なのでしょうか？また、ヘルプデスクの仕事を通じて、エンジニアとしてのキャリアをどのように築いていくことができるのでしょうか？この記事では、ヘルプデスクの仕事内容と必要なスキルについて解説します。ヘルプデスクに必要なスキルや学ぶべき知識を知りたい方は、ぜひ参考にしてください。