veyepar: Let’s Tell a Story: Scenario-Based Documentation

Hi user

Admin Login:

Name: Let’s Tell a Story: Scenario-Based Documentation
--client eric --show wtd_na_2015 --room crystal_ballroom 9714 --force
Prev: 11 Writer, Meet Tester
Next: 11 How to Write Documentation for People that Don't Read

show more...

Author(s):	Matt Ness
Location	Crystal Ballroom
Date	may Mon 18	Days Raw Files
Start	11:00	First Raw Start	10:40
Duration	00:30:00	Offset	0:19:54
End	11:30	Last Raw End	11:30
Chapters	00:00
Total cuts_time	28 min.

http://lanyrd.com/2015/writethedocs/sdmwxx/
raw-playlist raw-mp4-playlist encoded-files-playlist host public tweet mp4 svg png

final audio

assets release.pdf Lets_Tell_a_Story_ScenarioBased_Documentation.json
logs
Admin: episode episode list cut list raw files day marks day marks day image_files

State:
Locked:	clear this to unlock
Locked by:	user/process that locked.
Start:	initially scheduled time from master, adjusted to match reality
Duration:	length in hh:mm:ss
Name:	Video Title (shows in video search results)
Emails:	email(s) of the presenter(s)
Released:	has someone authorised pubication
Normalise:
Channelcopy:	m=mono, 01=copy left to right, 10=right to left, 00=ignore.
Thumbnail:	filename.png
Description:	To new users, complex software products can seem like dark woods on a stormy day. As tech writers, we often spend a lot of time talking about the overall shape of the forest and the variety of paths within it (conceptual docs), creating detailed catalogs of local tree species (reference docs), and providing step-by-step guides to things like “how to cross a river” or “how to knock on a door” (task-based docs). But none of that helps your customers when they just want to know how to get to Grandmother’s house, without getting lost in the forest, falling into the river, and accidentally going to the other cabin in the woods, where the lycanthropic senior citizens live. In other words, your customers need a narrative. And maybe they need lots of them. When you’re dealing with products that can be run and configured in a bewildering variety of ways, a single getting started manual might not do the trick. It’s like giving people a Choose Your Own Adventure book and only allowing them to choose one path through to the end. For my talk I’ll explain how we became aware of the need for better scenario-based documentation, and how we ended up building a prototype during a hack week project. Now we’re on our way to creating a collection of short stories that show users how to string sets of features and procedures together to solve complex problems. We’ll cover some of the things we’ve learned along the way and offer best practices for those who want to tell a few stories of their own. Matt Ness is a technical writer with over twenty years of experience at places like PeopleSoft, Oracle, and Intuit. He's currently a writer for Splunk, a leader in the machine data analytics sector. markdown
Comment:	production notes

2015-05-18/10_40_06.dv Apply: 10:40:06 - 11:01:48 ( 00:21:42 ) S: 10:40:06 - E: 11:01:48 D: 00:21:42 show more...

vlc ~/Videos/veyepar/eric/wtd_na_2015/dv/crystal_ballroom/2015-05-18/10_40_06.dv :start-time=00.0 --audio-desync=0

	Raw File	Cut List
	10:40:06		seconds: 0.0 Wall: 10:40:06
Duration	00:21:42
	11:01:48		seconds: 0.0 Wall: 10:40:06
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2015-05-18/11_01_48.dv Apply: 11:01:48 - 11:30:41 ( 00:28:53 ) S: 11:01:48 - E: 11:30:41 D: 00:28:53 show more...

vlc ~/Videos/veyepar/eric/wtd_na_2015/dv/crystal_ballroom/2015-05-18/11_01_48.dv :start-time=00.0 --audio-desync=0

	Raw File	Cut List
	11:01:48		seconds: 0.0 Wall: 11:01:48
Duration	00:28:53
	11:30:41		seconds: 0.0 Wall: 11:01:48
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

Rf filename:	root is .../show/dv/location/, example: 2013-03-13/13:13:30.dv
Sequence:
get this:	check and save to add this

2015-05-18/10_40_06.dv
audio viz

audio viz

2015-05-18/11_01_48.dv
audio viz

audio viz

Veyepar Video Eyeball Processor and Review