マニュアル作成で心がけることとは
皆さんはシステム開発現場のマニュアルや仕様書などのドキュメントに対して、どのようなイメージをお持ちでしょうか。 実際にシステム開発の現場で整備されていたマニュアルが、めちゃくちゃ役に立ったと考えているかたは、ごく少数なのではないでしょうか。 各プロジェクトで、エンジニアの入れ替わりが当たり前になった昨今では、業務マニュアルやシステムの操作マニュアルがない会社はないと言っても過言ではありません。 ・分厚くて読む気がしない ・どこに何が書いてあるのか分かりにくい ・そもそも読んでも理解できない ・プロセスやトラブルの解決策が抜けがち ・書いてある内容が古い（アップデートされていない） 上記の内容はいずれも、マニュアルが風化する原因の1つです。 裏を返せば、マニュアルを作る側が、上記のような状態にならないように気をつけるべき項目とも考えることが出来ます。 実際、多くのシステム開発の現場で、マニュアルと実際に稼働しているシステムとの情報が乖離しており、マニュアルはストレージを圧迫する邪魔な存在。だと認識されているケースが多いです。 今回の記事では、システムの操作マニュアルに関して、みなさんが実際にマニュアルを作成する場合に、分かりやすく使いやすいマニュアルを作るために心がけるべき5つのポイントについて解説していこうと思います。
製造・コーディング(PG/バックエンド)
【ソフトウェアテスト】ソフトウェア開発とテスト活動について ①
ソフトウェアはほとんどの場合、複数の機能を組み合わせてシステムを構築し、さまざまなシステムをまとめたものを運用する想定で開発プロジェクトが進行します。Webシステム開発、アプリケーション開発、組み込みシステム開発など、開発プロジェクトにもそれぞれ種類はありますが、アプリケーションに付随するWebサービスを展開する場合にWebシステムを開発したり、組み込みシステムと連携するアプリケーションを展開する場合にアプリケーション開発をするなど、複数のサービスやプラットフォームが関連しているのがソフトウェアの現状であり、開発プロジェクトもそれに伴って複雑で多様な関係性の中で進行していきます。このため、何か一つを開発して終わりとなることはほとんどなく、開発プロジェクトの開始・終了・進行中に至るまで、そのほか複数の開発プロジェクトの進行も関連してきます。とはいえ、多くのプロジェクトが相互に関連しながら進行しているとしても、プロジェクト進行の工程という点でいうならば、サービスやシステムの企画と検討に始まり、リリース後の継続的な運用保守から運用の終了に至るまでを一つのサイクルとして、開発プロジェクトは段階を経て進行していくといえます。
テスト(運用・保守・サポート)
【PowerShell】業務効率化
仕事の中で、業務を効率化していきたいと思う人も多いでしょう。業務効率化ができるPowerShell について学習していきたいと思います。コマンドプロンプトやバッチファイルとの違いや、どんな場面で使えるのか確認していきましょう。
テスト(IT事務全般)
【初心者用】Pythonでスクレイピングをしてみよう
前回の記事で、Pythonのプログラムを実行するための環境構築について解説しました。 今回の記事では、Pythonで出来る作業の代表格でもあるスクレイピングを実際に行い、プログラミングのイメージを可視化していければと思います。 前回の記事で構築した、Jupyter Notebookを使っていきます。
製造・コーディング(PG/バックエンド)
【初心者用】Pythonが何なのかメリット・デメリットの面からまとめてみた
タイトル通りですが、Python初心者が勉強してみて感じたことをまとめていきます。 なるべく初心者にもわかりやす～いように専門用語をなるべく省いたり嚙み砕いたりしつつ説明します。
製造・コーディング(PG/バックエンド)
【初心者用】Angularについて
いままでReactのみ調べて開発に使用していたのですが、改めて他のフレームワークについて知りたいと思いまとめたいと思いました。後ほど改めて確認する際に、初心者でも理解できるようにまとめれるようにします。
その他(PG/フロントエンド)
【初心者】基本情報はおすすめ
「基本情報（FE）レベルの知識がある人材がほしい」私が経験半年の駆け出しエンジニアの頃、転職活動の際に言われた言葉です。「学生のうちにITパスポートと基本情報を取っておけば就活で評価される」私が学生（情報理工系、偏差値45ぐらい）の時にとある教授が口酸っぱく言っていました。「ITパスポートも大事だけど取得していてもあまりネタにされない」「未経験のエンジニアは基本情報を取って初めて評価されるみたいな」エンジニアが集う交流会で会った、実務5年以上の先輩が言っていました。この”基本情報”という資格、結構大事だそうです。本記事では、基本情報はおすすめだということを話していきます。
学習・スキル
【ゼロから始めるAI】巷で噂のAIを触ってみたい 第1回
よく話題に挙がる「AI」というものAI（人工知能）は、ChatGPTの登場以来、「会話ができるAIが誕生した！」とSNSやメディアで大きな注目を集めてきました。今では企業が業務に取り入れ始めており、社内チャットに導入したり、テスト工程で画像認識を活用したりと、すでにAIは社会に欠かせない存在となりつつあります。私のエンジニアの友人の中には、「このままではAIに仕事を奪われるかもしれない……」と危機感を抱く人も出てきています。さらに、ゲーム開発の分野でもAIを活用した取り組みが話題になるなど、AIの可能性はどんどん広がっています。とはいえ、世間でこれだけ話題になっていても、「AIって何となく分かるけど、実際の使い方までは分からない……」という人も多いのではないでしょうか。実は、私自身もその一人です。だったらいっそ、自分で触って、理解を深めてみよう！ そう思い立ったのがこの企画の始まりです。AIを趣味や仕事に活かすヒントを探しながら、ゼロからAIについて学んでいきたいと思います。このシリーズでは、「とにかく簡単に始めてみる」をテーマに、AIの基礎から実際の使い方まで、やさしく解説していきます。
初心者
【初心者用】オブジェクト指向におけるカプセル化について
カプセル化とは、オブジェクト指向における考え方の一つです。 オブジェクト指向については、他サイトで色々と説明が為されておりますが、調べるのが億劫な方は、ざっくり「各々の細かい処理を別クラスに分けて部品化し、メインとなるクラスからそれらを呼び出すという考え方」程度には認識しておいてください。 今回は、カプセル化とはどういった考え方か、その具体例を交えて説明していきたいと思います。
製造・コーディング(PG/バックエンド)
関連タグ
カテゴリ別人気記事
もっと見るテレワーク関連人気記事
2023年10月02日
製造・コーディング(PG/フロントエンド)2023年07月18日
アーキテクト・技術選定(PG/バックエンド)2023年11月17日
学習・スキル2023年10月26日
テスト(運用・保守・サポート)2023年01月09日
詳細設計(内部設計)(インフラ)
週間人気記事
もっと見る【これからJP1に触れる人向け】JP1とは
開発プロジェクトに携わる際にJP1というツールに触れたことはあるだろうか。JP1は開発工程、特にテスト作業においては非常に利便性の高いツールである。この記事ではまだJP1に触れたことがない人向けにJP1の概要やJP1を合う買う際に知っておくべき用語を取り上げる。
テスト(運用・保守・サポート)
ネットワークエンジニアの将来性と市場の需要 | キャリアアップに必要な3つの要素
企業のデジタル化が進む現代社会において、ネットワークエンジニアの仕事は、市場の高い需要と共に、その将来性も見込まれています。その一方で、ネットワーク技術は日々進化し、新たなセキュリティ課題も常に出現しており、これらの変化に対応するため、ネットワークエンジニアは自身のスキルを常にアップデートしたり、最新のインフラ知識が求められます。ネットワークエンジニアとして成功するためには、継続的な学習と新しい技術への適応、必要なスキルを身につけ、ネットワークエンジニアとしての価値を高めることが大切です。本記事では、ネットワークエンジニアとして求められる需要や将来性、そして長く活躍するために必要なスキルや知識について詳しく解説していきます。
キャリア
今後必ず需要が伸びるクラウドエンジニアについてご紹介！必要な知識もご紹介します
近年、自社でサーバーを持たずにクラウドサービスを利用してアプリケーションを構築する形態が多くなっております。その中で需要が増えてきているのがクラウドエンジニアとなります。クラウドエンジニアとは、ネット上のクラウドサービスを利用してシステムの構築や保守を行う、クラウドサービスに特化したエンジニアを指します。これまではサーバーやネットワークといったハードウェアを自社にて調達、設置したうえでアプリケーションを構築・運用する形態が一般的でした。これらはオンプレミス環境と呼ばれており、現在でも多くの環境がオンプレミス環境となっております。一方で最近ではクラウドサービスの導入を検討する企業が多くなっております。より多くの企業がクラウドサービスを採用するようになるため、クラウドエンジニアの需要は今後必ず伸びていきます。一方でクラウド技術も発展途上ということもありますが、クラウドサービスに長けたクラウドエンジニアもまだまだ少ないのが現状です。ネットワークエンジニアやサーバーエンジニアはクラウド化の進行に併せて、これまで培ってきたサーバーの構築知識やネットワーク技術を活かしながら、クラウドへの理解を深めることが求められるでしょう。そこで今回はクラウドエンジニアについてご紹介していきながら、必要となる知識についてもご紹介していきます。
学習・スキル
クラウドサービスについて
クラウドとは、クラウドコンピューティングの略で、ユーザーがサーバーやネットワークなどのインフラやソフトウェアを持たなくてもインターネットと介してサービスを受けることが可能になる仕組みです。自分のコンピューターにソフトウェアをインストールせず、ウェブブラウザなどを使ってシステムを利用します。ソフトウェアを動作させるITリソースやサービスはすべてクラウドベンダーが所有しており、ユーザーはそれらをインターネット経由で利用します。クラウドサービスでは、ソフトウェアの場所やデータ保管先はインターネット上の見えないところにあるので、システムの構成図を表す際に、雲（＝クラウド）のマークを使っていたため、「クラウド」と呼ばれるようになったと言われています。
その他(インフラ)
クラウドサービスとセキュリティ対策
クラウドサービスにおけるセキュリティ対策について話していきます。近年、クラウドサービスを利用する企業が増加しています。利用する理由として、「資産、保守体制を社内に持つ必要がない」「場所、機器を選ばずに利用できる」「安定運用、可用性が高くなる」などの声があるようです。しかし、「セキュリティ面」での不安を抱えて、クラウドサービスを利用するのはためらうという声が多いのも事実です。安全にサービスを活用するために、サービス提供事業者を選ぶ際のポイントや、セキュリティ対策について紹介していきます。
その他(インフラ)
【初心者向け】Packet Tracerでネットワークを学ぶ（CLI操作の基本編①）
ルータ初期設定編ではPacket Tracerを使ってルータを直接操作し色々な設定を試してみたいと思います。 まずCisco製品のルータにはPCと同様にOSがインストールされています。 それが「Cisco IOS(Internetwork Operating System)」です。 スイッチでもこのOSを利用しています。 Cisco IOSはWindowsのようなグラフィカルなインターフェースではなくコマンド入力のみで様々な操作を行うインターフェースになります。 コマンドで操作するインターフェースのことを「CLI(Command Line Interface）」と言います。
詳細設計(内部設計)(インフラ)
AWSエンジニアの仕事内容とは？転職に必要なスキルやポイントを解説！
IT業界では、日々新しいトレンドや技術が生れていますが、その中でも常に注目を浴びているのが「クラウドコンピューティング」の分野です。そのクラウドコンピューティングの中心に位置するのがAWSと言われています。しかし、AWSエンジニアになるには、何から始めれば良いのか、どのようなスキルや知識が必要なのか、インフラエンジニア初心者には分からないことも多いでしょう。この記事では、AWSエンジニアになるための、基礎知識や転職に必要なスキルやポイントをまとめていますので、AWSエンジニアの転身を考えている方の参考となれば幸いです。
学習・スキル