Rapport sur votre projet de programmation
Votre rapport sur votre projet de programmmation devra
décrire l'interface utilisateur que vous avez
réalisée. Rédigez le rapport en simple
interligne, en suivant les sections ci-dessous, et en respectant
le maximum d'espace pour chaque section ci-dessous (notez: les
figures que vous rajoutez ne comptent pas dans l'espace
maximum). Envoyer votre rapport final au prof via un message
courriel ayant UNE seule pièce jointe qui est votre rapport
en format PDF (*PAS* Microsoft
Word, pas de documents .zip, .rar, .7z, ou autres, et pas de
courriels contenant un lien vers votre document sur un
serveur Dropbox / Google Docs / etc.). Ne mettez pas de page
couverture ni de table des matières. Indiquez
simplement votre nom et prénom, le sigle du cours, la
session (2014 hiver), et un titre pour votre projet ("Exemple:
Interface de courriel 3D") en haut de la première page de
votre rapport, ensuite sur la même page présentez
votre Résumé suivi de votre section Introduction
etc.
-
[3 points] Un résumé qui décrit
brièvement le projet et la contribution ou le
résultat ou ce qu'il y a de novateur. (Longueur: maximum
5 phrases). Un lecteur potentiel devrait pouvoir
lire le résumé et juger faciliment s'il veut
prendre le temps de lire le rapport au complet ou nom.
- [10 points] Une introduction qui donne la mise en
contexte (Quel est le domaine d'application?) et la motivation
(Pourquoi réaliser ce projet? Est-ce que c'est pour vous
permettre d'apprendre quelque chose, ou bien pour
répondre à un besoin?). Discutez aussi de
quelques travaux/articles/références/produits
antérieurs ou reliés
(citez et discutez au moins deux articles
académiques reliés à votre projet).
Si votre projet de programmation se distingue des travaux
antérieurs ou des logiciels déjà
disponibles, expliquez en quoi votre logiciel sera novateur.
(Longueur de cette section: entre un paragraphe et une page,
sans compter les figures s'il y a lieu).
Voici une façon de rédiger l'introduction:
commencer par parler un peu de l'état de l'art ("Les
clients de courriel modernes ont plusieurs
fonctionnalités permettant la recherche, le tri, le
filtrage automatique [...] [citez quelques
références comme exemples de l'état de
l'art, et/ou montrer une figure en exemple]") et ensuite
mentionner une lacune ou un défi dans l'état de
l'art ("Toutefois, les utilisateurs du courriel éprouvent
souvent des difficultés à retrouver et naviguer
dans des conversations qui comprennent plusieurs messages et
plusieurs sujets différents mais reliés [...] [si
possible, citez des références qui discutent de ce
défi ou cette problématique]"), ensuite
résumer de quelle façon votre nouvelle interface
est conçue pour résoudre le problème ("Ce
rapport présente une nouvelle solution interactive pour
visualiser les anciennes conversations ...")
Une autre façon de motiver votre projet dans
l'introduction est de parler de vos connaissances en
programmation et votre désir d'apprendre un nouveau
langage ou API comme raison pour le projet. Vous devez
quand même citez au moins deux articles académiques
reliés à votre projet.
-
[10 points] Une description de votre conception ou approche
et les raisons pour votre conception/approche;
peut-être une analyse des possibilités de
conception
ou une analyse des avantages et des inconvénients de
différentes approches. Une partie de l'évaluation
de cette section sera basée sur votre capacité
de faire preuve d'analyse et de raisonnement,
et de justifier les décisions que vous allez pris
dans la conception de l'interface, même si en bout de
ligne vous vous rendez compte
que votre idée de conception originale n'était
peut-être pas très bonne.
Donc, il serait souhaitable de faire une analyse qui, par
exemple, identifie, discute, et compare
différentes possibilités de conception, ou
différents systèmes
existants, pour motiver et justifier la conception et l'approche
que vous adopterez
dans votre interface.
(Longueur: entre un paragraphe et une page et demi, sans
compter les figures s'il y a lieu).
-
[8 points] Une description plus détaillée de votre
implementation. Brièvement, quelques
détails sur le langage de programmation utilisé,
libraries, plateforme, système d'exploitation, sources de
données s'il y a lieu. Ensuite, peut-être des
détails sur l'architecture ou les algorithmes
particuliers que vous avez utilisés dans votre programme
si vous trouvez ces détails pertinents (vous pouvez
laisser tomber des détails "triviaux"). (Longueur de
cette section: entre un paragraphe et une page de texte,
sans compter le pseudo-code s'il y a lieu). Une partie de
l'évaluation de cette section dépendera du
défi technique
représenté par le projet,
et
de l'habileté technique que vous avez
démontrée. Si vous pensez que votre projet
manque de difficulté technique, parler de ce
qu'était votre point de départ (exemple: vous
n'avez pas programmé depuis 5 ans, ou bien vous n'avez
jamais programmé dans ce langage avant) et parler aussi
de ce que vous avez appris sur le plan technique.
- [4 points] Vos résultats (avec captures
d'écran montrant l'interface).(Longueur: entre quelques
phrases et une page de texte, sans compter les captures
d'écran.)
- [4 points] Une conclusion. Résumer ce que
vous avez réussi à faire, et répéter
ce qu'il y a de novateur dans le projet ou ce qu'est votre
contribution principale s'il y a lieu. Peut-être
parler des leçons de conception que vous avez
retirées du projet. (Maximum une demi-page).
-
[4 points] Une liste de directions pour l'avenir ou
d'idées pour améliorer le projet
ou continuer le travail (maximum une demi-page).
-
Une section de remerciements s'il y a lieu.
Remercier ceux qui vous ont aidé.
-
Vos références (qu'elles soient des
articles, des sites web, etc.). Je m'attends, bien sûr,
à ce que vous suivez un format cohérent pour les
références. Pour un article académique, ne
donnez pas juste un URL: nommez les auteurs, le titre, la
conférence ou journal, et l'année.
- Code source en annexe à la fin du même
document PDF. Votre code source ne sera pas noté, mais je
demande toutefois une copie
du code que vous avez écrit. Vous n'avez pas besoin
de mettre le code source des libraries que vous n'avez pas
écrits. Si vous n'avez pas tout écrit le
code source dans votre annexe, indiquez clairement ce que vous
avez écrit et ce que vous n'avez pas écrit.
Vous pouvez utiliser une police plus petite dans cette section
pour éviter de prendre beaucoup de pages.
En plus des points attribués pour les sections ci-dessus, il
y aura une correction négative (points enlevés) pour
les fautes de grammaire, d'orthographe, de références
mal formées, de mauvais utilisation de paragraphes, la
qualité des figures, manque de respect pour les limites sur
les longueurs des sections, et manque de respect pour la forme
demandée de soumission (un seul fichier PDF sans fichier zip,
rar, etc).
Vous n'avez pas besoin d'écrire des sections ayant toujours
la longueur maximale pour obtenir tous les points. Votre
rapport peut-être plus court, mais s'il présente
clairement votre projet et justifie vos choix de conception avec des
explications logiques, et si en plus vos idées sont
originales, vous pourrez obtenir tous les points.
Je me réserve le droit de demander
une démonstration de votre système
si je le juge nécessaire.
Évitez soigneusement toute forme de plagiat,
ou même la possibilité de donner l'impression d'un
plagiat,
dans votre projet et votre rapport.
Si vous utilisez une idée, une librarie, un outil,
un algorithme, du code source, des données,
des images, des fichiers, un gabarit,
ou autres choses d'un autre auteur, indiquez le clairement dans
votre rapport
et expliquer comment vous l'avez utilisé ou modifié.
Ne risquez pas de donner l'impression que vous avez
créé quelque chose que
vous n'avez pas en faite créée par vous même.
Il est tout à fait normal pour les étudiants et les
chercheurs d'utiliser les idées,
les résultats,
et les outils
des autres pour bâtir de nouveaux résultats et faire
des nouvelles découvertes;
mais il faut toujours bien citer ses sources et remercier ceux qui
nous ont aidés
de façon appropriée.
Si vous citer une partie du texte d'un article, évidemment,
indiquer que c'est une
citation et donner la source de la citation.
Il existe plusieurs moyens pour un professeur de détecter
des cas de plagiat,
et lorsque ces cas arrivent, c'est une situation grave
qui sera traîtée sévèrement.