| *** suyog has joined #openstack-doc | 00:00 | |
| *** masaki has joined #openstack-doc | 00:02 | |
| *** s-shiono has joined #openstack-doc | 00:04 | |
| *** salv-orlando has joined #openstack-doc | 00:07 | |
| *** salv-orlando has quit IRC | 00:12 | |
| *** edmondsw has joined #openstack-doc | 00:45 | |
| *** edmondsw has quit IRC | 00:59 | |
| *** phuongnh has joined #openstack-doc | 01:00 | |
| *** edmondsw has joined #openstack-doc | 01:00 | |
| *** edmondsw has quit IRC | 01:05 | |
| *** salv-orlando has joined #openstack-doc | 01:08 | |
| *** salv-orlando has quit IRC | 01:13 | |
| *** charcol has quit IRC | 01:54 | |
| *** charcol has joined #openstack-doc | 01:57 | |
| *** salv-orlando has joined #openstack-doc | 02:09 | |
| *** salv-orlando has quit IRC | 02:14 | |
| *** gouthamr has joined #openstack-doc | 02:15 | |
| *** beekhof has joined #openstack-doc | 02:41 | |
| *** charcol has quit IRC | 03:02 | |
| *** dmacpher has joined #openstack-doc | 03:17 | |
| *** gouthamr has quit IRC | 03:22 | |
| *** charcol has joined #openstack-doc | 03:27 | |
| *** yamamoto has joined #openstack-doc | 03:54 | |
| *** amotoki_away is now known as amotoki | 04:02 | |
| *** salv-orlando has joined #openstack-doc | 04:10 | |
| *** salv-orlando has quit IRC | 04:15 | |
| *** dmacpher has quit IRC | 04:24 | |
| *** edmondsw has joined #openstack-doc | 04:28 | |
| *** charcol-v2 has joined #openstack-doc | 04:31 | |
| *** edmondsw has quit IRC | 04:32 | |
| *** charcol has quit IRC | 04:34 | |
| *** ccollett has joined #openstack-doc | 04:38 | |
| *** charcol-v2 has quit IRC | 04:40 | |
| *** ccollett has quit IRC | 04:45 | |
| *** salv-orlando has joined #openstack-doc | 05:04 | |
| *** yangyapeng has joined #openstack-doc | 05:06 | |
| *** dmacpher has joined #openstack-doc | 05:21 | |
| *** yangyapeng has quit IRC | 05:35 | |
| *** yangyapeng has joined #openstack-doc | 05:47 | |
| *** rcernin has joined #openstack-doc | 05:59 | |
| *** AJaeger has quit IRC | 06:07 | |
| *** charcol has joined #openstack-doc | 06:07 | |
| *** yangyape_ has joined #openstack-doc | 06:08 | |
| *** yangyapeng has quit IRC | 06:10 | |
| *** yangyape_ has quit IRC | 06:14 | |
| *** edmondsw has joined #openstack-doc | 06:16 | |
| *** yangyapeng has joined #openstack-doc | 06:17 | |
| *** yangyapeng has quit IRC | 06:18 | |
| *** salv-orlando has quit IRC | 06:19 | |
| *** salv-orlando has joined #openstack-doc | 06:19 | |
| *** edmondsw has quit IRC | 06:20 | |
| *** tesseract has joined #openstack-doc | 06:24 | |
| *** salv-orlando has quit IRC | 06:24 | |
| *** andreas_s has joined #openstack-doc | 06:27 | |
| *** salv-orlando has joined #openstack-doc | 06:28 | |
| *** yangyapeng has joined #openstack-doc | 06:34 | |
| *** charcol has quit IRC | 06:35 | |
| *** yangyape_ has joined #openstack-doc | 06:35 | |
| *** salv-orl_ has joined #openstack-doc | 06:37 | |
| *** yangyapeng has quit IRC | 06:39 | |
| *** salv-orlando has quit IRC | 06:39 | |
| *** pcaruana has joined #openstack-doc | 06:45 | |
| *** jpena|off is now known as jpena | 06:50 | |
| *** suyog has quit IRC | 06:50 | |
| *** charcol has joined #openstack-doc | 07:01 | |
| *** yangyape_ has quit IRC | 07:04 | |
| *** dmacpher has quit IRC | 07:30 | |
| *** charcol has quit IRC | 07:39 | |
| *** yangyapeng has joined #openstack-doc | 07:55 | |
| *** pcaruana has quit IRC | 07:58 | |
| *** rcernin has quit IRC | 07:59 | |
| *** edmondsw has joined #openstack-doc | 08:04 | |
| *** edmondsw has quit IRC | 08:08 | |
| *** rcernin has joined #openstack-doc | 08:11 | |
| *** pcaruana has joined #openstack-doc | 08:12 | |
| *** yangyapeng has quit IRC | 08:18 | |
| *** junbo has quit IRC | 08:21 | |
| *** junbo has joined #openstack-doc | 08:25 | |
| *** s-shiono has quit IRC | 08:31 | |
| *** yamamoto has quit IRC | 08:38 | |
| *** yamamoto has joined #openstack-doc | 08:39 | |
| *** yamamoto has quit IRC | 08:45 | |
| *** yangyapeng has joined #openstack-doc | 08:52 | |
| *** yangyape_ has joined #openstack-doc | 08:54 | |
| *** yangyapeng has quit IRC | 08:57 | |
| asettle | Morning o/ | 09:02 |
|---|---|---|
| *** yamamoto has joined #openstack-doc | 09:03 | |
| * smcginnis waves | 09:06 | |
| asettle | Hey pal :d | 09:06 |
| asettle | LD * | 09:06 |
| asettle | Oh ffs | 09:06 |
| asettle | I give up | 09:06 |
| asettle | No smiley for you | 09:06 |
| smcginnis | Hah | 09:06 |
| asettle | Monday, amirtie?! | 09:09 |
| asettle | Sigh | 09:09 |
| smcginnis | Don't worry, it just gets better from here. :) | 09:09 |
| asettle | That's... ominous :P | 09:10 |
| smcginnis | Or it's all downhill from here? :D | 09:10 |
| asettle | Downhill I imagine. The coffee isn't quite kicking in as soon as I imagined and there's so much to dooooo | 09:11 |
| *** tosky has joined #openstack-doc | 09:14 | |
| *** yangyapeng has joined #openstack-doc | 09:22 | |
| *** yangyape_ has quit IRC | 09:23 | |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: group projects from the same team together in template data file https://review.openstack.org/477248 | 09:28 |
| *** rcernin has quit IRC | 09:46 | |
| *** edmondsw has joined #openstack-doc | 09:52 | |
| asettle | dhellmann: so, when you come in, chason brought up a good point. I don't think we have a plan for the /doc/common dir | 09:54 |
| asettle | https://github.com/openstack/openstack-manuals/tree/master/doc/common | 09:54 |
| *** edmondsw has quit IRC | 09:56 | |
| *** salv-orl_ has quit IRC | 09:56 | |
| *** salv-orlando has joined #openstack-doc | 09:57 | |
| *** salv-orlando has quit IRC | 10:01 | |
| *** rcernin has joined #openstack-doc | 10:02 | |
| *** yangyapeng has quit IRC | 10:09 | |
| *** yamamoto has quit IRC | 10:17 | |
| *** phuongnh has quit IRC | 10:39 | |
| *** cathrichardson has quit IRC | 10:40 | |
| *** cathrichardson has joined #openstack-doc | 10:41 | |
| *** tosky has quit IRC | 10:49 | |
| *** ericyoung has joined #openstack-doc | 10:52 | |
| *** pcaruana has quit IRC | 10:53 | |
| asettle | smcginnis: https://review.openstack.org/#/c/477489/ | 10:57 |
| *** yamamoto has joined #openstack-doc | 10:59 | |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: remove additional resources from install-guide https://review.openstack.org/477491 | 11:00 |
| *** pblaho has joined #openstack-doc | 11:02 | |
| *** pcaruana has joined #openstack-doc | 11:05 | |
| *** tosky has joined #openstack-doc | 11:06 | |
| *** pkovar has joined #openstack-doc | 11:11 | |
| *** AJaeger has joined #openstack-doc | 11:21 | |
| *** ericyoung has quit IRC | 11:22 | |
| *** yangyapeng has joined #openstack-doc | 11:24 | |
| *** ericyoung has joined #openstack-doc | 11:25 | |
| *** yangyapeng has quit IRC | 11:28 | |
| *** yangyapeng has joined #openstack-doc | 11:34 | |
| *** yamamoto has quit IRC | 11:37 | |
| *** edmondsw has joined #openstack-doc | 11:40 | |
| *** edmondsw has quit IRC | 11:44 | |
| *** edmondsw has joined #openstack-doc | 12:01 | |
| *** rcernin has quit IRC | 12:02 | |
| *** edmondsw has quit IRC | 12:03 | |
| *** rcernin has joined #openstack-doc | 12:04 | |
| *** yamamoto has joined #openstack-doc | 12:13 | |
| *** jpena is now known as jpena|lunch | 12:14 | |
| *** rcernin has quit IRC | 12:21 | |
| *** rcernin has joined #openstack-doc | 12:21 | |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: remove additional resources from install-guide https://review.openstack.org/477491 | 12:28 |
| *** salv-orlando has joined #openstack-doc | 12:29 | |
| *** salv-orlando has quit IRC | 12:33 | |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: Creating new 'common' install file, 'verify deploy' https://review.openstack.org/477518 | 12:37 |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: Creating new 'common' install file, 'verify deploy' https://review.openstack.org/477518 | 12:39 |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: Creating new 'common' install file, 'verify deploy' https://review.openstack.org/477518 | 12:39 |
| dhellmann | asettle, chason : there's a mention of copying parts it into each tree, but I don't think we went into a lot of detail. what do you all think we should do? | 12:43 |
| *** edmondsw has joined #openstack-doc | 12:43 | |
| asettle | dhellmann: been having a look this morning, I'll spend a bit more time looking at it this afternoon and get back to you | 12:44 |
| asettle | It's a bit *everywhere* at the moment. | 12:44 |
| dhellmann | asettle : yeah. given the push-back on copying the glossary around, maybe we don't want that copied iter? | 12:44 |
| dhellmann | *either | 12:44 |
| asettle | Things like /common/conventions and /common/appendix can probably be deleted though. | 12:44 |
| asettle | Yep. I don't think we should. | 12:44 |
| * dhellmann has picked up asettle's monday-typos | 12:44 | |
| asettle | dhellmann: welcome! | 12:45 |
| dhellmann | are those sections useful for any of the other guides that are staying in place? | 12:45 |
| dhellmann | iirc, they were included in a couple of guides? | 12:45 |
| asettle | dhellmann: that's what I'm going to investigate this afternoon :) | 12:45 |
| dhellmann | ok | 12:45 |
| asettle | I don't want to duplicate too much info around | 12:45 |
| dhellmann | ++ | 12:46 |
| dhellmann | speaking of deleting content, I'd like to schedule a time to land my series in openstack-manuals that starts with that patch | 12:46 |
| asettle | I moved the cinder stuff over this morning, got a bit of fiddling to do there | 12:46 |
| asettle | dhellmann: yep I was going to mention that | 12:46 |
| asettle | I would like to start that ball rolling | 12:46 |
| dhellmann | how long do you think we should wait? | 12:46 |
| dhellmann | probably a few days at least, maybe a week? | 12:46 |
| asettle | dhellmann: Hmmm for all the stuff to be moved? | 12:47 |
| dhellmann | yeah, I thought about that. I realized that we still have a lot of work to do within the docs team repo, and I don't want to put that off indefinitely. | 12:47 |
| dhellmann | so I was trying to balance giving everyone time to get their move started, with time for the docs team to do their work | 12:48 |
| asettle | dhellmann: maybe we set a deadline on the docs repo stuff? Because the amount of internal work we're going to have to do is going to be fairly significant. We'll need time. | 12:48 |
| dhellmann | even after the content is "deleted" it's still in the git history, so we can tell projects which SHA to check out to get it | 12:48 |
| dhellmann | right, that's what I'm thinking | 12:48 |
| asettle | dhellmann: that's a good point, we're not losing it all regardless. | 12:48 |
| asettle | Okay, I'm with you. Let's give it ... a week? | 12:49 |
| dhellmann | so if we tell folks we're going to land that series on Thursday, say, then they have some motivation to get going? | 12:49 |
| asettle | dhellmann: that works for me. | 12:49 |
| dhellmann | a week seems good. When do we start counting, today? :-) | 12:49 |
| asettle | Yep, today. | 12:49 |
| asettle | Aw, well | 12:49 |
| asettle | Yeha | 12:49 |
| asettle | Let's go today | 12:49 |
| dhellmann | k | 12:49 |
| dhellmann | now, speaking of keeping people filled in on what's going on, what do you think about doing a weekly status update? | 12:50 |
| dhellmann | we could announce the projects that have completed the migration, for example | 12:50 |
| asettle | dhellmann: yes, so, normally I'd do a bi-weekly newsletter after having our team meetings - I haven't been doing a newsletter simply because there's been a lot of disruption in general. I could use that space? | 12:50 |
| asettle | I'd be sending out one this Friday | 12:50 |
| dhellmann | which ML did that go to? | 12:51 |
| asettle | dev and doc | 12:51 |
| dhellmann | ok, that's good coverage | 12:51 |
| dhellmann | do you think bi-weekly is often enough? | 12:51 |
| asettle | dhellmann: let's test it, i'll send one out this week, and if there's *so* much info to cover the following week, I'll update. If it's quiet, I'll leave it. | 12:52 |
| dhellmann | wfm | 12:52 |
| *** rbowen has joined #openstack-doc | 12:52 | |
| asettle | Easy as. | 12:52 |
| dhellmann | maybe add the [ptl] tag to the subject | 12:52 |
| asettle | Yes, previously it's just been general, haven't been using the tags to the full potential | 12:53 |
| asettle | But I wasn't doing a full migration project previously :p | 12:53 |
| dhellmann | https://review.openstack.org/#/q/topic:doc-migration+is:merged shows a couple of projects starting the work | 12:53 |
| dhellmann | :-) | 12:53 |
| asettle | I did notice, was having a stalk around this mroning. | 12:53 |
| asettle | I started the cinder patch too: https://review.openstack.org/#/c/477489/ | 12:53 |
| asettle | I just have to obviously fiddle around with that to make it uh... not just a dump | 12:53 |
| dhellmann | nice | 12:54 |
| asettle | Also, this is a fail because I haven't done it properly, but I admittedly couldn't quite remember what we had planned: https://review.openstack.org/#/c/477518/ | 12:54 |
| asettle | https://etherpad.openstack.org/p/doc-migration-tracking (lines 555 onwards) | 12:54 |
| asettle | Were we going to create a common dir called "Verifying your deployment" and plonk the pre-install in there? | 12:54 |
| asettle | Or am I confusing things now? | 12:55 |
| * dhellmann thinks back | 12:55 | |
| dhellmann | we did say we'd change the "install guide" to something else | 12:55 |
| asettle | I wasn't too sure, so I figured I'd put it up, and then fix the break when we decided | 12:55 |
| asettle | Yes, we did | 12:55 |
| dhellmann | we have the actual setup instructions for things like rabbit, too | 12:55 |
| dhellmann | did we say we would split that stuff into 2 guides, or just have the one ? | 12:56 |
| asettle | I thought it was just one? | 12:56 |
| dhellmann | how do you feel about making the verify stuff a chapter of the install-guide that's already building? | 12:57 |
| asettle | Cause there's a bit of overlap. | 12:57 |
| asettle | dhellmann: yeah that works for me. Your patch? | 12:57 |
| dhellmann | yeah, let me find a good one for you to rebase against | 12:57 |
| dhellmann | probably https://review.openstack.org/#/c/475408/7 | 12:58 |
| dhellmann | asettle, annegentle: if we can land https://review.openstack.org/477008 that will make migrating to the new theme simpler | 13:02 |
| asettle | *clicky clicky* | 13:02 |
| asettle | Mergy mergy | 13:02 |
| asettle | brb - on meeting :) | 13:02 |
| dhellmann | ack, my morning meetings are going to start soon, too | 13:03 |
| asettle | dhellmann: enjoy± | 13:05 |
| *** donghao has joined #openstack-doc | 13:07 | |
| *** lucasxu has joined #openstack-doc | 13:13 | |
| *** gouthamr has joined #openstack-doc | 13:16 | |
| *** dustins has joined #openstack-doc | 13:21 | |
| *** jpena|lunch is now known as jpena | 13:24 | |
| *** gouthamr has quit IRC | 13:26 | |
| *** cathrich_ has joined #openstack-doc | 13:27 | |
| *** dmacpher has joined #openstack-doc | 13:29 | |
| *** cathrichardson has quit IRC | 13:30 | |
| *** salv-orlando has joined #openstack-doc | 13:30 | |
| *** thorst has joined #openstack-doc | 13:31 | |
| *** salv-orlando has quit IRC | 13:34 | |
| AJaeger | asettle, dhellmann, we first need https://review.openstack.org/#/c/476997 in before 477008 can go in | 13:38 |
| csatari | What do I need to check to see if I'm compliat with this: "Update the theme for the in-tree docs to use the openstackdocstheme instead of oslosphinx."? from http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html | 13:41 |
| AJaeger | csatari: check your *requirements.txt files whether it includes openstackdocstheme and not oslosphinx | 13:43 |
| AJaeger | csatari: and then check doc/source/conf.py on correct settings for openstackdocstheme | 13:44 |
| csatari | test-requireemnts.txt contains both. | 13:44 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstackdocstheme master: switch release notes build to use openstackdocs instead of oslosphinx https://review.openstack.org/477008 | 13:45 |
| AJaeger | csatari: then remove oslosphinx | 13:45 |
| csatari | requirements.txt none of them . | 13:45 |
| AJaeger | csatari: having them in test-requirements is fine | 13:45 |
| csatari | conf.py: | 13:45 |
| AJaeger | csatari: which repo? | 13:45 |
| csatari | https://www.irccloud.com/pastebin/igPpH5Jl/ | 13:46 |
| csatari | vitrage | 13:46 |
| csatari | https://review.openstack.org/#/c/477509/ | 13:46 |
| AJaeger | csatari: so, that is oslosphinx in vitrage | 13:46 |
| AJaeger | csatari: with 477509 you do not need the vitrage install guide patch for project-config anymore - abandon it | 13:47 |
| csatari | The whole thing? | 13:47 |
| AJaeger | csatari: You will build the install-guide as part of your docs job, so no need for a separate job. | 13:49 |
| AJaeger | csatari: I commented on 477509 | 13:49 |
| csatari | Okay | 13:49 |
| csatari | Thanks | 13:49 |
| csatari | Back to the openstackdocstheme topic a bit. | 13:50 |
| csatari | If I add itto conf.py I will have an error about a missing plugin. This is solved by adding it to requirements.txt? | 13:51 |
| *** chlong has joined #openstack-doc | 13:52 | |
| csatari | Nope. | 13:55 |
| AJaeger | If it's in test-requiremetns, then it's enough. Let me check | 13:55 |
| AJaeger | csatari: show me a change where you get the error and I can look at it... | 13:55 |
| AJaeger | csatari: It should work, just reviewed - how can I reproduce? | 13:57 |
| csatari | AJaeger: pushing | 13:57 |
| csatari | https://review.openstack.org/#/c/477509/3 | 13:58 |
| csatari | tox -e docs results in | 13:59 |
| *** masaki has quit IRC | 13:59 | |
| csatari | Theme error: | 13:59 |
| csatari | no theme named 'openstackdocstheme' found (missing theme.conf?) | 13:59 |
| AJaeger | csatari: see README.rst from openstackdocstheme. | 14:00 |
| AJaeger | csatari: change https://review.openstack.org/#/c/476997 will simplify it | 14:00 |
| AJaeger | csatari: you miss the three lines from http://git.openstack.org/cgit/openstack/openstackdocstheme/tree/README.rst#n40 | 14:00 |
| *** chlong has quit IRC | 14:01 | |
| AJaeger | asettle, pkovar, dhellmann Let's merge 476997 and then release a new openstackdocstheme version - what do you think? | 14:03 |
| *** salv-orlando has joined #openstack-doc | 14:05 | |
| *** chlong has joined #openstack-doc | 14:15 | |
| *** rarora has quit IRC | 14:30 | |
| *** yangyape_ has joined #openstack-doc | 14:30 | |
| dhellmann | AJaeger : ++ | 14:31 |
| dhellmann | I'd love to get that done today | 14:31 |
| *** yangyapeng has quit IRC | 14:33 | |
| amotoki | asettle: ping | 14:40 |
| csatari | AJaeger: I have http://git.openstack.org/cgit/openstack/openstackdocstheme/tree/README.rst#n40 in my conf.py, but I'm still not happy :) | 14:54 |
| asettle | amotoki: hello helloooo :) | 14:57 |
| asettle | Sorry, was off in a meeting | 14:57 |
| asettle | dhellmann: merged | 14:58 |
| dhellmann | asettle : excellent. do I have your permission to release a new version of the theme when that lands? | 14:58 |
| dhellmann | I can take care of it later today | 14:58 |
| asettle | dhellmann: yes please :) | 14:59 |
| dhellmann | asettle : great, thanks | 14:59 |
| *** nishaYadav has joined #openstack-doc | 15:02 | |
| *** nishaYadav is now known as Guest229 | 15:02 | |
| *** Guest229 is now known as nishaYadav_ | 15:03 | |
| openstackgerrit | Merged openstack/openstackdocstheme master: automate some of the extension setup https://review.openstack.org/476997 | 15:03 |
| *** rcernin has quit IRC | 15:04 | |
| openstackgerrit | Merged openstack/openstackdocstheme master: switch release notes build to use openstackdocs instead of oslosphinx https://review.openstack.org/477008 | 15:04 |
| openstackgerrit | Petr Kovar proposed openstack/openstack-manuals stable/ocata: [config-reference] Fix list value description https://review.openstack.org/477571 | 15:07 |
| asettle | dhellmann and AJaeger - 476997 is merged | 15:12 |
| asettle | dhellmann: already on it :P | 15:13 |
| dhellmann | asettle : I have set up the release and just need to wait for the jobs to pass before approving | 15:13 |
| * asettle clicks +1 :p | 15:13 | |
| dhellmann | ty | 15:13 |
| dhellmann | asettle : release incoming | 15:16 |
| * asettle holds onto her chair | 15:16 | |
| dhellmann | I will propose the requirements update to set the minimum version when the release is available | 15:17 |
| csatari | I hitnk my probelm is with the theme itself | 15:17 |
| csatari | It always complains about the missing openstackdocs theme in openstackdocstheme and refers to ../site-packages/openstackdocstheme/theme | 15:19 |
| dhellmann | csatari : this release should fix that bug | 15:19 |
| csatari | Ookay | 15:19 |
| csatari | What do I do? Hold my chair with asettle and use the released version? | 15:20 |
| asettle | csatari: absolutely | 15:20 |
| asettle | Hold on | 15:20 |
| asettle | Don't let go until dhellmann tells us to | 15:20 |
| csatari | Okay :) | 15:20 |
| csatari | I will start to fix my 33 warnings until then. | 15:21 |
| asettle | Hhahahaha that's a lot of warnings | 15:21 |
| asettle | Oh dear | 15:21 |
| *** yamamoto has quit IRC | 15:21 | |
| *** yamamoto has joined #openstack-doc | 15:24 | |
| asettle | pkovar: oh yes! Thank you. I had completely forgotten what we discussed in the spec, as we hadn't quite updated: https://etherpad.openstack.org/p/doc-migration-tracking (see line 555) | 15:25 |
| amotoki | asettle: hi. during doc-migration patches and reviews, one question hits me. I wonder what title should be used for a subdirectory index.rst. | 15:26 |
| asettle | amotoki: within the install file? | 15:26 |
| asettle | install dir* | 15:27 |
| amotoki | asettle: title of index.rst of subdirs. | 15:27 |
| amotoki | asettle: yeah. like install/index.rst | 15:27 |
| asettle | amotoki: to be honest, we've always kept them as index.rst - there is no reason to change that, imho. | 15:27 |
| *** chlong has quit IRC | 15:27 | |
| asettle | It is still an index file of a separate doc. It's something we've always done in manuals | 15:27 |
| amotoki | asettle: on the other hand, it will be linked from the top-level index.rst as well. | 15:27 |
| asettle | Well, it'd be linked in the index.rst as install/index.rst | 15:28 |
| asettle | I don't think there's anything particularly confusing about that. But do you think it would be? | 15:28 |
| asettle | We haven't had any problems in manuals before. | 15:28 |
| amotoki | i think <subdir>/index will be linked directly from somewhere in docs.o.o. | 15:29 |
| asettle | amotoki: what do you mean? | 15:29 |
| *** yamamoto has quit IRC | 15:29 | |
| amotoki | let me like some example. assume we have user/index.rst and its title is 'OpenStack Dashboard User documentation'. | 15:30 |
| amotoki | it makes sense when it is a part of the single user guide. | 15:30 |
| csatari | Anyone have any hint how to draw boxes and lines type of diagrams? | 15:30 |
| amotoki | but it is tricky if user/index is linked from the horizon top-level index.rst. | 15:30 |
| amotoki | asettle: this is my point. | 15:30 |
| amotoki | the same thing will happen for neutron too. | 15:31 |
| asettle | csatari: you can use draw.io | 15:32 |
| asettle | amotoki: hmmm | 15:32 |
| amotoki | in general, 'User documentation' look better for the title from the perspecitve of a project documentation. on the other hand, if it will linked directly from docs.o.o, 'OpenStack Dashboard User documentation' totally makes sense. | 15:32 |
| amotoki | or 'OpenStack Dashboard' might be better as a title. | 15:32 |
| amotoki | I am in a dillemma. | 15:33 |
| asettle | amotoki: oh! I misunderstood you at first. I see what you mean. | 15:33 |
| asettle | I think keep it simple and descriptive. "OpenStack Dashboard User documentation" is perfect | 15:33 |
| asettle | Maybe even just "Dashboard User documentation" | 15:34 |
| amotoki | asettle: another way is to use "User documentation <user/index>" in the toctree of the top-level index.rst. | 15:34 |
| asettle | amotoki: how would that work, exactly? | 15:35 |
| *** andreas_s has quit IRC | 15:35 | |
| amotoki | asettle: for example, https://review.openstack.org/#/c/474794/2/doc/source/index.rst and http://docs-draft.openstack.org/94/474794/2/check/gate-horizon-docs-ubuntu-xenial/ad34e18//doc/build/html/ | 15:37 |
| amotoki | the label is used in the toctree. | 15:37 |
| asettle | amotoki: I see! I admit, I didn't even know you could do that | 15:38 |
| amotoki | without a label, we will get http://docs-draft.openstack.org/94/474794/1/check/gate-horizon-docs-ubuntu-xenial/25dc634//doc/build/html/ for example. 'OpenStack Dashboard User Documentation' in "OpenStack Dashboard' toctree sounds odd to me. | 15:38 |
| asettle | amotoki: hmmm you're right, that is a bit odd | 15:38 |
| asettle | it looked better in my head | 15:39 |
| amotoki | we actually solve this problem in a project side, but I think every project hits this problem. this is my reason I'd like to talk this with you. | 15:39 |
| asettle | amotoki: yes, that's fair enough, thank you for bringing it up | 15:39 |
| asettle | I think encouraging projects to use User Documentation <user/index> makes sense | 15:40 |
| asettle | But I do not want to make every team do the same thing | 15:40 |
| *** chlong has joined #openstack-doc | 15:41 | |
| amotoki | yes, we need some consistency | 15:41 |
| amotoki | some guideline is needed. what I have at now is to use 'User Documentation <user/index>' (or similar things) | 15:42 |
| amotoki | asettle: it is not an easy thing and I am not wanting the answer for now. if it is better to be discussed in the ML, I can bring it up. | 15:45 |
| asettle | amotoki: absolutely, you are right. Consistency is key. I would appreciate you bringing that up on the ML :) | 15:46 |
| amotoki | asettle: sure. will write some mail tomorrow. | 15:48 |
| asettle | amotoki: thank you for bringing it up :) i'll let you know if I think of anything else | 15:49 |
| asettle | I think the <user/index> optino is best for now | 15:49 |
| *** tosky has quit IRC | 15:49 | |
| dhellmann | asettle, csatari : https://review.openstack.org/#/c/477596/ | 15:50 |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Working on integrating options from oslosphinx theme https://review.openstack.org/468021 | 15:52 |
| *** nishaYadav_ has quit IRC | 15:58 | |
| *** annegentle has joined #openstack-doc | 15:58 | |
| *** pblaho has quit IRC | 16:02 | |
| *** pcaruana has quit IRC | 16:03 | |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Working on integrating options from oslosphinx theme https://review.openstack.org/468021 | 16:04 |
| *** amotoki is now known as amotoki_away | 16:05 | |
| *** lucasxu has quit IRC | 16:08 | |
| *** tosky has joined #openstack-doc | 16:11 | |
| *** pcaruana has joined #openstack-doc | 16:14 | |
| *** pblaho has joined #openstack-doc | 16:16 | |
| *** nishaYadav has joined #openstack-doc | 16:16 | |
| *** nishaYadav is now known as Guest78358 | 16:16 | |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Working on integrating options from oslosphinx theme https://review.openstack.org/468021 | 16:17 |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Working on integrating options from oslosphinx theme https://review.openstack.org/468021 | 16:23 |
| *** jpena is now known as jpena|off | 16:24 | |
| dhellmann | annegentle : how much do you think you can split https://review.openstack.org/#/c/468021/ into separate patches? some of the changes seem quite small and easy to land (the link name in the nav) while others are going to need more review (the search stuff) | 16:25 |
| annegentle | dhellmann was just thinking that myself | 16:26 |
| annegentle | dhellmann shall I abandon and start smaller | 16:26 |
| *** yamamoto has joined #openstack-doc | 16:27 | |
| dhellmann | annegentle : if you make a series and give the first patch in the series the same commit-id you can just replace that existing patch | 16:27 |
| annegentle | dhellmann I'm out Wed. and off next week, but should be able to get at least one small one done | 16:27 |
| *** Guest78358 has quit IRC | 16:27 | |
| dhellmann | but whatever is easier for you to do (sometimes splitting css changes is a nightmare) | 16:27 |
| annegentle | dhellmann ok,that works. What should I do first, the link name in nav? | 16:27 |
| annegentle | dhellmann that CSS is giving me fits | 16:27 |
| dhellmann | sure | 16:27 |
| annegentle | dhellmann I sent out a lifeline | 16:27 |
| dhellmann | yeah, I wish I could help :/ | 16:28 |
| annegentle | dhellmann no worries | 16:28 |
| dhellmann | that's part of why I was suggesting breaking it up though, so you can get some of the bits that do work out of the way | 16:28 |
| dhellmann | that tox.ini change looks doable, too | 16:29 |
| dhellmann | and maybe the version stuff is another patch? | 16:29 |
| annegentle | dhellmann yeah I need to study the version context more | 16:31 |
| *** yamamoto has quit IRC | 16:32 | |
| *** donghao has quit IRC | 16:48 | |
| *** tosky has quit IRC | 16:49 | |
| *** annegentle has quit IRC | 16:55 | |
| *** chlong has quit IRC | 17:02 | |
| *** pcaruana has quit IRC | 17:03 | |
| *** pblaho has quit IRC | 17:10 | |
| *** chlong has joined #openstack-doc | 17:14 | |
| *** pblaho has joined #openstack-doc | 17:23 | |
| *** lucasxu has joined #openstack-doc | 17:24 | |
| *** emagana has joined #openstack-doc | 17:31 | |
| *** pkovar has quit IRC | 17:44 | |
| *** emagana_ has joined #openstack-doc | 17:54 | |
| *** emagana has quit IRC | 17:56 | |
| *** salv-orlando has quit IRC | 18:07 | |
| *** salv-orlando has joined #openstack-doc | 18:08 | |
| *** emagana_ has quit IRC | 18:09 | |
| *** salv-orlando has quit IRC | 18:12 | |
| openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: update contributor guide based on changes after migration project https://review.openstack.org/477624 | 18:18 |
| *** annegentle has joined #openstack-doc | 18:38 | |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Working on integrating options from oslosphinx theme https://review.openstack.org/468021 | 18:47 |
| *** salv-orlando has joined #openstack-doc | 18:49 | |
| annegentle | dhellmann hm, I might not understand "in series" -- I pushed up tox.ini-only changes to https://review.openstack.org/468021. Then I thought I stay on that branch and do git checkout -b next-change | 18:59 |
| annegentle | but that seemed to go from HEAD > new gitlog ID. | 19:00 |
| annegentle | hm | 19:00 |
| *** chlong has quit IRC | 19:02 | |
| annegentle | dhellmann see if you see anything amiss in http://paste.openstack.org/show/613747/ | 19:03 |
| annegentle | dhellmann perhaps in series means with the same topic | 19:03 |
| annegentle | dhellmann since these don't need to be dependent | 19:04 |
| dhellmann | I did mean in the same branch, but you're right they don't have to be | 19:04 |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Updates "Contents" to "Project home page" to better match existing https://review.openstack.org/477635 | 19:05 |
| annegentle | dhellmann ok, but not dependent? | 19:06 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Update requirements https://review.openstack.org/477636 | 19:06 |
| dhellmann | annegentle : I'm not sure what you mean. if you commit, then edit, then commit you'll have a series of 2 changes on the same branch with the second depending on the first. You could do that here. You don't need to, though, if the changes don't actually depend on each other. | 19:07 |
| openstackgerrit | Merged openstack/openstack-manuals master: Build tr_TR image guide https://review.openstack.org/477111 | 19:07 |
| annegentle | dhellmann the paste above shows me doing what I think is that... | 19:07 |
| * dhellmann looks | 19:07 | |
| annegentle | dhellmann but I think then the checkout -b was incorrect | 19:07 |
| dhellmann | yeah, you didn't need to create the new branch | 19:08 |
| annegentle | and you mean that there are multiple commits on the same branch, ok. | 19:08 |
| annegentle | dhellmann meh, I'll do that when necessary | 19:08 |
| annegentle | dhellmann for now, these do not depend on each other. | 19:08 |
| annegentle | dhellmann ok | 19:08 |
| dhellmann | yeah, don't make it more complicated than you need to :-) | 19:08 |
| annegentle | dhellmann thanks, thought I was crazy for a minute :) | 19:08 |
| dhellmann | if you don't want them on the same branch, check out master before making a new branch | 19:08 |
| dhellmann | annegentle : https://review.openstack.org/#/c/468021/17 has replaced your other patch but only includes the tox.ini and .gitignore changes. Is that what you intended? | 19:09 |
| annegentle | dhellmann yes | 19:09 |
| dhellmann | ok | 19:10 |
| annegentle | dhellmann I can go from there now that I see where dependencies may be warranted | 19:10 |
| * dhellmann nods | 19:10 | |
| *** chlong has joined #openstack-doc | 19:16 | |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar https://review.openstack.org/477639 | 19:18 |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar https://review.openstack.org/477639 | 19:25 |
| openstackgerrit | Anne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar https://review.openstack.org/477639 | 19:29 |
| *** salv-orlando has quit IRC | 19:29 | |
| *** salv-orlando has joined #openstack-doc | 19:30 | |
| *** ChanServ has quit IRC | 19:30 | |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Simplify conf.py for openstackdocstheme 1.11.0 https://review.openstack.org/477646 | 19:30 |
| *** salv-orlando has quit IRC | 19:35 | |
| *** ChanServ has joined #openstack-doc | 19:35 | |
| *** card.freenode.net sets mode: +o ChanServ | 19:35 | |
| openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: add a link to the shared install guide https://review.openstack.org/477652 | 19:39 |
| *** ericyoung has quit IRC | 20:10 | |
| *** tesseract has quit IRC | 20:21 | |
| *** salv-orlando has joined #openstack-doc | 20:28 | |
| openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: Simplify conf.py for openstackdocstheme 1.11.0 https://review.openstack.org/477646 | 20:29 |
| *** annegentle has quit IRC | 20:33 | |
| *** emagana has joined #openstack-doc | 20:42 | |
| *** annegentle has joined #openstack-doc | 21:02 | |
| *** annegentle has quit IRC | 21:03 | |
| *** chlong has quit IRC | 21:04 | |
| *** dustins has quit IRC | 21:05 | |
| *** edmondsw has quit IRC | 21:17 | |
| *** edmondsw has joined #openstack-doc | 21:18 | |
| *** annegentle has joined #openstack-doc | 21:18 | |
| *** edmondsw has quit IRC | 21:23 | |
| *** edmondsw has joined #openstack-doc | 21:24 | |
| *** edmondsw has quit IRC | 21:28 | |
| *** edmondsw has joined #openstack-doc | 21:31 | |
| *** edmondsw has quit IRC | 21:35 | |
| *** lucasxu has quit IRC | 21:41 | |
| *** thorst has quit IRC | 21:44 | |
| *** thorst has joined #openstack-doc | 21:46 | |
| *** edmondsw has joined #openstack-doc | 21:50 | |
| *** thorst has quit IRC | 21:50 | |
| *** edmondsw has quit IRC | 21:55 | |
| *** thorst has joined #openstack-doc | 22:05 | |
| *** thorst has quit IRC | 22:09 | |
| *** edmondsw has joined #openstack-doc | 22:18 | |
| *** ericyoung has joined #openstack-doc | 22:22 | |
| *** edmondsw has quit IRC | 22:23 | |
| *** ericyoung has quit IRC | 22:44 | |
| *** rarora has joined #openstack-doc | 22:45 | |
| *** annegentle has quit IRC | 22:47 | |
| *** annegentle has joined #openstack-doc | 23:10 | |
| *** s-shiono has joined #openstack-doc | 23:35 | |
| *** suyog has joined #openstack-doc | 23:46 | |
| *** charcol has joined #openstack-doc | 23:46 | |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!