Skip to content

Commit fb563e6

Browse files
authored
Merge pull request #78 from justwriteclick/dlc-vids
Adds a collection of video presentations from Write the Docs since 2015
2 parents d19f48c + 480a580 commit fb563e6

4 files changed

Lines changed: 57 additions & 14 deletions

File tree

.travis.yml

Lines changed: 0 additions & 13 deletions
This file was deleted.

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,16 @@
22

33
## The Website
44

5-
This website is intended to offer stories and articles about how to treat docs like code, and lessons learned along the way.
5+
This website is intended to offer stories and articles about how to treat docs like code, and lessons learned along the way. You are welcome to tell your story here as well.
66

77
## To Contribute
88

99
You can directly submit a pull request using the fork-and-pull workflow to add an article, or submit to the [justwriteclick/docs-like-code-stories](https://github.com/justwriteclick/docs-like-code-stories) repo if you want to follow a question-and-answer template.
1010

11+
Pushing to the `build` branch lets you preview the build output using Netlify. You must log into Netlify to view the preview deploy.
12+
13+
Pushing to the `master` branch builds output to https://www.docslikecode.com using Netlify. Auto publishing is on as a setting in Netlify, so deploys from master are published automatically.
14+
1115
## Theme Colophon
1216
Theme courtesy of https://mmistakes.github.io/so-simple-theme/
1317

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
layout: post
3+
title: Video Presentations about Docs Like Code
4+
excerpt: "In the last three years of Write the Docs conferences, you can learn from others experiences using docs like code techniques."
5+
modified: Sat Jan 6 10:29:44 CST 2018
6+
categories: articles
7+
author: anne_gentle
8+
tags: [writethedocs, video, conferences, github, git, collaboration, transformation]
9+
image:
10+
feature: wtd-eur-2017.jpg
11+
credit: Flickr writethedocs
12+
creditlink: https://flic.kr/p/LqxXHE
13+
comments: false
14+
share: true
15+
youtubeIdJodie: Mzu-c-FoOdw
16+
youtubeIdPanel: Y2TGwUPb8R4
17+
youtubeIdMargJen: JvRd7MmAxPw
18+
youtubeIdRachel: dHdBsNxtKeI
19+
youtubeIdRiona: EnB8GtPuauw
20+
---
21+
22+
In the new year I want to keep learning more about docs like code, and I know that I've learned a lot from the Write the Docs community and presentations.
23+
24+
Top of mind for me right now is that the 2018 conference in Portland Oregon is in May, 6-8 to be exact, and the [call for proposals closes next Wednesday](http://www.writethedocs.org/conf/portland/2018/cfp/), January 10, 2018. You can register and buy your ticket - or tickets for your whole team - [online now](http://www.writethedocs.org/conf/portland/2018/).
25+
26+
Even when I don't make it to the conference in person, the video recordings are super helpful to learn from others. Here's a collection of the relevant talks over the years:
27+
28+
### 2017 US conference
29+
30+
[Jodie Putrino](https://www.youtube.com/watch?v=Mzu-c-FoOdw) presented “Treating documentation like code: a practical account” to share her experiences at F5 Networks.
31+
{% include youtube.html id=page.youtubeIdJodie %}
32+
33+
### 2016 US conference
34+
35+
[A panel](https://www.youtube.com/watch?v=Y2TGwUPb8R4) of folks from Rackspace, Microsoft, Balsamiq, and Twitter talked about how they are adopting these practices.
36+
{% include youtube.html id=page.youtubeIdPanel %}
37+
38+
### 2016 EU conference
39+
40+
[Margaret Eker and Jennifer Roundeau](https://www.youtube.com/watch?v=JvRd7MmAxPw) talked about the "Missing Manual" for docs like code.
41+
{% include youtube.html id=page.youtubeIdMargJen %}
42+
[Rachel Whitten](https://www.youtube.com/watch?v=dHdBsNxtKeI) talked about docs-as-code in practice.
43+
{% include youtube.html id=page.youtubeIdRachel %}
44+
45+
### 2015 US conference
46+
47+
[Riona MacNamara](https://www.youtube.com/watch?v=EnB8GtPuauw) spoke about how adopting docs like code has completely transformed how Google does documentation.
48+
{% include youtube.html id=page.youtubeIdRiona %}
49+
50+
All this to say, the docs-like-code concepts are widely practiced in our industry, and each conference provides more inspiring examples. Perhaps you can watch these presentations and be inspired to integrate code and doc techniques.
51+
52+

images/wtd-eur-2017.jpg

938 KB
Loading

0 commit comments

Comments
 (0)