veyepar: Building Docs like Code: Continuous Integration for Documentation

Hi user

Admin Login:

Name: Building Docs like Code: Continuous Integration for Documentation
--client pyohio --show pyohio_2019 --room cartoon2 14871 --force
Prev: 12 Docker-Composing Your Way to a Better Development Environment
Next: 12 # TODO: Add Comments: 5 Tips for _Winning_ at Code Comments

show more...

Author(s):	Mason Egger
Location	Cartoon 2
Date	jul Sat 27	Days Raw Files
Start	15:45	First Raw Start	15:31
Duration	0:30:0	Offset	0:13:36
End	16:15	Last Raw End	16:31
Chapters	00:00 0:16:02
Total cuts_time	25 min.

https://www.pyohio.org/2019/presentations/109
raw-playlist raw-mp4-playlist encoded-files-playlist host archive tweet mp4 svg png

final audio

assets release.pdf Building_Docs_like_Code_Continuous_Integration_for_Documentation_2.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:	It is common for developers to overlook the documentation of their works. They are either on a time crunch, lack the proper tooling, or simply just forget to create and update the documentation. Whatever the cause behind this, it is not a proper excuse for not keeping the documentation up to date. However, for all our development processes there are few as neglected as the documentation process. Documentation should be treated as important as the code that makes up the project. In this talk we'll take a look at current documentation processes and discuss moving the documentation into the code. With modern documentation tools such as MkDocs and Sphinx, both of which are Python powered tools, and Continuous Integration tools we can now include docs in the commit. They can be reviewed in code reviews, built and versioned in a CI tool, and even tested for things such as correct code examples and broken links. This is the process that the developer knows, understands, and enjoys. I introduced a team to this exact workflow and a working pipeline; all they had to do was keep the documentation up to date. This team currently has some of the most up to date documentation in a company of near two thousand engineers, and they never complain about writing/updating documentation. It’s just part of the workflow. Project documentation is easy to neglect. Keep your docs inside your source repo and learn how to automatically build and publish beautiful docs on every commit. Viewers will leave with a new mindset on how to handle documentation, tooling for this process, and an easy-to-implement method to achieve this. markdown
Comment:	production notes

recording sheet

recording sheet

2019-07-27/15_31_24.ts Apply: 15:31:24 - 15:45:22 ( 00:13:58 ) S: 15:31:24 - E: 16:01:24 D: 00:30:00 (End: 838.0) show more...

vlc ~/Videos/veyepar/pyohio/pyohio_2019/dv/cartoon2/2019-07-27/15_31_24.ts :start-time=00.0 --audio-desync=0

	Raw File	Cut List
	15:31:24		seconds: 0.0 Wall: 15:31:24
Duration	00:30:00
	16:01:24		seconds: 838.0 Wall: 15:45:22
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2019-07-27/15_31_24.ts Apply: 15:45:22 - 16:01:24 ( 00:16:02 ) S: 15:31:24 - E: 16:01:24 D: 00:30:00 (Start: 838.0) show more...

vlc ~/Videos/veyepar/pyohio/pyohio_2019/dv/cartoon2/2019-07-27/15_31_24.ts :start-time=0838.0 --audio-desync=0

	Raw File	Cut List
	15:31:24		seconds: 838.0 Wall: 15:45:22
Duration	00:30:00
	16:01:24		seconds: 0.0 Wall: 15:31:24
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2019-07-27/16_01_24.ts Apply: 16:01:24 - 16:10:40 ( 00:09:16 ) S: 16:01:24 - E: 16:31:24 D: 00:30:00 (End: 556.0) show more...

vlc ~/Videos/veyepar/pyohio/pyohio_2019/dv/cartoon2/2019-07-27/16_01_24.ts :start-time=00.0 --audio-desync=0

	Raw File	Cut List
	16:01:24		seconds: 0.0 Wall: 16:01:24
Duration	00:30:00
	16:31:24		seconds: 556.0 Wall: 16:10:40
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2019-07-27/16_01_24.ts Apply: 16:10:40 - 16:11:10 ( 00:00:30 ) S: 16:01:24 - E: 16:31:24 D: 00:30:00 (Start: 556.0) (End: 586.0) show more...

vlc ~/Videos/veyepar/pyohio/pyohio_2019/dv/cartoon2/2019-07-27/16_01_24.ts :start-time=0556.0 --audio-desync=0

	Raw File	Cut List
	16:01:24		seconds: 556.0 Wall: 16:10:40
Duration	00:30:00
	16:31:24		seconds: 586.0 Wall: 16:11:10
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2019-07-27/16_01_24.ts Apply: 16:11:10 - 16:30:02 ( 00:18:52 ) S: 16:01:24 - E: 16:31:24 D: 00:30:00 (Start: 586.0) (End: 1718.0) show more...

vlc ~/Videos/veyepar/pyohio/pyohio_2019/dv/cartoon2/2019-07-27/16_01_24.ts :start-time=0586.0 --audio-desync=0

	Raw File	Cut List
	16:01:24		seconds: 586.0 Wall: 16:11:10
Duration	00:30:00
	16:31:24		seconds: 1718.0 Wall: 16:30:02
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2019-07-27/16_01_24.ts Apply: 16:30:02 - 16:30:28 ( 00:00:26 ) S: 16:01:24 - E: 16:31:24 D: 00:30:00 (Start: 1718.0) (End: 1744.0) show more...

vlc ~/Videos/veyepar/pyohio/pyohio_2019/dv/cartoon2/2019-07-27/16_01_24.ts :start-time=01718.0 --audio-desync=0

	Raw File	Cut List
	16:01:24		seconds: 1718.0 Wall: 16:30:02
Duration	00:30:00
	16:31:24		seconds: 1744.0 Wall: 16:30:28
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

2019-07-27/16_01_24.ts Apply: 16:30:28 - 16:31:24 ( 00:00:56 ) S: 16:01:24 - E: 16:31:24 D: 00:30:00 (Start: 1744.0) show more...

vlc ~/Videos/veyepar/pyohio/pyohio_2019/dv/cartoon2/2019-07-27/16_01_24.ts :start-time=01744.0 --audio-desync=0

	Raw File	Cut List
	16:01:24		seconds: 1744.0 Wall: 16:30:28
Duration	00:30:00
	16:31:24		seconds: 0.0 Wall: 16:01:24
Comments:
mp4 mp4.m3u	dv.m3u	Split: Sequence:: delete

audio viz

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

2019-07-27/15_31_24.ts
audio viz

audio viz

2019-07-27/16_01_24.ts
audio viz

audio viz

Veyepar Video Eyeball Processor and Review