diff options
author | Alexander Kriegisch <Alexander@Kriegisch.name> | 2024-01-30 10:00:56 +0700 |
---|---|---|
committer | Alexander Kriegisch <Alexander@Kriegisch.name> | 2024-01-30 12:39:24 +0700 |
commit | 5665de78868050d9964a315fb5e3628bd6696c62 (patch) | |
tree | 08449691b6329e02c2e86def4246f31bb4cb3823 /docs/developer/index.adoc | |
parent | e91e8f96fd620672d2fdf182a0a8708116d3464b (diff) | |
download | aspectj-5665de78868050d9964a315fb5e3628bd6696c62.tar.gz aspectj-5665de78868050d9964a315fb5e3628bd6696c62.zip |
Change directory layout to suit Antora
Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>
Diffstat (limited to 'docs/developer/index.adoc')
-rw-r--r-- | docs/developer/index.adoc | 26 |
1 files changed, 0 insertions, 26 deletions
diff --git a/docs/developer/index.adoc b/docs/developer/index.adoc deleted file mode 100644 index a358948b3..000000000 --- a/docs/developer/index.adoc +++ /dev/null @@ -1,26 +0,0 @@ -= AspectJ Design Overview -:doctype: book - -Here are some sobering words: - -"Although it is essential to upgrade software to prevent aging, changing software can cause a different form of -aging. The designer of a piece of software usually had a simple concept in mind when writing the program. If the -program is large, understanding the concept allows one to find those sections of the program that must be altered -when an update or correction is needed. Understanding that concept also implies understanding the interfaces used -within the system and between the system and its environment. Changes made by people who do not understand the -original design concept almost always cause the structure of the program to degrade. Under those circumstances, -changes will be inconsistent with the original concept; in fact, they will invalidate the original concept. Sometimes -the damage is small, but often it is quite severe. After those changes, one must know both the original design rules -and the newly introduced exceptions to the rules, to understand the product. After many such changes, the original -designers no longer understand the product. Those who made the changes, never did. In other words, *nobody* -understands the modified product." + - + -Software that has been repeatedly modified (maintained) in this way becomes very expensive to update. Changes take -longer and are more likely to introduce new 'bugs'." --- David Parnas on "Ignorant Surgery" in his paper on Software Aging - -**Table of Contents** - -* xref:compiler-weaver/index.adoc[Guide for Developers of the AspectJ Compiler and Weaver] -* xref:modules.adoc[Module Structure] -* xref:language.adoc[Language Design] |