aboutsummaryrefslogtreecommitdiffstats
path: root/report/report.ms
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--report/report.ms (renamed from report.ms)24
1 files changed, 17 insertions, 7 deletions
diff --git a/report.ms b/report/report.ms
index f25c210..5c3b056 100644
--- a/report.ms
+++ b/report/report.ms
@@ -6,41 +6,50 @@ Aimeric ADJUTOR
ESIEA
.AB
This document comes with a javadoc and files for a program named jMusicHub.
-Here, I'll try to state why I did some stuff the way I did and so on..
+Here, I'll try to state why I did some stuff the way I did, the tools I used, the difficulties, and so on..
.AE
+
.NH
UML Diagram
.PP
-IMAGE OF THE DIAGRAM TO PUT HERE
+You can zoom-in easily since the quality of the diagramm is great
+.
+.PSPIC ../umlDiagram/output.eps 8
+.bp
.NH
Student contribution
.PP
Since I did it alone, every part of the code has been done by myself.
.PP
-I used different kind of help when I was confronted to some errors and also to learn new things because I'm new with the Java programming language.
+I used different kinds of help when I was confronted to some errors and also to learn new things because I'm new with the Java programming language.
.PP
My main sources of knowledge comes from Stackoverflow, javaTpoint, Oracle and w3schools.
+
.NH
Work done
.NH 2
Tools
.PP
-For starters, the tools I used to program everything here are :
+For starters, the tools I used for this project are :
.IP \(bu 2
Neovim, as my text editor alongside some plugins and snippets to make my life easier.
.IP \(bu 2
Void linux, as my OS.
.IP \(bu 2
Deoplete, ultisnips and vim-javacomplete2 as my plugins.
+.IP \(bu 2
+Plantuml and groff to, respectively, generate my UML diagram and my report.
.NH 2
-The program
+Code
.PP
I coded with some freedom as the specifications were sometimes not clear. I suppose it was written this way to mimic specifications done by a client.
.PP
My "main" program is jMusicHub.java, it's basically the app you'll want to run to do anything. The other files are just the different objects that we create thanks to jMusicHub.
.PP
+The whole thing can actually be launched by using the run file (./run). It's just a simple bash program that compile (javac) and launch (java).
+.PP
Lots of commands are available so a quick peek at the help page (h) is recommended.
.NH 2
@@ -54,13 +63,14 @@ The interface used in this project is the Serializable one. It is used by Musica
Exceptions
.PP
Most exceptions are handled the same way because they appear on the same patterns.
+.PP
We basically abort the tasks or create empty objects when necessary and display something to the user to keep him up-to date.
.NH
-Difficulties and solutions given
+Difficulties
.PP
I honestly had difficulties everytime I got back on my code to build new stuff.
-The websites, given prior to this part, were really helpful to help me.
+The websites, given at the beginning, were really helpful.
.PP
The first big difficulty was to understand what was the Serialization and how to use it. It took me some time but thanks to websites and indications given by some classmates I managed to implement it in my code.
.PP