14:02:08 #startmeeting Solum Team Meeting 14:02:09 Meeting started Wed Jun 28 14:02:08 2017 UTC and is due to finish in 60 minutes. The chair is devkulkarni. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:02:10 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 14:02:12 The meeting name has been set to 'solum_team_meeting' 14:02:20 hi devkulkarni 14:02:28 hi zhurong_ 14:02:36 nice to see you 14:02:45 nice to see you too 14:03:01 lets wait for a minute or so for others to join 14:03:12 sure 14:04:51 zhurong_: lets begin 14:04:59 okay 14:05:03 main thing today is the docs patches 14:05:17 yep 14:05:40 thanks for submitting them. I had not noticed them before so ended up creating one of the patches. but I will abandon it 14:06:01 never mind 14:06:38 looking through them now 14:07:24 the switch openstack theme patch need further improve 14:07:39 right, I saw the comment 14:11:07 zhurong_: in this patch https://review.openstack.org/#/c/477049/2 why do we remove contributing, installation, and usage files? 14:11:53 those files seems useless 14:14:48 I think the content in installation and usage can be useful to someone who does not know a whole lot about openstack and/or python. Anything that can help end users we should keep. I am fine deleting those files, but we should not remove that content. Could you move it to one of the other files (say, solum.rst) 14:15:38 may be you can keep this particular patch only for turning on the warning-is-error flag 14:15:55 and in another patch move the content.. 14:17:09 if we need add them back, we need add more details about those 14:18:53 sure..we can do that in a separate patch. If we don't loose the content then we will have a base to start from 14:19:33 I agree about removing the contributing.rst 14:19:42 we already have it at the top level 14:20:53 yep 14:22:12 for installation.rst and usage.rst, we can just move that content for now inside either solum.rst or top-level README.rst 14:23:09 OK, I will add this to the README.rst 14:24:09 cool. we can always work on improving and adding to that content with things that might help users. 14:24:53 yep, agree with this 14:24:59 cool 14:25:06 other two patches looked fine to me 14:26:46 for the openstackdocstheme change patch, looks like the steps to follow are here: https://docs.openstack.org/openstackdocstheme/latest/ 14:26:56 I am guessing you have already looked through them 14:27:50 yep, I am try to do this 14:28:04 zhurong_: cool 14:28:29 the etherpad that lists all the steps is https://etherpad.openstack.org/p/doc-migration-tracking 14:29:00 *looking at the Directions (line 27 - 46) * 14:29:42 about the soulm install guider, we do not have this 14:30:03 Step 1 requires us to have a patch that depends on the spec. It is this patch https://review.openstack.org/#/c/477058/3 14:30:21 yeah, we do not have install guide (or any other guides) yet. 14:30:31 for us the only thing that needs to be moved is the cli 14:31:03 for step 1, they had asked us to have a Depends-On for the spec 14:31:19 this spec had already merged 14:31:29 we don't need Depends-on this 14:31:54 actually we need the install-guide to solum 14:32:14 good point 14:32:29 which line number you are referring to? 14:33:05 https://docs.openstack.org/project-install-guide/messaging/ocata/ 14:33:08 like this 14:33:24 btw, look at 5.2 (line 35). You will need a Depends-On for the openstackdocstheme patch as well 14:33:57 I will submit the openstackdocstheme patch right now 14:34:03 zhurong_: yep, agree we need something like this 14:34:24 zhurong_: but having a install guide is not part of the docs migration 14:34:34 once we have completed docs migration we can work on the install guide 14:34:39 yep, I think so 14:35:19 about the openstackdocstheme patch, make sure you have the Depends-On as mentioned in point 5.2 (line 35) 14:35:25 if it is required 14:36:39 which patch should I Depends-On? 14:36:55 Depends-On: Ifc5512c0e2373cf3387e0e0498268eab092e52bb 14:37:13 https://etherpad.openstack.org/p/doc-migration-tracking check line 35 14:37:23 nop, already merged too 14:37:29 oh okay 14:37:32 then we don't need that 14:38:22 Do you understand point 6 (line 36)? 14:41:13 not so clear 14:41:46 yeah.. also the link in point 6.2 is not working 14:41:56 I am getting 404 14:42:17 me too 14:42:35 https://docs.openstack.org/developer/oslo.config/reference/sphinxconfiggen.html 14:42:39 maybe this one 14:43:46 https://github.com/openstack/glance/blob/master/doc/source/conf.py#L55 14:44:16 probably you are right 14:44:31 those might have been correct links 14:44:36 seems we doesn't need this, I am not sure 14:45:19 we do have solum.conf which is used by the server side 14:46:55 zhurong_: https://github.com/openstack/solum/blob/master/doc/source/conf.py 14:47:41 yep, maybe solum need this, we need do more research 14:47:54 right 14:47:55 And I have done the openstack theme patch 14:48:05 oh cool 14:49:09 looks fine to me 14:49:41 lets continue going through rest of the steps from that etherpad 14:49:51 - For step 6 (need more research) 14:50:07 How about step 7? (lines 40-41)? 14:50:28 I think we don't need to do step 7 14:50:42 agree 14:50:50 we don't have this 14:50:55 right 14:51:08 step 8. 14:51:16 not very clear to me 14:51:36 I guess this is a change to project-config 14:52:11 https://review.openstack.org/#/c/477232/1/zuul/layout.yaml 14:52:14 like this 14:52:31 yep 14:52:43 https://review.openstack.org/477051 got Jenkins +1 14:53:16 cool. once andreas weighs in, we can merge it 14:53:27 aj +1 too 14:54:00 approved 14:54:35 thanks 14:54:41 so for step 8, we will have to change project-config for openstack/python-solumclient 14:54:46 how about step 9 14:55:15 what is the "new location" referred to in that line (line 44) 14:56:39 https://review.openstack.org/#/c/476526/1/README.rst 14:56:42 check this 14:57:03 I see 14:57:40 https://review.openstack.org/#/c/477049/ we can merge this first, I will add the delete content to the README.rst 14:58:05 ok 14:58:31 done 14:58:49 ths devkulkarni 14:59:01 its almost end of the meeting time 14:59:11 yep 14:59:15 I think it was good discussion today 14:59:25 we are almost done with our docs migration 14:59:32 i thinl so 14:59:40 only question is about point number 6 and then the patch to change project-config 14:59:57 we can work on that next 15:00:14 sure 15:00:14 lets continue the discussion in solum channel 15:00:17 will end the meeting 15:00:22 #endmeeting