File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
http://aspose.com/file-tools
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic

README.txt - insane or not?

 
Pete Lyons
Ranch Hand
Posts: 109
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
After seeing Sam get failed for apparently missing some mundane detail, I'm panicking about this instruction:
The names of the files you have submitted, with a note of their location in the directory structure, and a high level description of the purpose of each
Do I really need to list ALL files, even .class files and the html from the javadoc? (a la 'find build -name "*.class"') Why is Sun taking my money and then wasting so much of my time on this outright silliness? What is my high level purpose description supposed to read, "Holds java bytecode to be run by the virtual machine"? Did anyone pass with something reasonable like:
build - holds compiled class files
Thanks.
 
John Smith
Ranch Hand
Posts: 2937
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator

Do I really need to list ALL files, even .class files and the html from the javadoc?

I listed all files, but I put a description for only critical ones: server.jar, client.jar, db.db, README.txt, DesignChoices.txt, UserDoc.txt. For the rest of the files, I put in a simple description for each group:
javadoc files:
list of .html files here
compiled source:
list of .class files here
...
etc.
I lost 1 point on documentation, but I don't think it was because of the format of my readme.txt.
Eugene.
 
Sam Stackly
Ranch Hand
Posts: 109
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Here is mine
a. FBNClient.jar: Client application
b. FBNServer.jar: Server application
c. FBN.policy: Policy file, which need to client and sever execution
e. DesignChioces.txt: my Design Choices for this asignment
f. Devassnmt2.jar: Original jar file from Sun Microsystem.
g. db.db: Database file
h. source.jar: source files of my application
i. FBNDoc.jar: Jar file for FBN documentation
I don't know what I missed though

Sam
 
Pete Lyons
Ranch Hand
Posts: 109
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Did you use some goofy format? I currently just have something like:
Sectionlabel:
item
item
item
Secitionlabel:
etc.
 
Sandra Baker
Greenhorn
Posts: 26
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
I think the reason there are some many confusions and panic is that Sun thought they have pretty clear instructions but people actually understand things in different ways..... I don't agree what they simply throw a FAIL to candidate without a single comment or feedback.
I think we deserve at least 3-5 sentence explaination. Remember, we spend $400 for the exam, and countless hour of hardworking....
Maybe the accessor just received a pink slip, and tried to do something destuctive.... . Hey, you never know....trust me, human behavior is unpredictable......Okay. What I am trying to say is email them ask for their comments. Otherwise, you will spend a lot of time guessing. You have done enough work already..... its their turn.
[ September 24, 2002: Message edited by: Sandra Baker ]
 
Sam Stackly
Ranch Hand
Posts: 109
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator

I think we deserve at least 3-5 sentence explaination. Remember, we spend $400 for the exam, and countless hour of hardworking

That's exactly what I said, The funny part is I got error page instead of detail page for two days (creating a simple web page!! Doohh) but after two days there was no comment on detail page
Well anyway I hope you guys get through this assignment without anyproblem and good luck

Sam
 
Abhinav Anand
Ranch Hand
Posts: 113
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Hi guys,
I am listing my files in the following way:
Directory: Docs (Contains documentation files)
design choices.txt
client_manual.txt
server_manual.txt
Directory: Docs\api (API spec. for submission)
1.html Javadoc generated api
2.html "
3.html "
4.html "
............
Directory: executables (executables for the assignment)
client.jar client executable jar
server.jar server executable jar
policy.fbn policy file.
db.db database file.
Directory: suncertify\client (client source files)
xx.java
uy.java
.....
So guys, you can see that i am listing each and every file in my assignment, and i am providing a high level description for each and every of them. I don't want to take any chance regarding this issue, so i am listing each and every file. I hope the examiners will be satisfied.
Any sugetions,
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic