Assignment 2: Concisely documenting your overall process

Posted 26 May 2006 at 3:02pm to the Reasonate News project by David Harrison

It is good to see a number of you are diving head first into your personal website development. You must remember that the purpose of assignment 2 is to explain clearly the decisions and processes undertaken during the development of your model and renders.

 

To determine exactly what is meant by this imagine you are in practice and have just spent 4 months modelling and rendering this building but will be leaving to go overseas next week. You have to document enough so that a stranger to the project can sit down and learn what the project is all about and the processes behind it.

For example a new person to the team would have to understand:

  • The file and CAD naming standards employed
  • Who modeled what parts of the building in case there are further questions
  • How the process by which the model was built and any issues that are not yet resolved
  • Useful pieces of information that relate to the project or are generally useful to know (i.e. good rendering settings)

For the most part you have done an excellent job of recording all this information within the Reasonate blog posts. However these blogs posts are only so useful.
If you were the new person to the team you do not want to read everyone’s entire blogs to understand what has happened. What you want to do is read one concise document that has hyperlinks to the blog posts that relate to the information being discussed.


For your assignment 2 hand-in (i.e. your web-page) what you should focus on doing is putting together an html document (or set of documents) that provide this general overview of your project. This document should not recreate all the information you have already entered into your blogs. What it should do is outline the project and its processes in a clear, easy to understand manner and then within this outline provide hyperlinks to the relevant Reasonate blog posts that detail the issue.


Sorry for being deliberately vague on exactly how you should structure and word this document. What we are interested in is how you choose to tackle this problem keeping in mind that your completed work should be clear, concise and make extensive use of hyperlinks to the work you have submitted to Reasonate.


Just to give you some ideas on what is possible, you are not just limited to hyper-linking to a specific blog post (like this).
It is possible to hyperlink to all the things I tagged as funny by copying the url in the browser’s address bar.
Or if you like you could reference all the image files created by your project. To do so perform an advanced search, limiting the results to your project and only image files. On the results page click on the ‘Permalink’ button to get the url for this search in the address bar which you can then copy and paste into Dreamweaver.
If you have any questions please contact me either by posting a comment to this post or to my space in Reasonate.