Programming Portfolio

From Studyplace

Overview

The programming portfolio is a reflection on six key concepts of Object Oriented Programming. It should contain a discussion of the concepts, illustrated with actual Java code from our project. When possible, try to use code that you have worked on significantly, but it's appropriate and encouraged to use code from other parts of the project as well.

You may choose to use both positive and negative examples. "The following is a good example of encapsulation because... [insert example]" or "When I was working on this portion of the project, I did not have a good understanding of inheritance yet. Looking at this portion of the code it could be improved by ...".

Format

While there are no strict requirements for format, I know that some students like to have guidelines to follow. Here are some guidelines

• use a fixed width font (e.g. Courier) for all code examples (this is the only actual requirement on this list)
• feel free to write in a style of personal reflection on your learning process
• try to copy only relevant portions of code, not full .java or .jsp files
• if you omit code for clarity, use a //comment to indicate what was omitted
• include at least an introduction, a section for each of the concepts, and conclusion
• include examples 'inline', not as appendices
• feel free to create diagrams if you want to illustrate flow or relationships (of course, you are free not to)
• refer to outside sources when you discuss the concepts
• feel free to use standard code examples from other sources, but do not feel bound to do so
• how many pages? as long or as short as it takes to write a concise but complete paper :)
  • roughly about 10-15 pages should cover it, including examples
  • half a page to two pages is enough of a discussion for each concept
• submit in an electronic format (pdf, html, doc, open office, rtf, txt, pages, ...), or
• post your portfolio on this wiki -- I encourage students to do this in the spirit of open research and scholarship, but it is certainly not required, understandable why you may choose not to, and will not affect your grade in any way

Resources

• use the Study Tab to include additional resources, ask questions, and generally add more information to this topic
• see the Programming Concepts pages for an overview of the topic areas (abstraction, objects, ...)