Tuesday, 2017-08-08

*** thorst has joined #openstack-doc00:00
*** masaki has joined #openstack-doc00:02
*** thorst has quit IRC00:02
*** thorst has joined #openstack-doc00:05
*** gmann has quit IRC00:18
*** gmann has joined #openstack-doc00:18
*** thorst has quit IRC00:23
*** thorst has joined #openstack-doc00:23
*** lucasxu has joined #openstack-doc00:27
*** thorst has quit IRC00:27
*** emagana has quit IRC00:36
*** emagana has joined #openstack-doc00:37
*** thorst has joined #openstack-doc00:38
*** emagana has quit IRC00:41
*** edmondsw has joined #openstack-doc00:42
*** edmondsw has quit IRC00:47
AJaegerdhellmann, annegentle: We fixed already the previous top 10 or so 404s, so now we come to less usual ones. I'm curious where those accesses come from00:52
AJaegerinteresting http://codesearch.openstack.org/?q=%2Ftrunk%2Fopenstack-compute%2Fadmin%2Fcontent%2F&i=nope&files=&repos=00:52
*** lucasxu has quit IRC00:57
*** charcol has joined #openstack-doc00:57
*** gouthamr has quit IRC01:02
*** catintheroof has joined #openstack-doc01:02
*** phuongnh has joined #openstack-doc01:03
*** dmacpher has joined #openstack-doc01:06
*** lucasxu has joined #openstack-doc01:06
*** khushbu has joined #openstack-doc01:11
*** catintheroof has quit IRC01:11
*** khushbu has quit IRC01:15
*** yangyapeng has joined #openstack-doc01:18
*** thorst has quit IRC01:24
*** khushbu_ has joined #openstack-doc02:05
*** charcol has quit IRC02:09
*** khushbu_ has quit IRC02:09
*** charcol has joined #openstack-doc02:09
*** mtreinish has quit IRC02:17
*** mtreinish has joined #openstack-doc02:22
*** edmondsw has joined #openstack-doc02:30
*** edmondsw has quit IRC02:35
*** yamamoto_ has joined #openstack-doc02:46
*** yamamoto has quit IRC02:46
*** charcol has quit IRC03:16
*** nicolasbock has joined #openstack-doc03:25
*** masaki has quit IRC03:30
*** yangyapeng has quit IRC03:33
*** yangyapeng has joined #openstack-doc03:39
*** nicolasbock has quit IRC03:39
*** lucasxu has quit IRC03:43
*** Dinesh_Bhor has joined #openstack-doc03:45
*** yangyapeng has quit IRC03:47
*** yangyapeng has joined #openstack-doc03:47
*** nicolasbock has joined #openstack-doc03:50
*** khushbu_ has joined #openstack-doc03:50
*** yangyapeng has quit IRC03:52
*** yangyapeng has joined #openstack-doc03:52
*** vijaykc4 has joined #openstack-doc03:54
*** yangyapeng has quit IRC03:57
*** yangyapeng has joined #openstack-doc03:57
*** khushbu_ has quit IRC03:58
*** khushbu has joined #openstack-doc03:58
*** yangyapeng has quit IRC04:02
*** yangyapeng has joined #openstack-doc04:07
*** khushbu has quit IRC04:13
*** yangyapeng has quit IRC04:14
*** khushbu has joined #openstack-doc04:15
*** yangyapeng has joined #openstack-doc04:15
*** thorst has joined #openstack-doc04:25
*** thorst has quit IRC04:30
*** nicolasbock has quit IRC05:11
*** vijaykc4 has quit IRC05:35
*** vijaykc4 has joined #openstack-doc05:38
*** vijaykc4 has quit IRC05:44
*** vijaykc4 has joined #openstack-doc05:52
*** nicolasbock has joined #openstack-doc05:53
*** thorst has joined #openstack-doc05:58
*** vijaykc4 has quit IRC06:03
*** thorst has quit IRC06:03
*** vijaykc4 has joined #openstack-doc06:05
*** edmondsw has joined #openstack-doc06:06
*** edmondsw has quit IRC06:11
*** khushbu has quit IRC06:15
*** khushbu has joined #openstack-doc06:15
*** rcernin has joined #openstack-doc06:21
*** vijaykc4 has quit IRC06:29
openstackgerritOpenStack Proposal Bot proposed openstack/api-site master: Imported Translations from Zanata  https://review.openstack.org/49168206:36
*** dmacpher has quit IRC06:48
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata  https://review.openstack.org/49168706:55
*** pcaruana has joined #openstack-doc07:00
*** khushbu has quit IRC07:03
*** vijaykc4 has joined #openstack-doc07:09
*** vijaykc4 has quit IRC07:13
*** tesseract has joined #openstack-doc07:21
*** mpranjic has quit IRC07:24
*** khushbu_ has joined #openstack-doc07:32
*** yamamoto_ has quit IRC07:44
*** yamamoto has joined #openstack-doc07:50
*** edmondsw has joined #openstack-doc07:54
*** alexchadin has joined #openstack-doc07:55
*** edmondsw has quit IRC07:59
*** thorst has joined #openstack-doc07:59
*** thorst has quit IRC08:04
*** vijaykc4 has joined #openstack-doc08:43
*** yamamoto has quit IRC08:49
asettleMorning o/08:50
chasonasettle Morning o/08:56
asettleyellow o08:56
asettleo/ *08:56
*** alexchadin has quit IRC09:03
*** alexchadin has joined #openstack-doc09:15
*** nicolasbock has quit IRC09:15
*** yamamoto has joined #openstack-doc09:15
*** sambetts|afk is now known as sambetts09:20
*** yamamoto has quit IRC09:22
openstackgerritMerged openstack/openstack-manuals master: [arch-guide] Completing storage design section  https://review.openstack.org/49127409:28
*** tosky has joined #openstack-doc09:29
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [arch-guide] completed work on network services section  https://review.openstack.org/49134109:37
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [arch-guide] Make menu under design consistent and not redundant  https://review.openstack.org/49129209:37
openstackgerritMerged openstack/api-site master: Imported Translations from Zanata  https://review.openstack.org/49168209:37
*** vijaykc4 has quit IRC09:40
*** vijaykc4 has joined #openstack-doc09:42
*** edmondsw has joined #openstack-doc09:43
*** nicolasbock has joined #openstack-doc09:43
openstackgerritMerged openstack/openstack-manuals master: Imported Translations from Zanata  https://review.openstack.org/49168709:45
*** edmondsw has quit IRC09:47
openstackgerritMerged openstack/openstack-manuals master: [arch-guide] Make menu under design consistent and not redundant  https://review.openstack.org/49129209:51
*** yamamoto has joined #openstack-doc09:54
*** alexchadin has quit IRC09:59
*** thorst has joined #openstack-doc10:00
*** pkovar has joined #openstack-doc10:04
*** thorst has quit IRC10:05
*** yamamoto has quit IRC10:07
*** yamamoto has joined #openstack-doc10:12
*** yangyapeng has quit IRC10:12
*** yangyapeng has joined #openstack-doc10:12
*** yamamoto has quit IRC10:17
*** yamamoto has joined #openstack-doc10:18
openstackgerritMerged openstack/openstack-manuals master: Project data: update details about Sahara guides  https://review.openstack.org/49154210:18
*** yangyapeng has quit IRC10:18
*** odyssey4me has quit IRC10:18
*** odyssey4me has joined #openstack-doc10:19
*** yamamoto has quit IRC10:20
*** yamamoto has joined #openstack-doc10:20
*** AJaeger is now known as AJaeger_10:26
*** pkovar has quit IRC10:27
*** khushbu_ has quit IRC10:35
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [arch-guide-archive] Removing old arch guide from master  https://review.openstack.org/49175010:42
*** thorst has joined #openstack-doc10:42
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [install-guide] Remove debian files from master  https://review.openstack.org/49175110:46
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [arch-guide] completed work on network services section  https://review.openstack.org/49134110:50
*** thorst has quit IRC10:54
*** thorst has joined #openstack-doc10:54
*** yamamoto has quit IRC10:58
*** thorst has quit IRC10:59
*** yamamoto has joined #openstack-doc10:59
*** sdague has joined #openstack-doc10:59
*** phuongnh has quit IRC11:01
*** vijaykc4 has quit IRC11:02
*** vijaykc4 has joined #openstack-doc11:02
*** vijaykc4 has quit IRC11:03
*** yamamoto has quit IRC11:05
*** yamamoto has joined #openstack-doc11:07
*** yamamoto has quit IRC11:08
*** pkovar has joined #openstack-doc11:09
*** yamamoto has joined #openstack-doc11:10
*** yamamoto has quit IRC11:13
*** yamamoto has joined #openstack-doc11:15
*** JoseMello has joined #openstack-doc11:16
*** yamamoto has quit IRC11:16
*** yamamoto has joined #openstack-doc11:16
*** vijaykc4 has joined #openstack-doc11:17
*** alexchadin has joined #openstack-doc11:19
openstackgerritMerged openstack/openstack-manuals master: [arch-guide] completed work on network services section  https://review.openstack.org/49134111:31
asettleppssstt AJaeger_ you're meant to be OOO :p11:31
AJaeger_asettle: jetlagged ;( I could sleep until 3am local time ;(11:38
* AJaeger_ disappears again11:39
*** thorst has joined #openstack-doc11:51
*** khushbu_ has joined #openstack-doc11:53
*** khushbu_ has quit IRC11:54
*** vijaykc4 has quit IRC11:55
*** khushbu_ has joined #openstack-doc11:55
*** khushbu_ has quit IRC11:55
*** khushbu_ has joined #openstack-doc11:56
*** edmondsw has joined #openstack-doc11:57
*** vijaykc4 has joined #openstack-doc11:58
asettleAJaeger_: get some sleep!12:00
*** jpena|off is now known as jpena12:03
*** vijaykc4 has quit IRC12:04
ianychoiSleeping is good - although I don't know myself when I sleep...12:10
*** yamamoto has quit IRC12:18
dhellmannAJaeger_, asettle: o/12:20
asettleMorning :)12:20
*** yamamoto has joined #openstack-doc12:20
asettleianychoi: you never sleep man12:20
*** yamamoto has quit IRC12:20
ianychoiasettle, no no no no no. People cannot live without sleeping!12:21
asettleYou're slowly proving otherwise :P12:21
ianychoiHaha12:22
dhellmannasettle : do we have someone interested in working on redirects for some of those 404s?12:27
asettledhellmann: I'm sure we could reach out and see who is12:27
asettleMaybe chason or pkovar might be able to help :)12:27
*** mpranjic has joined #openstack-doc12:28
*** vijaykc4 has joined #openstack-doc12:28
pkovarheh, sure12:28
* asettle rolls a bus over pkovar12:29
pkovarwhat's the context?12:29
dhellmannpkovar : http://files.openstack.org/docs-404s/2017-08-08.txt12:29
dhellmannthat's a list of the latest 404s on the docs site12:29
openstackgerritMerged openstack/openstackdocstheme master: Break cycle dependency with os-api-ref  https://review.openstack.org/49115712:29
dhellmannsome of them are old paths for content managed by the docs team, that is either gone or removed12:29
dhellmannit would be useful to have redirects in place to help users find that content, or at least a page that explains that some content has been removed (like linking the juno install guide to the /juno page)12:30
asettledhellmann: do you have an example patch of some 404s already completed that we can show people?12:30
pkovarthat would be helpful, yes12:31
pkovari guess it should go to https://github.com/openstack/openstack-manuals/blob/master/www/.htaccess12:31
dhellmannnot really, but there are already some redirect rules in www/.htaccess12:31
dhellmannpkovar : yes, that's right12:31
dhellmannyou can ignore references to projects that are not listed in www/project-data/latest.yaml12:31
pkovardhellmann: that's tons of lines in that file. can we ignore those 1's? (is that a number of hits?)12:32
dhellmannactually, you can ignore any references to any projects, since they can have their own .htaccess file now12:32
dhellmannyeah, start from the top and work your way down. we don't have to get every one of them, but some of the more obviously moved stuff would be good12:32
pkovaryeah, makes sense12:33
dhellmannand focus on stuff owned by the docs team12:33
*** khushbu_ has quit IRC12:36
asettledhellmann: so I spent some time looking at my 'files left to address' at the top here: https://etherpad.openstack.org/p/doc-migration-tracking12:37
dhellmannok12:37
dhellmannlooking12:37
asettleI've reached out to Ben about the Arch guide, I know that pkovar has been going through the contrib guide a bit, I just fixed up the install files, aspiers is doing a marvelous job of being busy lately so I can't get a hold of him to chat about the HA guide, just deleted teh arch guide archive12:38
asettleSo, wanted to chat about those admin guide files, and teh glossary12:38
dhellmannwhere would you like to start?12:38
asettleLet's go admin files12:38
asettleI'm wondering if I just move those to the operations guide in the before-migration tag?12:39
asettleAlso, that's my best recommendation for it. Not necessarily the route we have to take.12:39
toskydhellmann: about http://files.openstack.org/docs-404s/2017-08-08.txt, is it possible to see where the failing links are?12:39
dhellmannhmm, well, there isn't really any way to move them to the tagged content, unless we create a branch there12:39
toskyI see some of the sahara 404 in www/static/sitemap.xml, which seems to be manually regenerated from time to time12:39
dhellmannwe could make a branch12:39
toskybut I'm not sure if they are all there12:40
asettleUgh that's just painful hey. I did take a look through - it almost doesn't seem worth the pain.12:40
dhellmannalthough that would imply that it might be a place people could submit patches12:40
dhellmanntosky : we aren't collecting referrers, but you could talk to the folks in #openstack-infra about it. I think clarkb has done most of the work on building that list.12:40
*** yamamoto has joined #openstack-doc12:40
asettledhellmann: yeah let's not do that.12:40
dhellmannok12:41
asettleI did take a look, I'm not too sure how useful they are, tbh. My other option was to add a 'cross project config' section to the install guide12:41
asettleI already\ suggested the firewall default ports go there.12:41
dhellmannthat cors stuff could also go into the oslo.middleware docs12:41
dhellmannwe might want to find a way to make it more visible, if we move it there12:42
aspiersasettle: I'm free to talk, but I also just got approval for Denver \o/12:42
asettleOkay, maybe that's the best option then.12:42
asettleaspiers: hooray! That's great news12:42
asettleSign yourself for another session on HA planning. We need to smash this out in Queens12:42
dhellmannand moving the firewalls stuff into the install guide makes sense to me12:42
asettledhellmann: okay cool. I'll go ahead and move the firewalls file, would you mind moving the cors stuff to oslo-config12:43
AJaeger_tosky: use codesearch.openstack.org to check current code for links12:43
asettleI'll delete the cross-project.rst file12:43
aspiersasettle: sure12:43
dhellmannasettle : sure, I can do that12:43
asettledhellmann: okay, meet you in the middle!12:43
asettleNext chat, the glossary12:43
toskyAJaeger_: but does www/static/sitemap.xml count?12:43
AJaeger_tosky: that was just regenerated last week...12:44
asettleaspiers: we need to figure out if you and csatari really do have the time to work on the proposed plan or not. Hopefully next cycle it should be our only 'doc' goal. Whereas the rest will be focused on finalising the migration12:44
AJaeger_tosky: we can regenerate it any time again12:44
aspiersasettle: gotcha12:44
asettleaspiers: if neither of you can dedicate time to finalise it, we'll do what we've done with the arch guide. Stamp it with a time and date, and if people want to pick it up as a full, dedicated, project in the future. We can do that.12:45
asettledhellmann: So, I think a separate glossary might be the way to go. Instead of having the glossary linked as a separate file at the end of each doc, it would be linked as a separate book12:45
aspiersasettle: TBH I don't think it's a huge amount of work. I suspect I could make quite a of progress in Denver, *if* I don't have a lot of other things to work on while I'm there12:46
asettleAt the moment, at the end of each doc, it lists the whole friggin alphabet.12:46
toskyAJaeger_: sure, but still I'm not sure if it's part of the search results12:46
aspiersalthough I do want to work with the watcher team12:46
toskyAJaeger_: for example, userdoc/vanilla_plugin.html has one hit here: http://git.openstack.org/cgit/openstack/driverlog/tree/etc/default_data.json#n561012:46
toskyI guess that it should be fixed as well, but then, uhm12:46
asettleaspiers: yeah the 'if' is what I'm a little worried about, sadly. We've been talking about this for a while now. We did have a lot of resources when we came up with the plan, and I want to realistically sit down and determine if this is actually going to be adoable12:46
asettledoable*12:46
*** jpena is now known as jpena|mtg12:46
dhellmannasettle : my original idea was that we would trim the unused references, but that hasn't happened12:46
asettleBecause although it seems like not a lot of work, we've kind of sitting on it for a little while.12:46
aspiersfair point12:47
asettledhellmann: in the glossary?12:47
dhellmannright12:47
aspiersasettle: the beauty of the PTG is the reduced distractions12:47
dhellmannasettle: I'm going to go make some breakfast and let you finish talking with aspiers :-)12:47
aspiersa whole week of ignoring normal email12:47
asettledhellmann: do you want to add that to the list of things to do?12:47
dhellmannlet's decide what outcome we want first12:47
asettledhellmann: okay :) i'm doing an excellent job of juggling :P12:47
asettledhellmann: sounds like a good idea12:47
asettleaspiers: good point. Okay, well, how about we aim for a discussion after the docs sessions Mon - Tues (so, Wed, mid-week). You can let me know how much time you think you have, and then you and I (with the new PTL) can discuss next best steps.12:48
*** vijaykc4 has quit IRC12:48
aspiersasettle: sure12:48
*** matjazp has joined #openstack-doc12:52
asettle*dusts off hands* phew12:53
asettleAll done then12:53
asettledhellmann: you can come back now :p12:53
* dhellmann puts down his toast12:55
*** jpena|mtg is now known as jpena|off12:56
dhellmannasettle : so, we could make the glossary a separate doc build or we could think again about combining all of the remaining guides into one build12:57
openstackgerritMerged openstack/openstack-manuals master: [arch-guide-archive] Removing old arch guide from master  https://review.openstack.org/49175012:58
dhellmannIIRC, translation was the main reason for not doing that?12:58
csatariaspiers, asettle: I have some time for the HA guide in the next cycle and I can spend time on it on the ptg also.12:58
aspierscsatari: great!12:59
asettledhellmann: yes I believe so, and I don't think putting them all in a single build this cycle (or even next) is the best idea. It seemed most efficient when we started talking about it, but we have so many kinks to work out12:59
asettleBut yes, my thoughts are putting the glossary in a separate doc build (as we have for the other guides)12:59
dhellmannok, that makes sense12:59
*** catintheroof has joined #openstack-doc13:00
dhellmanndo you know how the cross-referencing works with a remote guide like that?13:00
asettledhellmann: between different repos, or between guide-to-guide in os-manuals?13:01
dhellmannit's effectively the same thing, isn't it?13:01
dhellmannfrom one sphinx build to another?13:01
*** lucasxu has joined #openstack-doc13:02
asettleTrue.13:02
dhellmannhttp://www.sphinx-doc.org/en/stable/tutorial.html#intersphinx13:03
asettleThat looks snazzy13:04
asettleBut I thought we stopped referencing the glossary within the docs?13:04
asettleDidn't we remove most?13:04
dhellmannoh, did we?13:04
dhellmannwell, then13:04
asettleI'm fairly sure most instances of :term: was removed with the migration. Which doesn't leave much left with the rest of the docs13:05
AJaeger_I guess, we removed them from the docs moved to project teams13:05
asettleBasically, yeah13:05
AJaeger_we did not change glossary for openstakc-manuals13:05
asettleDo we want to keep it referenced throughout?13:05
AJaeger_Still, we could tell folks about it and provide a solution this way13:05
dhellmannthere are over 1000 references using :term: in the manuals repo13:05
*** yangyapeng has joined #openstack-doc13:05
dhellmannat least according to git grep13:06
AJaeger_dhellmann: remove the po files13:06
AJaeger_I get 173 without po13:06
dhellmannI get 123; I'll bet you haven't updated to remove the arch-design-archive stuff13:07
AJaeger_ah, indeed13:07
AJaeger_dhellmann: either way - less than 1000 ;)13:07
dhellmannyes, true13:08
dhellmannhow do you anticipate the glossary content being used?13:08
asettleYikes13:08
asettledhellmann: reference point, more than anything13:08
dhellmannthat's what I mean: as a reader, when am I going to go to the glossary? and how would I find it?13:09
pkovarsearch?13:09
asettleHave the guide available on docs.o.o as part of the resources. Link at the end of each guide (instead of it being built in as a file now)13:10
dhellmannwhat docs do we have that will link to the glossary if we move it out into its own guide?13:10
AJaeger_dhellmann: it's also for writers: A place to find our defintions and proper spelling13:10
asettleSO, its still IN the guides, referenced, it just builds separately13:10
dhellmannok13:10
*** yangyapeng has quit IRC13:10
asettledhellmann: specifically we'd put it at the end of each of the guides that we currently build in os-manuals, and then we can also have it perhaps at the top of each of the install/admin/user pages in the intro text13:10
pkovarcould we make a reference to glossary  a part of the theme?13:11
asettleBut taht might be a bit much (the last bit)13:11
asettlepkovar: how do you reckon we do that?13:11
pkovarput in the footer?13:11
pkovar* it13:11
asettleOh yeah, that could work. Hmm. Would we have to do a docstheme release each time the doc updated though?13:11
dhellmannthe URL won't change, will it?13:12
AJaeger_asettle: pkovar: let me show you something...: Click on the word "OpenStack Documentation" in the sidebar13:12
pkovarit wont, i believe13:12
stephenfinasettle, dhellmann: Remind me - would the likes of this document be covered in openstack-manuals still? https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/admin-guide/source/firewalls-default-ports.rst13:12
stephenfin...because it's common stuff shared between projects?13:12
asettleAJaeger_: the sidebar of where?13:12
asettlestephenfin: I"m acutally about to move that to the install guide that's still being built in os-manuals13:12
stephenfinasettle: Job13:13
dhellmannAJaeger_ : oh, good point, it can go in that list13:13
AJaeger_http://paste.opensuse.org/4958151413:13
AJaeger_asettle: ^13:13
pkovari like that idea, AJaeger_13:13
pkovarmuch more visible than footer13:14
AJaeger_Is it visible? Seems asettle didn't know it exists ;)13:14
asettleOhhh yes, that's is a good idea13:14
* asettle shuffles awkwardly13:14
mpranjichello hello13:15
mpranjicguys and galls, whom to bug to check why I can't login to our wiki with ubuntuOne acc?13:15
asettlempranjic: I messaged you back this morn :)13:16
asettleJump into infra13:16
AJaeger_mpranjic: #openstack-infra13:16
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [install-guide] Moves firewall doc to install-guide  https://review.openstack.org/49179613:17
mpranjicasettle: I was up2 elbows with upgrading Debian on my workstation, must have missed it, sorry13:17
mpranjicAJaeger_: thnx13:17
asettlempranjic: np :)13:17
asettlestephenfin dhellmann - firewall file moved13:17
*** khushbu has joined #openstack-doc13:18
*** yangyapeng has joined #openstack-doc13:19
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [install-guide] Moves firewall doc to install-guide  https://review.openstack.org/49179613:19
dhellmannasettle : ok, so who is going to set up the new glossary build?13:20
dhellmannthis would be a good time for someone else to learn how the build scripts work :-)13:21
asettleDo we not have this already: https://review.openstack.org/#/c/478142/13:21
AJaeger_somebody needs to rebase ^13:22
asettlehaha I can do the rebase13:22
asettleBut that sets most of it up, no?13:22
stephenfindhellmann: If you can wait a week, I can do it. I would imagine not though ;)13:25
dhellmannah, I didn't realize we had that patch already13:29
asettledhellmann: *nods*13:29
asettleThat's why I'm thinking we utilize it13:29
dhellmannwfm13:33
asettlestephenfin: responded to your question in my PR.13:33
asettledhellmann: lemme pull it down and rebase13:34
stephenfinasettle: ...and +1d. Missed that13:34
asettlestephenfin: np. I should have explained better13:34
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: Build separate glossary  https://review.openstack.org/47814213:38
asettleRebaseeeee13:39
asettleThat was surprisingly easy. I expected that to be more difficult13:39
*** alexchadin has quit IRC13:39
*** alexchadin has joined #openstack-doc13:40
*** alexchadin has quit IRC13:40
*** alexchadin has joined #openstack-doc13:40
*** alexchadin has quit IRC13:41
*** alexchadin has joined #openstack-doc13:41
*** alexchadin has quit IRC13:41
*** alexchadin has joined #openstack-doc13:42
asettleAJaeger_: do you want to remove your -2 on this one? https://review.openstack.org/#/c/478142/13:42
dhellmannasettle : my guess is that https://review.openstack.org/#/c/491796/ will fail because nothing references the cors file. That file has already been imported into the oslo.middleware docs, so you could just update your patch to remove it (if I'm wrong, and yours passes the build jobs, I will submit a separate patch to remove it)13:44
asettledhellmann: can do :)13:44
asettleActually, I should just delete all the admin stuff now13:45
asettleI'll fix this one up, and then do a separate patch13:45
dhellmann++13:46
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [install-guide] Moves firewall doc to install-guide  https://review.openstack.org/49179613:46
asettleOkay ^ updated13:46
asettleDeletes all those files.13:46
asettleI'll grab another patch to delete the rest of the admin-guide from master13:46
*** alexchadin has quit IRC13:46
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: [admin-guide] Deleting the remainder of the admin-guide from master  https://review.openstack.org/49181413:48
asettleOkay, I think that does it13:49
dhellmannok, I'll look at those after my meeting13:56
asettle(Y)13:57
*** gouthamr has joined #openstack-doc14:00
*** mihalis68 has joined #openstack-doc14:02
*** mriedem has joined #openstack-doc14:09
*** khushbu has quit IRC14:13
*** Guest13936 is now known as med_14:21
*** med_ has quit IRC14:21
*** med_ has joined #openstack-doc14:21
*** med_ is now known as medberry14:21
openstackgerritMohammad Rizwan proposed openstack/openstack-manuals stable/ocata: Added note for the connection paremeter placement in neutron.conf  https://review.openstack.org/49116314:22
*** jpena|off is now known as jpena14:25
*** khushbu_ has joined #openstack-doc14:30
openstackgerritAlexandra Settle proposed openstack/openstack-manuals stable/ocata: Added note for the connection paremeter placement in neutron.conf  https://review.openstack.org/49116314:33
*** khushbu_ has quit IRC14:34
sdagueso... one of the challenges with the segmented install guide is branch references14:35
asettlesdague: example?14:36
sdaguehttps://review.openstack.org/#/c/491785/2/doc/source/index.rst@5114:37
sdagueI want to link to Horizon, that link goes to latest14:37
asettlesdague: the user guide was never versioned.14:37
sdaguehowever once that is in the pike branch, that means the pike docs are going to pop out to latest on the horizon side14:37
asettleSo there was never a past to link to14:37
sdagueasettle: ok14:38
sdaguewell, admin guide / install guide will have similar challenges14:38
asettlesdague: at least there, you can link back to the openstack-manuals links14:38
*** jpena is now known as jpena|off14:38
sdagueasettle: ??14:38
asettlesetuid has been working on our archiving stuff, as you are aware of14:38
asettleWell, sdague if you want to link to docs for install - we have the prior releases still published on docs.o.o14:39
asettleAdmin was never versioned either, however14:39
sdagueok, but now that we're in tree like this, this is going to be versioned, right?14:39
asettlesdague: Good thoughts. Hmmm, yes. Yes it will be. Cause you'll release, and cut the docs in the same branch.14:40
sdagueregardless of how things were, I'm trying to understand how this doesn't end up getting really confusing about being in a pike/ doc that takes you to a master doc of another project14:40
asettleYes, I see what you mean now.14:40
asettleI was thinking about linking *now*14:40
asettleSo, I know OSA implemented something to fix taht problem :)14:41
asettleUno momento14:41
*** emagana has joined #openstack-doc14:42
*** alexchadin has joined #openstack-doc14:42
*** medberry is now known as med_14:43
*** alexchadin has quit IRC14:47
asettlesdague: sigh, naturally I can't find it. Basically they implemented a variable, so that it auto-detected the release pattern14:47
*** emagana has quit IRC14:52
asettleAh sdague I believe this is it: https://github.com/openstack/openstack-ansible/blob/master/deploy-guide/source/conf.py#L7114:53
*** annegentle has joined #openstack-doc14:56
asettleAHUH14:56
asettlehttps://review.openstack.org/#/c/417976/14:56
*** emagana has joined #openstack-doc14:56
*** emagana has quit IRC15:01
sdaguehmm...15:04
sdagueis that something we could get baked back into openstacktheme ?15:04
sdaguehttps://review.openstack.org/#/c/417976/3/deploy-guide/source/conf.py15:04
sdagueso that we had some stanza we could use for cross linking other projects at the correct branch15:04
annegentlesdague good thinking - I bet more people would look for it there, though it'll also take patching of conf.py files either way, right?15:06
sdagueannegentle: will it?15:06
sdaguewe're doing an import in conf of openstacktheme, it's all python15:07
annegentlesdague yeah looks like it, adding 'sphinx.ext.extlinks' and then the variables15:07
sdagueso any code that you'd write in conf.py could be back in openstacktheme15:08
* annegentle scratches head15:08
dhellmannI wonder if we could use http://www.sphinx-doc.org/en/stable/ext/intersphinx.html#module-sphinx.ext.intersphinx instead of inventing something ourselves15:08
asettleSorry, ran off15:09
asettleWe could easily use something already invented :) I was just pointing to a solution I know works15:09
asettleAlthough it admittedly broke with the theme stuff15:09
annegentledhellmann heh it sounded like intersphinx but it is extlinks instead, depends on whether we consider these guides "external" or "inter"15:09
asettleBut having something in the theme would help across the board15:09
asettleexternal?15:09
dhellmann"link to other projects' documentation"15:10
dhellmannisn't that what we're talking about doing?15:10
annegentledhellmann yeah asettle what doug said15:10
sdaguedhellmann: yeh, the trick of it is that it's got to branch match as well15:10
asettleIt's not so much the linking to other projects documentation that's the issue, the issue is the release candidates. So, the solution that was implemented in OSA was to auto detect the branch15:11
asettleHave a look at: https://review.openstack.org/#/c/417976/15:11
dhellmannsdague : yes, we would need to combine intersphinx with something that knows the current branch to set the URLs for the remote inv files15:11
dhellmannwe could add a function to the theme to figure that out15:11
sdaguewe need to be able to drop a stanza in to nova docs in master than in master renders to horizon/latest and in stable/pike renders to horizon/pike15:11
asettleThat would be well cool :)15:11
*** khushbu has joined #openstack-doc15:12
sdaguehowever it is done is fine, I'm just expressing the need15:12
dhellmannyou would say intersphinx_mapping = { 'horizon': (openstackdocstheme.get_project_doc_url('horizon'), None)}15:12
dhellmannthen in the nova docs you would just use :ref:`blah` to make the references15:12
*** shaunm has quit IRC15:12
dhellmannor maybe :ref:`blah <horizon:blah>`15:13
sdaguedhellmann: can you give an example of blah?15:13
dhellmannany target you've added with _ name::15:13
dhellmannsorry, it's ".. _blah::"15:13
dhellmannthe benefit of using :ref: is you don't have to update nova's docs when horizon moves something15:13
dhellmannwell, you don't have to update it manually, you'd need them rebuilt15:14
sdagueso :ref:`horizon:user/launch-instances` ?15:14
dhellmannbut that happens every time a patch lands15:14
dhellmannuser/launch-instances looks like a doc name15:14
dhellmannI don't know if this works with docs15:14
dhellmannit seems to be focused on internal anchors15:14
sdagueok, let me express the concern clearly15:15
sdagueIn Nova documentation, we often need to link to specific parts of other project documentation, as nova requires other projects to function15:15
sdagueso we need to be able to deep link into other project docs15:15
dhellmannyeah, that's what this is for15:16
*** khushbu has quit IRC15:16
sdaguehowever, the way to do that today with hrefs means we put things like `Horizon <https://docs.openstack.org/horizon/latest/user/launch-instances.html>`_15:16
dhellmannright, this is like a late-binding symbolic linker15:16
openstackgerritMerged openstack/openstack-manuals master: [install-guide] Remove debian files from master  https://review.openstack.org/49175115:16
sdaguewhich will be pointing to the wrong thing when stable/pike is cut15:16
dhellmannyou say "horizon has some of the symbols I want to link to"15:16
dhellmannand then you say "link to this symbol"15:17
dhellmannand sphinx figures out what you mean15:17
sdagueok, so if you can provide a mechanism and a worked example of how to link to that page15:17
sdaguethen I'm good15:17
annegentledhellmann sdague asettle honestly, stick to what people know best, which is URLs.15:17
annegentlethey can trust their intent is known "I mean to link to latest"15:17
sdagueannegentle: except they are all going to be wrong the moment we branch15:17
annegentlesdague as a best practice though, think of the end goal15:17
annegentlesdague we want people to upgrade constantly15:18
annegentlesdague yes it forces their hand15:18
sdagueannegentle: that's not useful if you have the pike install guide for nova link out to queens neutron config15:18
sdagueit's like punch users in the face bad15:18
annegentlesdague ok then this solution always can do pike to pike and queens to queens? Go for it15:19
dhellmannsdague : it would really help me work with you if you stop expressing shortcomings in such extreme language15:19
annegentlesdague it's a layer of complexity that has tradeoffs15:19
dhellmannbecause really, I do have other things to do, and that makes me less interested in helping you15:19
annegentlethat's all I'm saying15:19
sdaguedhellmann: ok, I'm sorry15:19
annegentlesdague dhellmann we're in dragon territory and there's a fine line between simple and complex15:20
*** vijaykc4 has joined #openstack-doc15:20
sdagueannegentle: maybe, but if the way our docs are experienced by our end users ends up taking them to specifically the wrong information, because it's jumping releases15:20
annegentlehonestly we gave up semantic markup over the years15:20
dhellmannsdague : can you give me a location in the nova docs that links to the horizon docs?15:20
sdaguethat is not in any way going to help with perceptions of the software being complex15:21
annegentleand, nova had intersphinx enabled for years and no one used it15:21
sdaguedhellmann: https://review.openstack.org/#/c/491785/2/doc/source/index.rst@5115:21
annegentleso I'm a skeptic15:21
sdaguein review, should land soon15:21
dhellmannah, an open review, ok, I can build on that15:21
sdagueannegentle: we weren't managing things like the install guide15:21
sdagueit was all concepts and less details15:22
sdaguethe install guide is really the one that I'm most concerned about, as that something which is branched, people are used to it that way, and at each release specific neutron stuff is required to line up with specific nova stuff (and ironic and others)15:23
sdaguewhich was handled by the unified manual automatically, but was lost when moving back into projects15:24
*** vijaykc4 has quit IRC15:25
annegentlesdague yep it's a new route for sure15:26
sdagueannegentle: ok, it's frustrating to hear the pov that we shouldn't bother to try to fix it, because it seems to me to be really important to provide an install guide that makes sense. :(15:33
annegentlesdague pretty sure that's not what I'm saying. what I'm saying is "at release time, make sure your URLs point to what you want"15:34
annegentlesdague which is what we have documented in the docs "how to release" guide15:34
annegentlesdague so yeah, assume best intent here please :)15:34
sdagueannegentle: so we have to branch stable, then build process all the links in the docs, which also makes backports harder?15:35
annegentlesdague at release time, before creating the stable branch, point your URLs where you mean to15:35
sdagueannegentle: well, after stable cut, otherwise you have to revert master again immediately15:36
sdaguebecause we need latest and stable to both work15:36
annegentlesdague ah yes15:36
sdagueyeh, I suppose you could build a bulk tool for that to heuristically replace docs.openstack.org/([^/]+/latest with branch specific reference15:39
sdagueit would be less error prone if we had a stanza that did the right thing though, so that if one project forgot that step, it wouldn't break the user experience15:40
*** tosky has quit IRC15:40
*** tosky has joined #openstack-doc15:40
annegentlesdague probably that's what AJaeger_ did when he did the branch cut. He's a wizard.15:41
annegentlesdague I'm thinking the projects won't do the markup, that's all.15:41
sdagueannegentle: i'm more concerned that projects want to the url fixing15:42
sdaguesorry, that projects won't do the url fixing15:42
sdagueman, all my english was apparently spent on nova docs this morning15:43
annegentleEnglish much? :)15:43
annegentle^^ yeah that's not English either :)15:44
*** vijaykc4 has joined #openstack-doc15:45
*** JoseMello has quit IRC15:45
*** emagana has joined #openstack-doc15:46
*** yamamoto has quit IRC15:54
*** yamamoto has joined #openstack-doc15:58
asettleOkay, so, where'd we land on this one annegentle sdague dhellmann ?15:59
asettleBack from meetings again16:00
*** yamamoto has quit IRC16:03
*** khushbu has joined #openstack-doc16:08
dhellmannsorry, went to find lunch16:09
dhellmannI'm going to work on a proof-of-concept for a little bit after I eat16:10
asettleokay, that soundss good :) I can review tomorrow16:11
*** mihalis68 has quit IRC16:12
*** yangyapeng has quit IRC16:21
*** emagana has quit IRC16:21
*** yangyapeng has joined #openstack-doc16:21
*** emagana_ has joined #openstack-doc16:21
*** yangyapeng has quit IRC16:26
*** pcaruana has quit IRC16:27
*** rcernin has quit IRC16:31
*** tesseract has quit IRC16:31
*** matjazp has quit IRC16:38
*** alexchadin has joined #openstack-doc16:44
*** KeithMnemonic has joined #openstack-doc16:45
*** KeithMnemonic has quit IRC16:47
*** annegentle has quit IRC16:49
*** alexchadin has quit IRC16:49
*** KeithMnemonic has joined #openstack-doc16:49
*** KeithMnemonic has quit IRC16:52
*** khushbu has quit IRC16:58
*** tosky has quit IRC17:04
*** khushbu has joined #openstack-doc17:05
*** khushbu has quit IRC17:06
*** pkovar has quit IRC17:11
*** annegentle has joined #openstack-doc17:12
*** khushbu has joined #openstack-doc17:13
*** khushbu has quit IRC17:17
openstackgerritDoug Hellmann proposed openstack/openstackdocstheme master: add get_intersphinx_settings function  https://review.openstack.org/49186417:19
dhellmannsdague, asettle, annegentle: here's one poc: https://review.openstack.org/#/q/topic:add-intersphinx17:20
dhellmannI want to try one other thing17:20
*** yangyapeng has joined #openstack-doc17:21
*** yangyapeng has quit IRC17:26
*** sambetts is now known as sambetts|afk17:29
*** khushbu has joined #openstack-doc17:31
openstackgerritDoug Hellmann proposed openstack/openstackdocstheme master: add get_series_name()  https://review.openstack.org/49186817:31
dhellmannsdague, asettle, annegentle : an alternate implementation: https://review.openstack.org/#/q/topic:add-extlinks17:32
*** yangyapeng has joined #openstack-doc17:40
*** khushbu has quit IRC17:42
*** yangyapeng has quit IRC17:45
*** alexchadin has joined #openstack-doc17:45
*** annegentle has quit IRC17:45
*** alexchadin has quit IRC17:49
*** emagana_ has quit IRC18:25
*** khushbu_ has joined #openstack-doc18:29
*** khushbu_ has quit IRC18:31
openstackgerritMerged openstack/openstack-manuals stable/ocata: Added note for the connection paremeter placement in neutron.conf  https://review.openstack.org/49116318:32
*** nicolasbock has quit IRC18:32
*** yangyapeng has joined #openstack-doc18:41
*** alexchadin has joined #openstack-doc18:46
*** yangyapeng has quit IRC18:46
*** alexchadin has quit IRC18:50
*** dustins has joined #openstack-doc18:51
*** matjazp has joined #openstack-doc19:01
*** vijaykc4 has quit IRC19:13
*** yangyapeng has joined #openstack-doc19:42
*** yangyapeng has quit IRC19:47
*** rromans has quit IRC19:52
*** dustins has quit IRC20:00
*** emagana has joined #openstack-doc20:07
*** lucasxu has quit IRC20:17
*** rromans has joined #openstack-doc20:20
*** emagana_ has joined #openstack-doc20:26
*** emagana has quit IRC20:26
sdaguedo we have a theory on how to handle the config-reference auto generated things which I don't think we have support for autogenerating in project trees?20:44
sdagueconfig-reference/source/tables/nova-vmware.rst is the one that I'm currenty curious about20:44
*** yamamoto has joined #openstack-doc21:09
*** yamamoto has quit IRC21:21
*** annegentle has joined #openstack-doc21:32
*** thorst has quit IRC21:37
*** edmondsw has quit IRC21:38
*** yangyapeng has joined #openstack-doc21:43
*** yangyapeng has quit IRC21:48
*** yamamoto has joined #openstack-doc21:59
*** emagana_ has quit IRC22:06
*** emagana has joined #openstack-doc22:07
*** emagana has quit IRC22:11
*** emagana has joined #openstack-doc22:23
*** emagana has quit IRC22:28
*** thorst has joined #openstack-doc22:38
*** emagana has joined #openstack-doc22:42
*** thorst has quit IRC22:43
*** yangyapeng has joined #openstack-doc22:44
*** yangyapeng has quit IRC22:48
*** charcol has joined #openstack-doc23:04
*** sdague has quit IRC23:22
*** catintheroof has quit IRC23:29
*** yangyapeng has joined #openstack-doc23:45
*** yangyapeng has quit IRC23:50
*** suyog has joined #openstack-doc23:58

Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!