Menu

#970 QuickStart Guide is NOT quick

3: Ugly
open
nobody
None
3
2018-08-10
2018-08-10
Francis Uy
No

A QuickStart Guide is supposed be a QUICK way to learn the minimal information necessary to START using the thing.

A 47 page document is not quick. Heck, a 4 page document is not quick, unless it's mostly pictures. If you need a table of contents, it's not quick.

Suggested fix:

0: Introduction: Welcome to Dr Java, the easiest way to begin programming in Java. And it's written in Java! (mind blown gif) Before you begin, you should probably know at least a little bit of Java.
1: You need the Java Development Kit (JDK) to create Java programs. Download the installer from (URL), and run it. (screenshots)
2: And you need DrJava. Download the app (hyperlinked buttons), and save it where you want.
3: Open DrJava. It automatically gives you a blank new window to write your program, or you can click Open to load your own saved programs. (screenshots)
4: Write your program, click Compile to see if it has errors (fix those), then click Run. (screenshots)
5: Or you can use the Interactions Pane to write Java statements and see the results right away. (screenshots)
6: DrJava has Find & Replace, plus advanced features like JUnit, a Debugger, and Project trees. There's also a lot of Preferences you can set.

That's it, literally. I just wrote 90% of what should be your QuickStart Guide. Everything else goes in the Documentation.

Discussion


Log in to post a comment.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.