473,396 Members | 1,599 Online
Bytes | Software Development & Data Engineering Community
Post Job

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 473,396 software developers and data experts.

Where are you documenting program flow?

I'd like to have all of my documentation in one place. I use the following
for documenting code:
- attributes for certain types of documentation
- use of the C# generated inline XML documentation
- simple comments

I also use Visual Paradigm for UML (class relationships), which integrates
with VS.NET. I need something for general documentation of program flow.
Any suggestions on what to use for this?

I would like to keep the code and all releated documentation together. I
suppose putting the UML project and program flow documentation into a
satellite assemblies would work. I think Visual Paradigm has something for
program flow.

How are you documenting program flow and keeping all of the documentation
together?

Thanks,
Brett
Nov 17 '05 #1
1 1988
Check out NDoc on sourceforge. I believe that it will satisfy the
using of the inline XML documentation (<summary>, <remarks>,
<param=""> etc...)

It can make the resulting documentation into a static web site that
looks like javadoc or MSDN OR if you have HTML Workshop SDK installed,
it can drop it right down to a CHM. The NDoc interface to generate
the resulting documentation is very nice as well.

Hope that helps and that I'm not too off of the topic!

--Adam

On Thu, 12 May 2005 10:13:07 -0400, "Brett" <no@spam.com> wrote:
I'd like to have all of my documentation in one place. I use the following
for documenting code:
- attributes for certain types of documentation
- use of the C# generated inline XML documentation
- simple comments

I also use Visual Paradigm for UML (class relationships), which integrates
with VS.NET. I need something for general documentation of program flow.
Any suggestions on what to use for this?

I would like to keep the code and all releated documentation together. I
suppose putting the UML project and program flow documentation into a
satellite assemblies would work. I think Visual Paradigm has something for
program flow.

How are you documenting program flow and keeping all of the documentation
together?

Thanks,
Brett


Nov 17 '05 #2

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

3
by: Albert Ahtenberg | last post by:
Hello, I had some bad experience with code organization and script functionality in writing my php based applications. And as the applications get bigger in scale it gets even worse. Therefore,...
4
by: Bruce W...1 | last post by:
A scripting newbie question... I'm trying to understand some code I found. This script conducts a poll and writes the results to a text file. The following statement is part of the source file. ...
15
by: Lasse Skyum | last post by:
I have my own string class that I'm generally verry fond of compared to std::string. For that same reason I'm trying to improve a little on it. Since manny objects in my project will contain...
17
by: Jelmer | last post by:
Hi, I am mildly familiar with ms access developement and I have been asked to port and document a ms access app. I expect the porting (97 to XP) to be fairly straightforward. However documenting...
4
by: Brett | last post by:
Where is a good place to document version updates to a simple program? This isn't anything a user will see. Only developers. I was thinking of including an empty class file just for documenting...
4
by: Baron Samedi | last post by:
hi, I would like to auto-doc some existing code, mostly so I can understand it. I am slowly adding PhpDoc comments, but I miss some tools which I have for C/c++. For instance, the Code Visual...
4
by: Phillip Vong | last post by:
I'm a newbie using VS2005 to learn and test. I'm testing against the Northwind DB. I created a simple variable called "myVariable" and I assigned it the character "c". I want my SQL query to use...
6
by: Crooter | last post by:
Hello colleagues, Could anybody tell me if there are existing open-source solutions to extract the program tree using a program source code? I'm aware that GCC has program flow information and...
3
by: 100grand | last post by:
Modify the Inventory Program to use a GUI. The GUI should display the information one product at a time, including the item number, the name of the product, the number of units in stock, the price...
0
by: ryjfgjl | last post by:
In our work, we often receive Excel tables with data in the same format. If we want to analyze these data, it can be difficult to analyze them because the data is spread across multiple Excel files...
0
by: emmanuelkatto | last post by:
Hi All, I am Emmanuel katto from Uganda. I want to ask what challenges you've faced while migrating a website to cloud. Please let me know. Thanks! Emmanuel
0
BarryA
by: BarryA | last post by:
What are the essential steps and strategies outlined in the Data Structures and Algorithms (DSA) roadmap for aspiring data scientists? How can individuals effectively utilize this roadmap to progress...
1
by: nemocccc | last post by:
hello, everyone, I want to develop a software for my android phone for daily needs, any suggestions?
0
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However,...
0
by: Hystou | last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can...
0
jinu1996
by: jinu1996 | last post by:
In today's digital age, having a compelling online presence is paramount for businesses aiming to thrive in a competitive landscape. At the heart of this digital strategy lies an intricately woven...
0
by: Hystou | last post by:
Overview: Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows...
0
tracyyun
by: tracyyun | last post by:
Dear forum friends, With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.