IT Request: Log Changes to ASP code

[LoisC.]

I do contract development on a large public site for a city government agency.
The IT department , in response to the site hanging randomly, wants me to
start documenting my process/code changes. Yuck! (The site comes back up when
the server is re-booted) I have never heard of ASP code doing something like
this. One consultant suggested that it was the Access database --- that it
needs to be de-fragmented.

Does anyone have similiar experience? What is the deal w/documentation? Am
I completely naive? What about the site hanging?

[Alexandro Colorado]

On Wed, 23 Mar 2005 15:19:57 +0000 (UTC), LoisC.
<webforumsuser@macromedia.com> wrote:

> I do contract development on a large public site for a city government
> agency.
> The IT department , in response to the site hanging randomly, wants me
> to
> start documenting my process/code changes. Yuck! (The site comes back
> up when
> the server is re-booted) I have never heard of ASP code doing something
> like
> this. One consultant suggested that it was the Access database --- that
> it
> needs to be de-fragmented.
>
> Does anyone have similiar experience? What is the deal
> w/documentation? Am
> I completely naive? What about the site hanging?
>

Yes documentation of process is one of the things involved with quality
assurance and documentation supervision that is usually done by large
organizations who would need to audit their work (not just work).

There are many tools to provide either a textual documentation or a real
time doucmentation. The options is to use a CVS or SVN tree which keeps a
version of all your files and you can perform rollback in time. This
versioning system allows you to see which code was created, eliminated, by
whom and which result did it provoqued.

SVN [url]http://subversion.tigris.org/[/url]
CVS [url]http://www.gnu.org/software/cvs/[/url]

Other type of documentation is doing a project blog (journal) where you
can save comment and document the procedual milestones of your project.

Finally another uselful side is commenting the code since it also saves
time on locating what do what. You can also learn the netiquette of code
comenting by knowing what NOT to do here:
[url]http://mindprod.com/unmaindocumentation.html[/url]

--
Alexandro Colorado
------------------------------
Support Engineer
InterAKT Online
[url]http://www.interaktonline.com[/url]
Tel: 40(21) 312.5312

[LoisC.]

:)

Alexandro,

Thanks very much for your info... I appreciate it! Ahhh... the things I would have learned had I gone to school for this instead of being self-taught!

L

[Alexandro Colorado]

On Thu, 24 Mar 2005 14:18:40 +0000 (UTC), LoisC.
<webforumsuser@macromedia.com> wrote:

> :)
>
> Alexandro,
>
> Thanks very much for your info... I appreciate it! Ahhh... the
> things I would have learned had I gone to school for this instead of
> being self-taught!
>
> L
>

There is nothing wrong with being self-taught, except that you need to be
a good teacher and student at the same time :)


--
Alexandro Colorado
------------------------------
Support Engineer
InterAKT Online
[url]http://www.interaktonline.com[/url]
Tel: 40(21) 312.5312