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

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

【五日目】Java学習

Java学習5日目

【初心者用】CCNA学習＃2OSI参照モデル

本日は、OSI参照モデルと、物理層について簡単にまとめていきたいと思います。上記の内容も、非常に大切な内容になりますので、しっかりと把握していきましょう。

その他(インフラ)

GitHub Actions でCIテスト・デプロイハンズオン

アジャイル開発ではスプリントを決めて開発を行い、修正を都度対応する必要があるため、スピード感を求められる開発現場が多い。そのため、継続的インテグレーション（CI）や継続的デリバリー/継続的デプロイ（CD)を導入し、マージやデプロイのコストを下げ、効率的な開発を実施したいが、初期導入コストや学習コストなど様々な観点から実施が見送られるケースも少なくない。今回はCI/CDを学習し、プロジェクトに対して現実的に導入する際のメリット・デメリットに関して言及していきます。

便利な【AWS】について

皆様はAWSという単語を耳にしたことはありますか。クラウドサービス世界シェア1位のAWSについて、何が便利なのか、何ができるのか、どうして使用されるのか、そういった理由をAWSにはじめて触る人にもわかりやすく調査してまとめてみました。

【初心者向け】様々なシステム開発手法

システム開発には作成するサービスやプロジェクトによって適切な開発手法がいくつかあります。今回はシステム開発の手法を数種類紹介して、それぞれの特徴や、メリット、デメリットを紹介します。下記が主な開発手法の一覧になります。　・ウォーターフォール型開発　・アジャイル型開発　・プロトタイプ型開発　・スパイラル型開発　・DevOps（デブオプス）　・リーン開発では次からそれぞれの開発手法の特徴とメリット、デメリットを紹介します。

DBの基礎と、Microsoft Accessについて

皆さんは”Access”（アクセス）という言葉を聞いたことがありますか？ Accessとは、Microsoft社が運営するツールで、主にデータ抽出、集計処理や、業務システムの開発環境や動作環境として使われております。 企業向けというよりかは個人向けのデータベースソフトですが、多機能であり、データベース以外にも、外部のデータベースを参照してデータ抽出やデータ集計をするためのBI（ビジネスインテリジェンス）ツールとしてや、帳票作成機能を活用した業務システムの開発環境、動作環境としても利用されるシーンが多いのが特徴です。 また、AccessにはVBAが標準搭載されているため、プログラミングを行うことも可能です。 プログラミングを行うことで、上記の活用方法をより高度に、より便利に実装することができます。 ただ、機能が多すぎるため、新しくAccessの使い方を習得しようとする場合は、覚えることが多い分、それだけ学習コストが高めとなっております。 今回の記事では、そんなAccessの機能と一般的なデータベース知識の紹介を併せて行っていこうと思います。

【初心者用】SQLのテーブル結合についてまとめてみた

今回は現場で使用するSQLの技術である「テーブル結合」について記事をまとめてみた。 参考サイト MySQL入門4 テーブル結合とは? 内部結合と外部結合を解説! https://snome.jp/database/db-intro-4/ 初級編10 SQL Serverのテーブル結合(JOIN)の基礎 https://kaya-soft.com/sqlserver2008-toranomaki/beginner/jointable/ 内部結合(INNER JOIN句) https://www.dbonline.jp/sqlite/join/index1.html 外部結合(OUTER JOIN句) https://www.dbonline.jp/sqlite/join/index2.html

【初心者向け】SQLの基礎について網羅的に学ぶ

WEBアプリケーション開発やスマホアプリ開発などを学ぶ際に切っても切れない関係にあるのがデータベースの知識となります。 こちらは前回の記事でざっくりと解説させて頂きましたが、今回はデータベースを操作するためのデータベース言語である、SQLについて解説した記事を書いていこうと思います。 SQLを使用することで、データベースに対して作成・更新・削除・参照などの処理を効率的に行うことが可能となります。 プログラミング言語とSQLの違いについては、プログラミング言語はJavaやPython等のコンピュータに関して指示を送るプログラミング言語なのに対して、SQLはデータベースに対して”のみ”指示を送ることが出来るデータベース言語となるので、実態としては全く別の物となります。 最初のうちは、ややこしいので理解に苦しむかもしれませんが、やっていく内に嫌でも覚えていくこととなるので、ご安心ください。 今回の記事ではSQLの基本的な部分や、データベースの選択方法などについて解説していきます！ この記事を読むことで分かること SQLの基本的な操作方法 データベースの種類 データベースの選択方法 注意点 どのデータベースを使うにしてもSQLの概念等は同じなのですが、データベースの種類によって若干書き方が異なります。 今回は代表的なSQLの書き方を紹介するので、使用するデータベースのよって書き方が若干異なることを念頭に置いて頂ければと思います。

【初心者用】HTMLとCSSで出来ること

.

【初心者用】PHPフレームワーク、CakePHPについて

今回の記事では、PHPの代表的なフレームワークの一つであるCakePHPとは何か？について解説していこうと思います。 CakePHPはPHPをいうプログラミング言語のフレームワークです。 PHPとは、簡単に言うと高難易度と言われているC言語の設計を模倣しながらもC言語よりも文法が簡易的な点から、初心者にオススメされている人気プログラミング言語です。 そのPHPの機能を部分的にパッケージ化したものが、今回紹介するCakePHPというフレームワークになります。

【初心者用】Javaのループ処理についてまとめてみた

ループ処理とは、ループ（繰り返し）の名前の通り、同じ処理を繰り返し実行させる処理のことです。 全く同じ処理を繰り返させるだけであれば、大した仕事はできないのですが、ループ処理の中で変数の値を変化させたり、ループ処理の中にさらにループ処理を加えて入れ子にしてみたりすることで、複雑な処理をこなせるようになります。 今回は、Javaで使われるループ処理について、以下の４種類の文法を調べたので、それらについて説明していきたいと思います。