[Year 12 SofDev] User Documentation

Thu Jun 30 11:50:34 EST 2011

Thanks Claudia,

I have switched from IT Apps to SD this year,.

Last year in Year IT Apps .... Unit 4 .... Outcome 2. .... Students had to create online user documentation. My Students used Camstudio to create video tutorials and save in a format that could be viewed after clicking on a hyperlink in the spreadsheet.

I thought I could do the same with a visual basic form with a button instead of a hyperlink.

I thought students could elect to do either a word document or a video tutorial.

Regards

Ken Bell

From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Claudia Graham
Sent: Thursday, 30 June 2011 11:14 AM
To: Year 12 Software Development Teachers' Mailing List
Subject: Re: [Year 12 SofDev] User Documentation

Hi Ken,

The area of study mentions 'preparing user documentation', the KK16 mentions printed, online, content sensitive and manuals, KS5 is the only place it directly mentions 'write' user documentation.

The assessment guide states 'develop user documentation that is appropriate for the intended use and audience of the software solution', and 'User documentation is appropriate, logically sequenced, complete and accurate. Presentation is clear and consistent with generally accepted conventions'

So it reads like the appropriateness/content (for intended use - based on design brief) of the user doc is important and that it meets accepted conventions (for the type of user documentation being produced). However, the time factor would be important for me, creating a multimedia/movie vs a word document, I know which I'd choose for my class.

Regards

Claudia

*********************************************************************
Claudia Graham
VCE Coordinator
9334 0049 (direct)

From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Bell, Kenneth C
Sent: Thursday, 30 June 2011 9:21 AM
To: Year 12 Software Development Teachers' Mailing List
Subject: Re: [Year 12 SofDev] U4O1 practice - Class Data task solution

Hi Claudia and all,

Page 45 does not specifically say what software so I would like to ask this question about creating user documentation.

Last night, I created a Multimedia Player form (Program 20 from Adrian Barnes Visual Bais.NET for Education book).

I then created a main form to load this Multimedia Player form when a button is pressed.

My question is this.  "Can the User Documentation be in the form on an online video which you watch or does it have to be something that has to be read?"

Regards

Ken Bell
Mortlake College
(1sr year at Software development)

From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Claudia Graham
Sent: Wednesday, 29 June 2011 2:17 PM
To: Year 12 Software Development Teachers' Mailing List
Subject: Re: [Year 12 SofDev] U4O1 practice - Class Data task solution

Hi all,

Just a clarification,  there is still an expectation that user documentation is created and software is used to create it.
This appears in KK for the outcome and in the assessment guide.  It is also on pg. 45 where it indicates the software tools to be used for each outcome.
You could not just ask test questions about user documentation.

I do agree though that you would not be spending too much time on it, as you do need to think of the weighting of marks across the assessment tool.
Regards
Claudia

*********************************************************************
Claudia Graham
VCE Coordinator
9334 0049 (direct)

From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Matheson, Heath A
Sent: Wednesday, 29 June 2011 12:54 PM
To: Year 12 Software Development Teachers' Mailing List
Subject: Re: [Year 12 SofDev] U4O1 practice - Class Data task solution

Hi Juliana,

The user documentation component is task 2 of the outcome. This is stated as needing to be a test or written report and only worth 15 out of the 60 marks so should be much faster to complete than task 1 . I think most will do a test as the more exam type practise students get the better, and tests are easy to correct and out of the way in one class. This report/test also needs to cover security and legal issues such copyright, privacy acts etc.  For task 1  (the program) only internal documentation is required.

Heath

From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Juliana Pang
Sent: Wednesday, 29 June 2011 10:16 AM
To: 'Year 12 Software Development Teachers' Mailing List'
Subject: Re: [Year 12 SofDev] U4O1 practice - Class Data task solution

Well Mark said we still need the input form, and the validation for that as well. Would that be enough scope then?

It's much nicer to use a 2D array and text file then when we tried to connect an Access database to the VB front end previously. That was messy and huge.

What are you all using for the user documentation? Is it suffice to ask students to make a simple "online help" website using Dreamweaver? In previous years I have asked them to compile the help file webpages using HTML help or something like that, created an index, and produced a .chm file. That was an overhead and students ended up spending more than the 10 periods allocated for U4O1.

Juliana Pang
Maths/Information Technology Teacher

East Doncaster Secondary College
20 George Street   East Doncaster  Victoria   3109   Australia
p:  +61 3 9842 2244    f:   +61 3 9841 8010
w:   www.eastdonsc.vic.edu.au<http://www.eastdonsc.vic.edu.au>
e:    pang.juliana.c at edumail.vic.gov.au<mailto:pang.juliana.c at edumail.vic.gov.au>

[Logo2010_KB.png]

From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Kent Beveridge
Sent: Wednesday, 29 June 2011 9:12 AM
To: Year 12 Software Development Teachers' Mailing List
Subject: Re: [Year 12 SofDev] U4O1 practice - Class Data task solution

Is this all that's needed for the solution to this outcome? Seems 'not much' given what my background is..(I kinda expected 'pages' of code compared to this...).

Or do I just set the bar too high???

btw...I like the code Juliana has produced..nice!  Its even in VB which makes(for me) it even better...

I knew jumping on this list would reveal some gems! I look forward to sharing when I make my own...

Kent.

Kent Beveridge
ICT Co-ordinator, St.Brigids CSC, HORSHAM,Vic,Aus.
kbeveridge at stbc.vic.edu.au<mailto:kbeveridge at stbc.vic.edu.au>

________________________________
From: sofdev-bounces at edulists.com.au [sofdev-bounces at edulists.com.au] on behalf of Juliana Pang [pang.juliana.c at edumail.vic.gov.au]
Sent: Tuesday, 28 June 2011 2:47 PM
To: 'Year 12 Software Development Teachers' Mailing List'
Subject: Re: [Year 12 SofDev] U4O1 practice - Class Data task solution
Thanks for the task Mark - it's been pretty interesting and I have gotten my students to start working on this.

I have created a sample solution, it's little different to yours as I asked the students to make the text file as:

Alex,56,45,78
Beth,100,98,95
Colin,56,79,82
Darcy,97,89,60
Egbert,62,71,62

So the records are going sideways and the scores are already percentages.

There's no input forms yet on mine for the teacher to add more students.

By the way, for the actual U4O1 task, do we need some sort of input form where students will write to a text file, as they are marked on validation techniques?

Juliana Pang
Maths/Information Technology Teacher

East Doncaster Secondary College
20 George Street   East Doncaster  Victoria   3109   Australia
p:  +61 3 9842 2244    f:   +61 3 9841 8010
w:   www.eastdonsc.vic.edu.au<http://www.eastdonsc.vic.edu.au>
e:    pang.juliana.c at edumail.vic.gov.au<mailto:pang.juliana.c at edumail.vic.gov.au>

[Logo2010_KB.png]

From: sofdev-bounces at edulists.com.au [mailto:sofdev-bounces at edulists.com.au] On Behalf Of Kent Beveridge
Sent: Tuesday, 28 June 2011 9:27 AM
To: Year 12 Software Development Teachers' Mailing List
Subject: Re: [Year 12 SofDev] U4O1 practice - Class Data task solution

Leather trumpets and Camels????

Man, this is an odd one!

KB.

Kent Beveridge
ICT Co-ordinator, St.Brigids CSC, HORSHAM,Vic,Aus.
kbeveridge at stbc.vic.edu.au<mailto:kbeveridge at stbc.vic.edu.au>

________________________________
From: sofdev-bounces at edulists.com.au [sofdev-bounces at edulists.com.au] on behalf of Mark KELLY [kel at mckinnonsc.vic.edu.au]
Sent: Monday, 27 June 2011 6:17 PM
To: Year 12 Software Development Teachers' Mailing List
Subject: [Year 12 SofDev] U4O1 practice - Class Data task solution
Where's my speaking trumpet? Hello folks. Calling folks.

Attached is a VB 2010 solution to the class data task for U4O1 that I upped earlier. It contains sample code, screenshot of the form, and a text data file.

May your camels be bountiful, but not too cute: that way madness lies.

Mark

--
Mark Kelly
Manager of ICT, Reporting, IT Learning Area
McKinnon Secondary College
McKinnon Rd McKinnon 3204, Victoria, Australia
Direct line / Voicemail: +613 8520 9085, Fax +613 9578 9253
kel at mckinnonsc.vic.edu.au<mailto:kel at mckinnonsc.vic.edu.au>
VCE IT Lecture Notes: http://vceit.com
Moderator: IT Applications Edulist<http://www.edulists.com.au/>

Want a good time? Call 0112358. Ask for Mr Fibonacci.

Click here<https://www.mailcontrol.com/sr/wQw0zmjPoHdJTZGyOCrrhg==> to report this email as spam.

This message has been scanned for malware by Websense. www.websense.com<http://www.websense.com/>

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.

________________________________

A dual campus, coeducational Prep to Year 12 school.  Delivering consistently high academic results in Melbourne's North West for over 24 years.

www.overnewton.vic.edu.au<http://www.overnewton.vic.edu.au>

Keilor Campus  I  2-30 Overnewton Road Keilor, Victoria, 3036  I  T  03 9334 0000  I  F  03 9336 1835
Taylors Lakes Campus  I  39 - 57 Robertsons Road Taylors Lakes, Victoria, 3038  I  T  03 9334 0000  I  F  03 9390 5144

2011 College Theme  I  Making Connections  I

Consider the environment before choosing to print this email.

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.

________________________________

A dual campus, coeducational Prep to Year 12 school.  Delivering consistently high academic results in Melbourne's North West for over 24 years.

www.overnewton.vic.edu.au<http://www.overnewton.vic.edu.au>

Keilor Campus  I  2-30 Overnewton Road Keilor, Victoria, 3036  I  T  03 9334 0000  I  F  03 9336 1835
Taylors Lakes Campus  I  39 - 57 Robertsons Road Taylors Lakes, Victoria, 3038  I  T  03 9334 0000  I  F  03 9390 5144

2011 College Theme  I  Making Connections  I

Consider the environment before choosing to print this email.

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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.edulists.com.au/pipermail/sofdev/attachments/20110630/2cd1bf8b/attachment-0001.html 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.png
Type: image/png
Size: 187 bytes
Desc: image003.png
Url : http://www.edulists.com.au/pipermail/sofdev/attachments/20110630/2cd1bf8b/image003-0001.png 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image007.png
Type: image/png
Size: 8295 bytes
Desc: image007.png
Url : http://www.edulists.com.au/pipermail/sofdev/attachments/20110630/2cd1bf8b/image007-0001.png 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image008.jpg
Type: image/jpeg
Size: 2069 bytes
Desc: image008.jpg
Url : http://www.edulists.com.au/pipermail/sofdev/attachments/20110630/2cd1bf8b/image008-0001.jpg 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image009.png
Type: image/png
Size: 187 bytes
Desc: image009.png
Url : http://www.edulists.com.au/pipermail/sofdev/attachments/20110630/2cd1bf8b/image009-0001.png 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image010.jpg
Type: image/jpeg
Size: 2069 bytes
Desc: image010.jpg
Url : http://www.edulists.com.au/pipermail/sofdev/attachments/20110630/2cd1bf8b/image010-0001.jpg 