veyepar: What Writing Fiction Teaches You About Writing Documentation

Author(s):	Thursday Bram
Location	Crystal Ballroom
Date	may Tue 24	Days Raw Files
Start	09:00	First Raw Start	08:32
Duration	00:30.0:00	Offset	0:27:35
End	09:30	Last Raw End	09:57
Chapters	00:00 0:26:15
Total cuts_time	29 min.

http://lanyrd.com/2016/writethedocs/sfbzth/
raw-playlist raw-mp4-playlist encoded-files-playlist host tweet mp4 svg png

assets release.pdf What_Writing_Fiction_Teaches_You_About_Writing_Documentation_Thursday_Bram.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:

markdown

Writing fiction and writing documentation have much more in common that typing out large blocks of text. This talk will talk about elements of fiction writing that improve the process of writing docs: Understanding audience: the tools fiction writers use to understand their audience (as well as to communicate with them) offer deeper looks at who reads what. The process of connecting with an audience is integral to fiction, but often overlooked in documentation — resulting in hard-to-use docs that don’t help users. Building story arcs: arguably, all fiction boils down to about seven different plots, retold in millions of different ways. Understanding underlying story structure makes the process of writing new tales much easier. Those story structures and plot elements can map directly to parts of documentation, as well as show options for creating standing elements for documentation. * Writing prose worth reading: documentation can be enjoyable to read, provided a writer is willing to invest time in crafting good reading material.
This talk will draw on examples from both popular fiction and documentation out in the world today.

Comment:

production notes

2016-05-24/08_32_25.ts Apply: 08:59:56 - 09:00:56 ( 00:01:00 ) S: 08:32:25 - E: 09:02:25 D: 00:30:00 (Start: 1651.0) (End: 1711.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/08_32_25.ts :start-time=01651.0 --audio-desync=0

	Raw File	Cut List
	08:32:25		seconds: 1651.0 Wall: 08:59:56
Duration	00:30:00
	09:02:25		seconds: 1711.0 Wall: 09:00:56
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/08_32_25.ts Apply: 09:00:56 - 09:01:03 ( 00:00:07 ) S: 08:32:25 - E: 09:02:25 D: 00:30:00 (Start: 1711.0) (End: 1718.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/08_32_25.ts :start-time=01711.0 --audio-desync=0

	Raw File	Cut List
	08:32:25		seconds: 1711.0 Wall: 09:00:56
Duration	00:30:00
	09:02:25		seconds: 1718.0 Wall: 09:01:03
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/08_32_25.ts Apply: 09:01:03 - 09:02:25 ( 00:01:22 ) S: 08:32:25 - E: 09:02:25 D: 00:30:00 (Start: 1718.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/08_32_25.ts :start-time=01718.0 --audio-desync=0

	Raw File	Cut List
	08:32:25		seconds: 1718.0 Wall: 09:01:03
Duration	00:30:00
	09:02:25		seconds: 0.0 Wall: 08:32:25
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/08_57_18.ts Apply: 08:59:56 - 09:00:56 ( 00:01:00 ) S: 08:57:18 - E: 09:27:18 D: 00:30:00 (Start: 158.0) (End: 218.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/08_57_18.ts :start-time=0158.0 --audio-desync=0

	Raw File	Cut List
	08:57:18		seconds: 158.0 Wall: 08:59:56
Duration	00:30:00
	09:27:18		seconds: 218.0 Wall: 09:00:56
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/08_57_18.ts Apply: 09:00:56 - 09:01:03 ( 00:00:07 ) S: 08:57:18 - E: 09:27:18 D: 00:30:00 (Start: 218.0) (End: 225.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/08_57_18.ts :start-time=0218.0 --audio-desync=0

	Raw File	Cut List
	08:57:18		seconds: 218.0 Wall: 09:00:56
Duration	00:30:00
	09:27:18		seconds: 225.0 Wall: 09:01:03
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/08_57_18.ts Apply: 09:01:03 - 09:27:18 ( 00:26:15 ) S: 08:57:18 - E: 09:27:18 D: 00:30:00 (Start: 225.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/08_57_18.ts :start-time=0225.0 --audio-desync=0

	Raw File	Cut List
	08:57:18		seconds: 225.0 Wall: 09:01:03
Duration	00:30:00
	09:27:18		seconds: 0.0 Wall: 08:57:18
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/09_27_18.ts Apply: 09:30:54 - 09:39:51 ( 00:08:57 ) S: 09:27:18 - E: 09:57:18 D: 00:30:00 (Start: 216.0) (End: 753.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/09_27_18.ts :start-time=0216.0 --audio-desync=0

	Raw File	Cut List
	09:27:18		seconds: 216.0 Wall: 09:30:54
Duration	00:30:00
	09:57:18		seconds: 753.0 Wall: 09:39:51
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/09_27_18.ts Apply: 09:39:51 - 09:57:18 ( 00:17:27 ) S: 09:27:18 - E: 09:57:18 D: 00:30:00 (Start: 753.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-24/09_27_18.ts :start-time=0753.0 --audio-desync=0

	Raw File	Cut List
	09:27:18		seconds: 753.0 Wall: 09:39:51
Duration	00:30:00
	09:57:18		seconds: 0.0 Wall: 09:27:18
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete