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

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

CCNA学習＃５未経験の方向け

復習・トランスポート層（レイヤ4）とは、通信における信頼性に関するプロトコル群です。・通信の方式、通信状態の確認方法、以上発生時の対処など通信が期待通り行われるためのプロトコルを定義しています。前回までは、ホスト同士の通信IPアドレスについて、まとめていました。IPアドレスが郵便番号、ポート番号が住所でかみ砕いて理解しましょう。

その他(インフラ)

【初心者目線】Webアプリケーションの開発 第3回

【初心者目線】Webアプリケーションの開発 第3回について書きます。

【セキュリティ】脅威と対策

昨今、リモートワークの普及によりVPNの使用に関するインシデントも増えているようです。また、攻撃が巧妙化しているのもあり、セキュリティ問題について考える機会も多くなってきました。どんな脅威が増えているのか、またその対策などについて学習していきます。

テスト(IT事務全般)

自宅のWindowsでRuby on Rails ～ビューデザインの基本

「自宅のWindowsでRuby on Rails ～ Gemを理解する」では、Railsを使って簡単なWebアプリケーションを作成しました。しかし、見た目がかなり殺風景です。今回は、Railsにおけるビューデザインについて学んでいこうと思います。

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

【PowerShell】コマンド

基本的なコマンドレットやよく使うコマンドなど、学習していきたいと思います。

テスト(IT事務全般)

ネットワークの基礎①

コンピュータは、さまざまな進化や発展を遂げてきました。大型汎用コンピュータ、スーパーコンピュータ、ミニコンピュータ、パーソナルコンピュータ、ワークステーション、ラップトップコンピュータ、そして、スマートフォンと、多種多様なコンピュータが誕生してきました。年々、性能は向上しています。・大型汎用コンピュータ汎用機…メインフレームとも呼ばれている大型コンピュータです。また、ホストコンピュータと呼ばれることもあります。※TCP/IPの世界では、IPアドレスが設定されたコンピュータは、ラップトップ型のコンピュータであっても「ホスト」と呼ばれるので、混同しないように注意しましょう。・スーパーコンピュータ…計算能力が非常に高いコンピュータです。複雑な科学技術計算などに用いられます。・ミニコンピュータ…大型汎用コンピュータよりも「ミニ」サイズのコンピュータのことです。実際の大きさはタンスほどの大きさがあります。

その他(インフラ)

【初心者用】Angularについて

いままでReactのみ調べて開発に使用していたのですが、改めて他のフレームワークについて知りたいと思いまとめたいと思いました。後ほど改めて確認する際に、初心者でも理解できるようにまとめれるようにします。

その他(PG/フロントエンド)

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

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

【基本】AWSの使い方とその他

みなさんAWSを知っていますか。AWSは今どこの現場でも使われており、任天堂やフジテレビなどアプリではInstagramや漫画アプリなどでも大きく関連しており、今、AWSがないとほとんどのアプリに影響があるほど私たちの生活では必須になっております。そんなAWSについて今回はまとめました。

【初心者用】Goとは

Goという言語自体は聞いたことはあるのですが、特に何に使用されているのかよくわかっていませんでした。ですので、Goという言語が一体どういった強みがあり、どのような現場で使用されているのか学びたいと思います。

人気のJavaScriptフレームワークNext.jsを解説｜ほぼReactの進化版

今回は、Webアプリケーション開発に使われるNext.jsについて、実践形式で解説していきます。Next.jsはReact.jsをベースにしており、React.jsを学んだ人にとっては、比較的学びやすいとされています。では、早速Next.jsの基本的な使い方から見ていきましょう。