19:01:31 #startmeeting docs 19:01:32 Meeting started Tue Jun 28 19:01:31 2016 UTC. The chair is colindixon. Information about MeetBot at http://ci.openstack.org/meetbot.html. 19:01:32 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 19:01:32 The meeting name has been set to 'docs' 19:01:36 #topic agenda bashing 19:02:45 #link https://git.opendaylight.org/gerrit/#/q/topic:gsg2rst colindixon migrated the entire getting started guide to reST and cleand up the older version as patches here 19:05:04 #info it looks like anipbu did a lot of reviewing of documentation patches and +1ed them if the edits are minor and a reader could understand how to use the features even with the minor issues 19:07:16 #info colindixon asks how to track when to get those fixed, for now anipbu's take is to just let them reflect on the quality of their project if they don't fix them 19:08:19 #link https://git.opendaylight.org/gerrit/#/c/40962/ colindixon pushed some enhanced documentation about how the docs project works and basic information about the directory structure and the like 19:09:17 https://meetings.opendaylight.org/opendaylight-docs/2016/docs/opendaylight-docs-docs.2016-06-28-19.01.log.txt 19:09:51 #info colindixon did reach out to the projects that generated the openstack content to let them know it was migrated and that we're plannig to delete the older version 19:10:29 #undo 19:10:29 Removing item from minutes: 19:10:48 #Link https://lists.opendaylight.org/pipermail/documentation/2016-June/000762.html e-mail informaing projects of project-speciific installation instructions being migrated to reST 19:11:16 #action colindixon to reach out to the projects that generated the openstack content to let them know it was migrated and that we're plannig to delete the older version 19:11:25 #action colindixon to populate the documentation reivew matrix with some assignments 19:11:42 #action colindixon anipbu and zxiiro to work on converting some of the user guide and developer guide pieces so we can iron out more bugs 19:11:51 #undo 19:11:51 Removing item from minutes: 19:12:42 #action colindixon to look into making zxiiro a committer on docs 19:14:06 #topic status update from Xinghao 19:15:32 #Info xinghao asks if there's a need for an automated tool 19:16:27 #link https://lists.opendaylight.org/pipermail/documentation/2016-June/000747.html xinghao looked into using pandoc 19:17:28 #info anipbu says to make sure sure to focus on the 90/10 point where we get 90% of the value with 10% of the work focusing on the key parts 19:18:52 #action xinghao to provide a sample input and output for his tool for next week's meeting (or hopefully before then) 19:21:13 https://docs.google.com/spreadsheets/d/1d-Qay-9IAy5OIECPGHj-Xtw24ey6UEzIEk9RSJuD5uo/edit#gid=22029863 19:21:24 #topic status of reviewing docs patches 19:21:29 #link https://docs.google.com/spreadsheets/d/1d-Qay-9IAy5OIECPGHj-Xtw24ey6UEzIEk9RSJuD5uo/edit#gid=22029863 19:22:41 image::ocpplugin/plugin-design.jpg[Overall architecture, 550, 284] 19:23:04 https://wiki.opendaylight.org/view/Documentation/Tools/AsciiDoc_Tips#Common_Errors 19:25:34 #topic david karr asks about images and video in asciidoc 19:26:03 #link https://wiki.opendaylight.org/view/Documentation/Tools/AsciiDoc_Tips#Common_Errors the first two common errors show how to work with images (indirectly) 19:27:35 #info videos are best done with URLs to YouTube or something similar 19:28:58 http://www.telecomasia.net/content/sdnlab-joins-opendaylight-project 19:29:47 youkuhttp://i.youku.com/opendaylight 19:29:59 http://i.youku.com/opendaylight 19:30:13 #topic where project documenrtation live 19:30:27 #info anipbu asks wehther we should encourage projects to do away with wiki-based documentation 19:32:19 #info colindixon says (in agreement with anipbu) that projects should be able to do whatever they want, but it's likely that they want to keep a single copy of docs in one place, and that's likely git 19:32:39 #topic video for china 19:33:24 #link it sounds like Huawei is providing subtitles and uploading our YouTube videos to YouKu here: http://i.youku.com/opendaylight 20:35:13 #endmeeting