[Year 12 SofDev] RE: SOFTWARE DEVELOPMENT User DocumentationQuestion.

Fri Oct 17 17:38:59 EST 2008

Perhaps Paula could have reworded her response to be more positive towards Anthony.

For example

    Selecting an aspect of the solution for which user documentation is being written is fine . 

    The key skill for this aspect of the outcome states that students should be able to 'write appropriate user documentation'.

    Providing that there is sufficient scope for the student to show attributes that you would typically expect to see in appropriate documentation such as an awareness of users' needs and completeness of the instructions.

ie what Anthony has done is fine, ok, appropriate, . . . .

So why not say so clearly?

Robert Hind (Semi-retired)
Ex Traralgon and Ashwood

  ----- Original Message ----- 
  From: Christophersen, Paula P 
  To: Year 12 Software Development Teachers' Mailing List 
  Sent: Friday, October 17, 2008 5:28 PM
  Subject: [Year 12 SofDev] RE: SOFTWARE DEVELOPMENT User DocumentationQuestion.

  Hi Anthony and colleagues

  The key skill for this aspect of the outcome states that students should be able to 'write appropriate user documentation'. By selecting an aspect of the solution for which user documentation is being written is fine providing there is sufficient scope for the student to show attributes that you would typically expect to see in appropriate documentation such as an awareness of users' needs and completeness of the instructions. 

  Regards

  Paula

------------------------------------------------------------------------------

  From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Ciappara, Anthony A
  Sent: Friday, 17 October 2008 5:02 PM
  To: Year 12 Software Development Teachers' Mailing List
  Subject: SOFTWARE DEVELOPMENT User Documentation Question.

  Hi Paula

  I have just spent some time going through the study design and assessment guides to check that I have covered everything with my Software Development class.

  I have a question with regards to Unit 4, Outcome 1, Task 2. For part of this task, I asked my students to create user documentation for part of the software application that they created for Task 1. It was a VB front end that worked with an Access database. 

  The user doc that they wrote probably took the average student 1.5-2 hrs and involved instructing the user how to do a member search using a variety of methods, how to scroll through the search results and what output to expect. They were able to demonstrate logical sequence, accuracy, comprehensibility and presentation as the assessment guide required. 

  I did not ask them to create user doc for the whole application as I felt this was quite onerous and would not have allowed them to demonstrate anything that they could not demonstrate in the task that I set.  Is this OK or should I get them to complete user doc for the entire application?

  Regards

  Anthony Ciappara

------------------------------------------------------------------------------

  From: sofdev-bounces at edulists.com.au on behalf of Christophersen, Paula P
  Sent: Wed 1/10/2008 11:43 AM
  To: Year 12 IT Applications Teachers' Mailing List; Year 12 Software Development Teachers' Mailing List
  Subject: [Year 12 SofDev] Exam covers on VCAA website

  Dear colleagues

  The following link will take you to the exam covers for IT applications and Software development.

  http://www.vcaa.vic.edu.au/vce/exams/examcovers/Oct_Nov_2008/2008OctNovexamcovers.html

  Regards

  Paula

  Paula Christophersen

  Acting Manager, VCE Curriculum Unit

  VCAA

  41 St Andrews Place

  EAST MELBOURNE 3002

  +61 3 9651 4443

  Important - This email and any attachments may be confidential. If received in error, please contact us and delete all copies. Before opening or using attachments check them for viruses and defects. Regardless of any loss, damage or consequence, whether caused by the negligence of the sender or not, resulting directly or indirectly from the use of any attached files our liability is limited to resupplying any affected attachments. Any representations or opinions expressed are those of the individual sender, and not necessarily those of the Department of Education and Early Childhood Development.

  _______________________________________________ 
  http://www.edulists.com.au IT Software Development Mailing List kindly supported by 
  http://www.vitta.org.au/vce/studies/infotech/softwaredevel3-4.html - Victorian Curriculum and Assessment Authority and 
  http://www.vitta.org.au - VITTA Victorian Information Technology Teachers Association Inc 

  Important - This email and any attachments may be confidential. If received in error, please contact us and delete all copies. Before opening or using attachments check them for viruses and defects. Regardless of any loss, damage or consequence, whether caused by the negligence of the sender or not, resulting directly or indirectly from the use of any attached files our liability is limited to resupplying any affected attachments. Any representations or opinions expressed are those of the individual sender, and not necessarily those of the Department of Education and Early Childhood Development.

  _______________________________________________ 
  http://www.edulists.com.au IT Software Development Mailing List kindly supported by 
  http://www.vitta.org.au/vce/studies/infotech/softwaredevel3-4.html - Victorian Curriculum and Assessment Authority and 
  http://www.vitta.org.au - VITTA Victorian Information Technology Teachers Association Inc 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.edulists.com.au/pipermail/sofdev/attachments/20081017/80a69f03/attachment.html