veyepar: Ignorance is Strength: Writing Documentation by Learning as You Go

Author(s):	Amalia Hawkins
Location	Crystal Ballroom
Date	may Mon 05	Days Raw Files
Start	11:00	First Raw Start	10:54
Duration	00:40:00	Offset	0:05:50
End	11:40	Last Raw End	11:42
Chapters	00:00 0:07:16 0:17:20
Total cuts_time	21 min.

http://conf.writethedocs.org/8
raw-playlist raw-mp4-playlist encoded-files-playlist host public tweet mp4 svg png

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

When your company’s codebase is large, complicated, and mostly undocumented, there is a huge burden to bring new hires up to speed — not to mention facilitate communication between distributed teams. How can you leverage the knowledge of experienced engineers — and the ignorance of new engineers — to guide your efforts and create a valuable resource?

At MongoDB, we now have the Hitchhiker’s Guide to the Codebase, an internal documentation resource covering everything from an introduction to our build tool to detailed explanations of internal server mechanisms. Content is contributed by engineers across the company, based on their frustrations and requests from other engineers, and edited by volunteers. The most valuable content is often written by engineers who had to struggle through learning about those topics on their own.

I’ll talk about how I started this initiative without any knowledge or power, how I recruited volunteers, and the impact this has had on productivity at our company.

Comment:

production notes

2014-05-05/11_14_42.dv Apply: 11:14:42 - 11:21:58 ( 00:07:16 ) S: 11:14:42 - E: 11:22:08 D: 00:07:26 (End: 7:16) show more...

vlc ~/Videos/veyepar/eric/wtd_na_2014/dv/crystal_ballroom/2014-05-05/11_14_42.dv :start-time=00.0 --audio-desync=0

	Raw File	Cut List
	11:14:42		seconds: 0.0 Wall: 11:14:42
Duration	00:07:26
	11:22:08		seconds: 436.0 Wall: 11:21:58
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

2014-05-05/11_22_08.dv Apply: 11:22:10 - 11:32:14 ( 00:10:04 ) S: 11:22:08 - E: 11:32:14 D: 00:10:06 (Start: 2) show more...

vlc ~/Videos/veyepar/eric/wtd_na_2014/dv/crystal_ballroom/2014-05-05/11_22_08.dv :start-time=02.0 --audio-desync=0

	Raw File	Cut List
	11:22:08		seconds: 2.0 Wall: 11:22:10
Duration	00:10:06
	11:32:14		seconds: 0.0 Wall: 11:22:08
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete