veyepar: So You Need to Document an API?

Author(s):	Allison Moore
Location	Crystal Ballroom
Date	may Mon 23	Days Raw Files
Start	11:00	First Raw Start	10:47
Duration	00:30.0:00	Offset	0:12:33
End	11:30	Last Raw End	11:47
Chapters	00:00 0:00:23 0:17:35
Total cuts_time	30 min.

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

assets release.pdf So_You_Need_to_Document_an_API_Allison_Reinheimer_Moore.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:	Documenting an API can be an intimidating process: How should you organize the documentation? How should you present the endpoint reference? What sorts of conceptual information are developers be looking for? Where to start? This talk provides the answers to these questions! We’ll go through organizational strategies for API docs and discuss ways to handle the reference, tutorial, and conceptual material you might need to produce. Throughout, we’ll focus on thinking about what the end users need and building the docs to support those goals. We’ll also look at modern tools that can make your API documentation useful, usable, and snazzy-looking, and talk about strategies for documenting APIs when you’re stuck with a publishing tool that might not be ideal for the task (Madcap Flare, for example). markdown
Comment:	production notes

2016-05-23/10_47_27.ts Apply: 10:47:27 - 10:53:02 ( 00:05:35 ) S: 10:47:27 - E: 11:17:27 D: 00:30:00 (End: 335.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/10_47_27.ts :start-time=00.0 --audio-desync=0

	Raw File	Cut List
	10:47:27		seconds: 0.0 Wall: 10:47:27
Duration	00:30:00
	11:17:27		seconds: 335.0 Wall: 10:53:02
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/10_47_27.ts Apply: 10:53:02 - 10:59:52 ( 00:06:50 ) S: 10:47:27 - E: 11:17:27 D: 00:30:00 (Start: 335.0) (End: 745.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/10_47_27.ts :start-time=0335.0 --audio-desync=0

	Raw File	Cut List
	10:47:27		seconds: 335.0 Wall: 10:53:02
Duration	00:30:00
	11:17:27		seconds: 745.0 Wall: 10:59:52
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/10_47_27.ts Apply: 10:59:52 - 11:00:15 ( 00:00:23 ) S: 10:47:27 - E: 11:17:27 D: 00:30:00 (Start: 745.0) (End: 768.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/10_47_27.ts :start-time=0745.0 --audio-desync=0

	Raw File	Cut List
	10:47:27		seconds: 745.0 Wall: 10:59:52
Duration	00:30:00
	11:17:27		seconds: 768.0 Wall: 11:00:15
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/10_47_27.ts Apply: 11:00:15 - 11:17:27 ( 00:17:12 ) S: 10:47:27 - E: 11:17:27 D: 00:30:00 (Start: 768.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/10_47_27.ts :start-time=0768.0 --audio-desync=0

	Raw File	Cut List
	10:47:27		seconds: 768.0 Wall: 11:00:15
Duration	00:30:00
	11:17:27		seconds: 0.0 Wall: 10:47:27
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/11_17_27.ts Apply: 11:17:27 - 11:30:08 ( 00:12:41 ) S: 11:17:27 - E: 11:47:27 D: 00:30:00 (End: 761.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/11_17_27.ts :start-time=00.0 --audio-desync=0

	Raw File	Cut List
	11:17:27		seconds: 0.0 Wall: 11:17:27
Duration	00:30:00
	11:47:27		seconds: 761.0 Wall: 11:30:08
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/11_17_27.ts Apply: 11:30:08 - 11:39:47 ( 00:09:39 ) S: 11:17:27 - E: 11:47:27 D: 00:30:00 (Start: 761.0) (End: 1340.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/11_17_27.ts :start-time=0761.0 --audio-desync=0

	Raw File	Cut List
	11:17:27		seconds: 761.0 Wall: 11:30:08
Duration	00:30:00
	11:47:27		seconds: 1340.0 Wall: 11:39:47
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/11_17_27.ts Apply: 11:39:47 - 11:40:10 ( 00:00:23 ) S: 11:17:27 - E: 11:47:27 D: 00:30:00 (Start: 1340.0) (End: 1363.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/11_17_27.ts :start-time=01340.0 --audio-desync=0

	Raw File	Cut List
	11:17:27		seconds: 1340.0 Wall: 11:39:47
Duration	00:30:00
	11:47:27		seconds: 1363.0 Wall: 11:40:10
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/11_17_27.ts Apply: 11:40:10 - 11:40:35 ( 00:00:25 ) S: 11:17:27 - E: 11:47:27 D: 00:30:00 (Start: 1363.0) (End: 1388.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/11_17_27.ts :start-time=01363.0 --audio-desync=0

	Raw File	Cut List
	11:17:27		seconds: 1363.0 Wall: 11:40:10
Duration	00:30:00
	11:47:27		seconds: 1388.0 Wall: 11:40:35
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-23/11_17_27.ts Apply: 11:40:35 - 11:47:27 ( 00:06:52 ) S: 11:17:27 - E: 11:47:27 D: 00:30:00 (Start: 1388.0) show more...

vlc ~/Videos/veyepar/eric/write_docs_na_2016/dv/crystal_ballroom/2016-05-23/11_17_27.ts :start-time=01388.0 --audio-desync=0

	Raw File	Cut List
	11:17:27		seconds: 1388.0 Wall: 11:40:35
Duration	00:30:00
	11:47:27		seconds: 0.0 Wall: 11:17:27
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

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