veyepar: User-Story Driven Docs

Hi user

Admin Login:

Name: User-Story Driven Docs
--client eric --show wtd_na_2015 --room crystal_ballroom 9720 --force
Prev: 11 The Science of Creating Unforgettable Content
Next: 11 Designing Information for Growth

show more...

Author(s):	Joao Fernandes
Location	Crystal Ballroom
Date	may Mon 18	Days Raw Files
Start	15:45	First Raw Start	15:44
Duration	00:15:00	Offset	0:00:28
End	16:00	Last Raw End	16:02
Chapters	00:00 0:00:05 0:00:25
Total cuts_time	16 min.

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

final audio

assets release.pdf UserStory_Driven_Docs.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:	At OutSystems we make an awesome development platform, but our documentation wasn't that awesome. We focused on describing each button available on the user interface, and not the user intentions and goals. A clear example of this, was that we had a full documentation page for the find text feature (CTRL+F). It described in excruciating detail every option available on the UI, but didn't told our users how they could actually find what they needed! For us it was a nightmare to maintain the docs. Our development environment was constantly changing and we couldn't keep up with the changes. More importantly, we weren't meeting the user needs. And that was clear from pages with a single-digit page view, and from the feedback we got from our customers. Due to this approach, we also ended up having page titles that were feature-oriented, which is not the best for SEO. For instance, the doc page for the find text feature was called "Find Tool". Who in their right mind would search for that on Google? In this talk I'll tell you the story of how we stopped trying to document the UI, and started creating user-story driven docs. We now focus on what the user wants to achieve and how to achieve it, independently of how many windows or buttons they need to go through. I'll cover: How you can check if you're documenting the UI, and why you should avoid doing it Why users stories work better for our users How focusing on user stories changed the culture of our team and allowed us to work on what really matters. I'll also share some unexpected outcomes, like how this lead us to work closer than ever with the development teams. Now our users get twice the cake: better features and better docs! markdown
Comment:	production notes

2015-05-18/15_44_32.dv Apply: 15:44:32 - 15:45:54 ( 00:01:22 ) S: 15:44:32 - E: 15:45:54 D: 00:01:22 show more...

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

	Raw File	Cut List
	15:44:32		seconds: 0.0 Wall: 15:44:32
Duration	00:01:22
	15:45:54		seconds: 0.0 Wall: 15:44:32
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2015-05-18/15_45_54.dv Apply: 15:45:54 - 15:45:59 ( 00:00:05 ) S: 15:45:54 - E: 15:45:59 D: 00:00:05 show more...

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

	Raw File	Cut List
	15:45:54		seconds: 0.0 Wall: 15:45:54
Duration	00:00:05
	15:45:59		seconds: 0.0 Wall: 15:45:54
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2015-05-18/15_46_00.dv Apply: 15:46:00 - 15:46:20 ( 00:00:20 ) S: 15:46:00 - E: 15:46:20 D: 00:00:20 show more...

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

	Raw File	Cut List
	15:46:00		seconds: 0.0 Wall: 15:46:00
Duration	00:00:20
	15:46:20		seconds: 0.0 Wall: 15:46:00
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2015-05-18/15_46_20.dv Apply: 15:46:20 - 16:02:28 ( 00:16:08 ) S: 15:46:20 - E: 16:02:28 D: 00:16:08 show more...

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

	Raw File	Cut List
	15:46:20		seconds: 0.0 Wall: 15:46:20
Duration	00:16:08
	16:02:28		seconds: 0.0 Wall: 15:46:20
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/15_44_32.dv
audio viz

audio viz

2015-05-18/15_45_54.dv
audio viz

audio viz

2015-05-18/15_46_00.dv
audio viz

audio viz

2015-05-18/15_46_20.dv
audio viz

audio viz

Veyepar Video Eyeball Processor and Review