Source Code Archive

[armsys]

Has anyone archived their source in UR?
I find it may be a good idea but unsure if anyone has tried it. If you do, please share your experience with us. I suppose it's highly plausible.
Otherwise, how do you document and archive thousands of subroutines, procedures, functions, modules, objects, methods, events, properties,...etc.
Thank you.

Armstrong

[zargron]

Originally posted by armsys
Has anyone archived their source in UR?

Yes & no. I have been through the pandora of "thorough source documentation" and come out the other side a little battered and bruised. Overall i found the reward too meager for such efforts. I focus on "software management", using UR of course. I create a separate UR database for each software topic (eg. application, suite of related applications). I create main branches for things like:
* Ideas
* Documentation
* Publishing
* Strategy
* Design

Each "software" database becomes my main repository for material associated with a specific application. If i fix a (simple) bug, i might not update the database. If i do an enhancement, i update design, documentation and so forth before/during/after the modifications. I focus on concepts and modularity in the repository, allowing comments in source code to handle documentation of granular aspects. BTW: I manage the work load (projects / TTD) for all applications in my "core" PIM database.

Wouldn't it be wicked if there was an easy way to have syntax highlighting within UR? Then perhaps i would delve into the possibility of linking my UR database to source code files. (I use the "Folder" item to document and point to locations of source files and program resources.)

[armsys]

Originally posted by zargron
Yes & no. I have been through the pandora of "thorough source documentation" and come out the other side a little battered and bruised. Overall i found the reward too meager for such efforts. I focus on "software management", using UR of course. I create a separate UR database for each software topic (eg. application, suite of related applications). I create main branches for things like:
* Ideas
* Documentation
* Publishing
* Strategy
* Design

Each "software" database becomes my main repository for material associated with a specific application. If i fix a (simple) bug, i might not update the database. If i do an enhancement, i update design, documentation and so forth before/during/after the modifications. I focus on concepts and modularity in the repository, allowing comments in source code to handle documentation of granular aspects. BTW: I manage the work load (projects / TTD) for all applications in my "core" PIM database.

Wouldn't it be wicked if there was an easy way to have syntax highlighting within UR? Then perhaps i would delve into the possibility of linking my UR database to source code files. (I use the "Folder" item to document and point to locations of source files and program resources.)

For documentation, I develop my own Access database to keep tracks all sort of documents, including URDs of course. As far as I'm concerned, for documentation, it requires highly structured database. In fact, in my case, nearly all things are prioritized, including authors, publishers, document types,....etc. As a result, I can always re-prioritize. In this case, UR may not be helpful.

But for source code, it's highly plausible. It's impossible for me to memorize all objects, RegEx expressions, SQL statements,...etc.

Armstrong

[teratorn]

Originally posted by armsys
For documentation, I develop my own Access database to keep tracks all sort of documents, including URDs of course. As far as I'm concerned, for documentation, it requires highly structured database. In fact, in my case, nearly all things are prioritized, including authors, publishers, document types,....etc. As a result, I can always re-prioritize. In this case, UR may not be helpful.

This isn't making any sense to me, really... UR *is* a
highly structured database... How exactly can you
document things better in Access (of all things), than in
UR?

But for source code, it's highly plausible. It's impossible for me to memorize all objects, RegEx expressions, SQL statements,...etc.
Armstrong

I would say it is highly IMPLAUSIBLE to manage source
code with UR, since it is not designed for this highly
specialized task.

There are already an endless number of products for
managing source code.

Install Cygwin and learn to use common UNIX command-line
utilities like 'grep' and 'ctags' to locate things in your
code base. Or browse your source with an IDE of some
kind.

For actually managing the code itself you need a
revision control system (RCS). Just get an open-source
one.... I really like darcs and bzr. But if you must, you
can use SVN (it's most popular, but declining every day
due to not being distributed in nature). git is also pretty
good, I hear. TortoiseSVN is a project to look at, if only
because it integrates so nicely with Windows Explorer.

[armsys]

Hi teratorn,
I know nothing about any product mentioned by you. I've done some homework and find them very interesting, especially TortoiseSVN. In my case, I just use UR to store small segments of code I use often but can't remember.
Thanks.
Armstrong