質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

新規登録して質問してみよう
ただいま回答率
85.50%
SVN

SVNは、CollabNet社が開発したソースコードなどを管理する集中型のバージョン管理システムです。 Subversionとも呼ばれ、CVSの問題点を解決すべく開発された次世代のバージョン管理システムとして開発されました。基本的なコマンドはCVSと共通しています。複数人の開発者が共同でひとつのソフトウェアの開発にあたるときなどに、ドキュメント及びソースコードなどを管理するのに使用されます。

Q&A

解決済

1回答

939閲覧

効率的なシステムの保守、運用環境について

koara_san

総合スコア8

SVN

SVNは、CollabNet社が開発したソースコードなどを管理する集中型のバージョン管理システムです。 Subversionとも呼ばれ、CVSの問題点を解決すべく開発された次世代のバージョン管理システムとして開発されました。基本的なコマンドはCVSと共通しています。複数人の開発者が共同でひとつのソフトウェアの開発にあたるときなどに、ドキュメント及びソースコードなどを管理するのに使用されます。

0グッド

0クリップ

投稿2020/01/15 00:53

前提

社内SEで自社開発をしています。
各部署、業務ごとの運用に適したシステム(アプリ)が100個近くあり、
そのシステムの保守、改修、新規アプリ作成をしています。

アプリの状態
・アプリの規模は2人月~6人月くらいの小さいものがほとんど
・入力画面が数画面あって、各種情報をDBに登録するアプリ
・C#で開発
・ソースはSVNで管理
・ドキュメントはあったり、無かったり、古かったり
・利用者からの要望で改修することがある
・開発は利用者の意見を聞き、プロトタイプで利用してもらい
ながら開発をしている。アジャイルに近い。ウォーターフォールではない。

本来は、ドキュメントとソースを管理、維持してく必要がありますが、
アプリ数が多く、今の人員ではドキュメントの保守はできず、
改修案件がるたびに、ソースを追っています。

汎用的なシステムを購入し、統一することも検討しましたが、
それぞれのアプリの入力IF、DB構造が大きく異なるため、挫折しました。

現在、試みていること

維持できそうなドキュメント(運用フロー、テーブル定義、データフロー)に
絞り、維持し、全体の概要をドキュメントで把握し、後はソースを見ることで、
少しでも開発工数を削減することを試みています。

質問

具体的な質問で申し訳ありませんが、
ちょっとでも、保守しやすい環境を構築するための何か案、ヒントをご教授頂けると助かります。
ヒントになるような事項でも結構ですので、意見をもらえると助かります。

例)
この書籍を読んでみたら
こんなソフト(redmine、JIARなど)で管理してみたら
こんなドキュメントの自動化ソフトでも利用してみたら
こんな運用にしてみたら

気になる質問をクリップする

クリップした質問は、後からいつでもMYページで確認できます。

またクリップした質問に回答があった際、通知やメールを受け取ることができます。

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

guest

回答1

0

ベストアンサー

C#ならば、「XMLドキュメントコメント」を書いていますか?
ソースコードとドキュメントを一緒に書いた方が捗ると思います。

そして、ドキュメント化にはdoxygenオススメ。
doxygenの使い方を調べると、doxygen流のコメントの書き方がありますが、上記のXMLドキュメントコメントも認識してくれます。

投稿2020/01/15 11:32

katsuko

総合スコア3462

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

あなたの回答

tips

太字

斜体

打ち消し線

見出し

引用テキストの挿入

コードの挿入

リンクの挿入

リストの挿入

番号リストの挿入

表の挿入

水平線の挿入

プレビュー

15分調べてもわからないことは
teratailで質問しよう!

ただいまの回答率
85.50%

質問をまとめることで
思考を整理して素早く解決

テンプレート機能で
簡単に質問をまとめる

質問する

関連した質問