Skip to content

Commit 91cee2a

Browse files
author
mgricken
committed
User documentation update.
git-svn-id: file:///tmp/test-svn/trunk@4970 fe72c1cf-3628-48e9-8b72-1c46755d3cff
1 parent 92865dc commit 91cee2a

File tree

4 files changed

+405
-105
lines changed

4 files changed

+405
-105
lines changed

docs/src/developer/devdoc.docbook

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
<book id="index">
2222
<!-- Meta info -->
2323
<bookinfo>
24-
<date>2009-1-19</date>
24+
<date>2009-07-03</date>
2525
<title>DrJava Developer Documentation</title>
2626
</bookinfo>
2727
<toc></toc>

docs/src/developer/introduction.docbook

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434

3535
<section>
3636
<title>Project Philosophy</title>
37-
<para>DrJava is a lightweight, powerful Java development environment. Its target audience includes both beginning Computer Science students and advanced professional users. Clearly, there is a tension between these goals &mdash; "lightweight" versus "powerful"; "beginning" versus "advanced." This tension is generally resolved by <emphasis>ensuring</emphasis> the prior conditions &mdash; that DrJava be easy to use and inobtrusive for beginners &mdash; and adding "advanced" features only if they can be presented in a simple, lightweight (both in terms of system resources and user interface) manner. The interactions pane is an ideal example of a nice marriage between the goals of simplicity and power. It is easy for beginners to understand and use &mdash; in fact, it's where many beginners get their first taste of Java programming. Yet professional developers also find it quite handy, and sometimes lament the lack of something like it in heavier-weight IDEs.</para>
37+
<para>DrJava is a lightweight, powerful Java development environment. Its target audience includes both beginning Computer Science students and advanced professional users. Clearly, there is a tension between these goals --- "lightweight" versus "powerful"; "beginning" versus "advanced." This tension is generally resolved by <emphasis>ensuring</emphasis> the prior conditions --- that DrJava be easy to use and inobtrusive for beginners --- and adding "advanced" features only if they can be presented in a simple, lightweight (both in terms of system resources and user interface) manner. The interactions pane is an ideal example of a nice marriage between the goals of simplicity and power. It is easy for beginners to understand and use --- in fact, it's where many beginners get their first taste of Java programming. Yet professional developers also find it quite handy, and sometimes lament the lack of something like it in heavier-weight IDEs.</para>
3838

3939
<para>Because DrJava was originally conceived as a teaching tool, and because it has been almost entirely developed by undergraduate and graduate students, it is uniquely positioned to address the needs of students, teachers, and researchers. We hope that this fount of experience will translate into a relevant, useful, and unique product. However, development on the project is at a relative disadvantage due to the lack of a full-time or long-term workforce. These challenges are addressed by maintaining a self-documenting, self-testing code base. Developers should keep in mind that the code they write will be browsed and modified subsequently by many others, and if the reasoning behind the code is not documented by comments and tests, it will probably be lost.</para>
4040

0 commit comments

Comments
 (0)