Design lab 10: Writing and maintatining documentation
Thursday, 6 April 2017
Today we're going to sketch up the features that we looked at last week and write a piece of documentation for them.
In the documentation, I want to see you describe:
- What the feature does (functionally) for a user.
- Expected user inputs (what does the user do?) and program outputs (what can the user expect in response?).
- Possible errors that may result (if any) and corrective suggestions for user.
Put this all in comments on the issue that you created last week. Alternatively, you can do the work elsewhere and link to the files in the comments.
Tools for sketching
Online tools
Google Drawings https://docs.google.com/drawings
Open source tools
GNU Image Manipulation Program (GIMP) https://www.gimp.org/downloads/
Inkscape https://inkscape.org/en/download/
Closed source tools
Adobe Photoshop / Creative Suite
Adobe Illustrator