00:30:26 #startmeeting docteam 00:30:27 Meeting started Wed Jul 13 00:30:26 2016 UTC and is due to finish in 60 minutes. The chair is JRobinson__. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:30:28 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 00:30:31 The meeting name has been set to 'docteam' 00:30:45 Hello everyone, this is the APAC docs meeting, 00:30:49 who's here today? 00:32:15 hi 00:32:31 katomo, hello o/ 00:34:09 hm, too few people 00:34:44 Yes it's quiet, I sent out a message to some of the Rackers. 00:34:55 looks like everyone is busy 00:35:58 I'll wait about another 3 to 5 minutes and see if anyone is able to meet today 00:37:56 I think that's three contributors now ? 00:41:36 bmoss, katomo with three docs contributors, I think that's enough to run through these points? I'm unsure if the quorum is 4 people or not 00:41:41 o/ 00:41:54 darrenc, that's good timing :) 00:41:58 lol 00:42:02 okay 00:42:07 okay, so... 00:42:14 #topic Action items from last meeting 00:42:23 And I can't see any on the agenda 00:42:31 #link https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting 00:42:38 Next topic 00:42:46 #topic specs in review 00:43:06 #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 00:43:14 just two in review at the moment 00:43:46 #info these are release notes guidelines, and UI guidelines 00:44:18 both are currently undergoing discussion in the replies 00:45:02 Any comments on the specs? 00:45:54 no 00:46:02 okay, next topic 00:46:16 #topic speciality teams 00:46:41 #link https://etherpad.openstack.org/p/Speciality_Team_Reports 00:47:13 Install guide progress is good - new guides published, and swift install up 00:47:33 YaY 00:48:02 No updates from - Networking, security, User Guides, API, Hypervisor, or UX/UI teams at this time 00:48:03 nice 00:48:25 well, to the first comment :) 00:48:31 Some good progress on the Install guides, definitely :) 00:48:55 Ops and Arch guide has a ether pad up for tracking reorg progress 00:49:04 #link https://etherpad.openstack.org/p/ops-guide-reorg 00:49:40 darrenc, how is the ops reorg progress? Any updates to discuss? 00:49:50 in addition, I've added enterprise support docs information in the ops guide 00:49:53 (sorry, two questions at once there.) 00:50:17 there should be more content filtered through soon 00:50:59 That's good news. 00:50:59 mainly troubleshooting information which should be helpful for operators 00:51:41 And team members are joining in other ops meetings, and seeing if more contributors can help 00:52:07 yeah, we've done that, and the response has been lukewarm 00:52:20 #info Contact Darren or Shilla on the Ops team if you're interested in helping with the ops guide reorg 00:52:33 however, I have another cloud architect who wants to help with the arch guide 00:53:12 darrenc, I can also help out - one of the newton goals is User Guide and Ops content checking, and I need to make some progress on that one. 00:53:42 oh yeah, we should chat about that 00:54:07 thanks JRobinson__ 00:54:19 It's been a while since I focused on comparing the two guides for content, so I'll need to have another read through. 00:54:37 np 00:54:51 likewise with the user guides 00:55:06 Config/CLI Reference - Feedback from Dolph Matthews, plus bugs closed and CLI reference updates 00:55:26 katomo, that sounds like more good progress there :) Any further items ? 00:55:49 that's all. but it's good progress. 00:56:11 yes definitely, 00:56:26 John Garbutt mention the nova content needs updating 00:56:28 darrenc, thanks to report the feedbacks 00:56:33 s/mention/mentioned 00:56:41 np :) 00:56:59 Training Guides - Unused pages from the training guides were removed, and the getting started sections have had some improvements. 00:57:47 Training Labs - the training-labs library scripts have had minor improvements, PXE features are finalised 00:58:16 Also, the POC parser to search the install-guides for BASH is close to being finished 00:58:31 I think this is related to a mailing list discussion recently^ 00:58:55 Yes the "better way to display shell commands" thread 00:59:41 that's an effort to improve the code-block:: appearance 01:00:03 yeah, looks good 01:00:22 Yes, good to have it. Okay, so I think that's all for speciality teams. 01:00:48 #topic countdown to release 01:00:57 #info 84 days til release 01:01:34 #link https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables 01:01:42 The Newton deliverables are proceeding. 01:02:12 I don't think there's anything else to add there except we are continuing to work on the goals. 01:02:44 #topic Open Discussion 01:03:33 One Item I have is the User Guide consistency plan 01:03:37 #link https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides#IA_Plan 01:03:57 That needs to be refined and then I'll start working on the items. 01:04:41 One item I need to add: Changing the legacy commands to OpenStack client commands in the User-guide 01:05:06 This appeared on the mailing list yesterday - Subject: user guide and openstack client 01:05:06 ah, indeed. 01:06:50 So, just to check, these are the most recent openstack client commands? 01:06:53 - http://docs.openstack.org/cli-reference/ 01:07:10 yes 01:07:57 also, you need to have cloud environment running to check the command output 01:09:06 darrenc, katomo okay, thanks, 01:09:33 np 01:09:45 o/ 01:09:55 that was all 01:10:19 Docs team has a new core member JRobinson__. Congrats! 01:10:32 Thanks katomo :) 01:10:35 woohoo, congrats JRobinson__! 01:10:39 :) nice work JRobinson__ ! 01:10:46 * darrenc fires the confetti cannon 01:10:58 I was saying to bmoss and darrenc that it was strange to mention that myself, so thanks for bring it up :) 01:11:05 ^bringing 01:11:18 and darrenc also thanks for the virtual confetti 01:11:19 :) 01:12:28 I'll close the meeting then, thanks everyone! 01:12:42 #endmeeting