veyepar: Move Fast and Document Things: Writing internal docs at fast-moving organizations

Author(s):	Ruthie BenDor
Location	Crystal Ballroom
Date	may Tue 24	Days Raw Files
Start	10:20	First Raw Start	09:57
Duration	00:30.0:00	Offset	0:22:42
End	10:50	Last Raw End	10:57
Chapters	00:00 0:06:55
Total cuts_time	29 min.

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

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

Your new engineer started on Tuesday; your internal docs should ramp them up. Your founding engineer&#39;s last day was yesterday; your internal docs keep their projects from falling through the cracks. Tomorrow you&#39;ll switch to a project that&#39;s already in progress; internal docs should help you catch up.
Too bad your internal docs are haphazard, out of date, and mostly nonexistent. Welcome to startup life, where speed is prized above almost all.
At startups and other fast-moving organizations, the imperative to ship provides a convenient excuse to skip writing the README.md. But should we accept this as the cost of moving fast? Or can we reframe how we communicate the value of documentation so that the message resonates in startupland? Can we adapt how we practice the art of documentation so that it happens even when nobody has time?
I&#39;d like to share my successes, failures, and hard-won lessons as an engineering lead and manager who has pushed to bring writing documentation into the internal culture and practices of a startup&#39;s engineering organization.

Comment:

production notes

2016-05-24/09_57_18.ts Apply: 10:00:52 - 10:18:04 ( 00:17:12 ) S: 09:57:18 - E: 10:27:18 D: 00:30:00 (Start: 214.0) (End: 1246.0) show more...

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

	Raw File	Cut List
	09:57:18		seconds: 214.0 Wall: 10:00:52
Duration	00:30:00
	10:27:18		seconds: 1246.0 Wall: 10:18:04
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/09_57_18.ts Apply: 10:18:04 - 10:18:10 ( 00:00:06 ) S: 09:57:18 - E: 10:27:18 D: 00:30:00 (Start: 1246.0) (End: 1252.0) show more...

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

	Raw File	Cut List
	09:57:18		seconds: 1246.0 Wall: 10:18:04
Duration	00:30:00
	10:27:18		seconds: 1252.0 Wall: 10:18:10
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/09_57_18.ts Apply: 10:18:10 - 10:20:23 ( 00:02:13 ) S: 09:57:18 - E: 10:27:18 D: 00:30:00 (Start: 1252.0) (End: 1385.0) show more...

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

	Raw File	Cut List
	09:57:18		seconds: 1252.0 Wall: 10:18:10
Duration	00:30:00
	10:27:18		seconds: 1385.0 Wall: 10:20:23
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/09_57_18.ts Apply: 10:20:23 - 10:27:18 ( 00:06:55 ) S: 09:57:18 - E: 10:27:18 D: 00:30:00 (Start: 1385.0) show more...

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

	Raw File	Cut List
	09:57:18		seconds: 1385.0 Wall: 10:20:23
Duration	00:30:00
	10:27:18		seconds: 0.0 Wall: 09:57:18
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/10_27_18.ts Apply: 10:27:18 - 10:49:49 ( 00:22:31 ) S: 10:27:18 - E: 10:57:18 D: 00:30:00 (End: 1351.0) show more...

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

	Raw File	Cut List
	10:27:18		seconds: 0.0 Wall: 10:27:18
Duration	00:30:00
	10:57:18		seconds: 1351.0 Wall: 10:49:49
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2016-05-24/10_27_18.ts Apply: 10:49:49 - 10:57:18 ( 00:07:29 ) S: 10:27:18 - E: 10:57:18 D: 00:30:00 (Start: 1351.0) show more...

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

	Raw File	Cut List
	10:27:18		seconds: 1351.0 Wall: 10:49:49
Duration	00:30:00
	10:57:18		seconds: 0.0 Wall: 10:27:18
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete