Monday, 2015-08-31

*** steveg_afk has joined #openstack-doc00:06
*** yushiro has joined #openstack-doc00:13
*** yushiro has left #openstack-doc00:13
*** stevemar has quit IRC00:13
*** cloudtrainme has quit IRC00:13
*** steveg_afk has quit IRC00:18
*** sigmavirus24 is now known as sigmavirus24_awa00:22
*** steveg_afk has joined #openstack-doc00:25
*** rdo has quit IRC00:27
*** rdo has joined #openstack-doc00:29
*** ddomingo has joined #openstack-doc00:52
*** adahms_ has joined #openstack-doc00:55
*** adahms has quit IRC00:55
*** chlong has joined #openstack-doc00:55
*** tbarron has quit IRC01:07
*** salv-orlando has joined #openstack-doc01:07
*** salv-orlando has quit IRC01:13
*** salv-orlando has joined #openstack-doc01:13
*** salv-orlando has quit IRC01:26
*** suyog has quit IRC01:26
*** adahms_ has quit IRC01:36
*** adahms has joined #openstack-doc01:39
*** suyog has joined #openstack-doc01:40
*** chlong has quit IRC01:49
*** furface is now known as furface_afk01:49
*** steveg_afk has quit IRC01:56
openstackgerritluzhiyuan proposed openstack/openstack-manuals: modify the command description  https://review.openstack.org/21870002:07
*** JRobinson__ is now known as JRobinson__afk02:12
openstackgerritMerged openstack/openstack-manuals: Fix links/add missing links in the top bar  https://review.openstack.org/21859802:18
*** cloudtrainme has joined #openstack-doc02:20
*** tbarron has joined #openstack-doc02:20
openstackgerritYucai Li proposed openstack/api-site: Fix a mistake in decription about Volume manage extension  https://review.openstack.org/21870202:23
*** sigmavirus24_awa is now known as sigmavirus2402:23
*** liangbo has joined #openstack-doc02:23
*** stevemar has joined #openstack-doc02:25
*** salv-orlando has joined #openstack-doc02:28
*** stevemar has quit IRC02:30
*** cloudtrainme has quit IRC02:32
*** asettle has quit IRC02:40
*** salv-orlando has quit IRC02:41
openstackgerritluzhiyuan proposed openstack/openstack-manuals: modify the command description  https://review.openstack.org/21870002:43
*** asettle has joined #openstack-doc02:44
*** JRobinson__afk has quit IRC02:47
openstackgerrithuanglu proposed openstack/openstack-manuals: Repeated words in Networking Guide  https://review.openstack.org/21812502:50
*** sigmavirus24 is now known as sigmavirus24_awa02:53
openstackgerritMatthew Kassawara proposed openstack/openstack-manuals: [network-guide] Update L3 HA scenarios  https://review.openstack.org/21646202:57
openstackgerritMerged openstack/openstack-manuals: Fixed manual [OpenStack End User Guide],section[Launch and manage stacks] original description is as following: --------------------------------------------------------------------------------------- Depending on the source that you select, enter the URL,  https://review.openstack.org/21821103:10
openstackgerritMerged openstack/openstack-manuals: Fixed sentences to a meaningful way  https://review.openstack.org/21867203:15
openstackgerritMerged openstack/openstack-manuals: Update API reference listing for Kilo and Liberty  https://review.openstack.org/21859903:15
*** furface_afk is now known as furface03:18
openstackgerritMerged openstack/openstack-manuals: modify the command description  https://review.openstack.org/21870003:25
*** sigmavirus24_awa has quit IRC03:25
*** jroll has quit IRC03:26
openstackgerritMerged openstack/openstack-manuals: Repeated words in Networking Guide  https://review.openstack.org/21812503:26
openstackgerritMerged openstack/openstack-manuals: [network-guide] Update L3 HA scenarios  https://review.openstack.org/21646203:30
*** jroll has joined #openstack-doc03:31
openstackgerritMerged openstack/openstack-doc-tools: Add doc-tools-build-rst  https://review.openstack.org/21604303:34
*** sigmavirus24_awa has joined #openstack-doc03:35
openstackgerritMerged openstack/openstack-doc-tools: Fix XML file generation error for cli-reference in murano case  https://review.openstack.org/21723803:36
*** salv-orlando has joined #openstack-doc03:43
*** Piet has joined #openstack-doc03:55
*** Piet has quit IRC03:56
*** salv-orlando has quit IRC03:56
*** Piet has joined #openstack-doc03:56
*** Piet has quit IRC03:59
*** stevemar has joined #openstack-doc04:23
*** furface has quit IRC04:32
*** JRobinson__afk has joined #openstack-doc04:36
*** JRobinson__afk is now known as JRobinson__04:37
*** furface has joined #openstack-doc04:44
*** salv-orlando has joined #openstack-doc04:52
*** furface has quit IRC04:55
*** furface has joined #openstack-doc04:56
*** salv-orlando has quit IRC04:57
*** salv-orlando has joined #openstack-doc04:57
*** ig0r__ has joined #openstack-doc04:59
*** ig0r_ has quit IRC04:59
*** puranamr has joined #openstack-doc05:05
*** asettle has quit IRC05:06
*** asettle has joined #openstack-doc05:08
*** salv-orlando has quit IRC05:10
*** liangbo has quit IRC05:14
*** asettle has quit IRC05:14
*** asettle has joined #openstack-doc05:14
*** adahms has quit IRC05:25
openstackgerritYutaro Iwakiri proposed openstack/api-site: remove broken link in overview of api-site  https://review.openstack.org/21872805:27
*** furface has quit IRC05:34
*** furface has joined #openstack-doc05:35
openstackgerritpartys proposed openstack/openstack-manuals: Rectify spelling mistake in install-guide  https://review.openstack.org/21873105:36
*** furface has quit IRC05:51
*** furface has joined #openstack-doc05:53
openstackgerritpartys proposed openstack/openstack-manuals: Rectify spelling mistake in install-guide  https://review.openstack.org/21873305:54
*** liangbo has joined #openstack-doc05:58
openstackgerritOpenStack Proposal Bot proposed openstack/operations-guide: Imported Translations from Transifex  https://review.openstack.org/21873406:01
*** salv-orlando has joined #openstack-doc06:10
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals: Imported Translations from Transifex  https://review.openstack.org/21873906:14
*** stevemar has quit IRC06:15
*** stevemar has joined #openstack-doc06:29
*** taroth1 has joined #openstack-doc06:36
*** furface is now known as furface_afk06:51
openstackgerritMerged openstack/operations-guide: Imported Translations from Transifex  https://review.openstack.org/21873406:52
*** stevemar has quit IRC06:53
*** puranamr has quit IRC06:58
openstackgerritMerged openstack/openstack-manuals: Imported Translations from Transifex  https://review.openstack.org/21873906:59
*** stevemar has joined #openstack-doc07:00
*** neoXsys has joined #openstack-doc07:00
openstackgerritMerged openstack/openstack-manuals: Rectify spelling mistake in install-guide  https://review.openstack.org/21873107:01
*** liangbo has quit IRC07:02
openstackgerritShuquan Huang proposed openstack/openstack-manuals: Add an admonition about converting windows VM from vmdk to qcow2  https://review.openstack.org/21834707:08
*** ddomingo has quit IRC07:15
openstackgerritAllen proposed openstack/openstack-manuals:  Add settings tab in "log_in_dashboard.rst"  https://review.openstack.org/21815307:15
*** jpena has joined #openstack-doc07:15
openstackgerritAllen proposed openstack/openstack-manuals:  Add settings tab in "log_in_dashboard.rst"  https://review.openstack.org/21815307:18
*** marcusvrn_ has quit IRC07:25
*** bmoss has quit IRC07:26
*** asettle has quit IRC07:30
openstackgerritAllen proposed openstack/openstack-manuals: Add volume snapshots sub tab in "log_in_dashboard.rst"  https://review.openstack.org/21875107:39
*** JRobinson__ has quit IRC07:47
*** liangbo has joined #openstack-doc07:49
*** matjazp has joined #openstack-doc07:59
*** matjazp has quit IRC08:09
*** matjazp has joined #openstack-doc08:21
*** salv-orlando has quit IRC08:24
*** salv-orlando has joined #openstack-doc08:25
*** pblaho has joined #openstack-doc08:28
*** amotoki has joined #openstack-doc08:41
*** dguitarbite has joined #openstack-doc08:42
*** liangbo has quit IRC08:46
*** yushiro has joined #openstack-doc08:59
*** suyog has quit IRC09:01
*** ildikov has joined #openstack-doc09:02
*** liangbo has joined #openstack-doc09:03
openstackgerritMerged openstack/openstack-manuals: Rectify spelling mistake in install-guide  https://review.openstack.org/21873309:23
*** salv-orlando has quit IRC09:24
*** yushiro has quit IRC09:36
*** ig0r_ has joined #openstack-doc09:37
*** ig0r__ has quit IRC09:39
*** sayan has joined #openstack-doc09:50
openstackgerritNeil Jerram proposed openstack/openstack-manuals: networking-guide: various corrections to Networking overview page  https://review.openstack.org/21856909:52
*** adahms has joined #openstack-doc09:53
*** pc_m has joined #openstack-doc10:12
openstackgerritluzhiyuan proposed openstack/openstack-manuals: add a command note  https://review.openstack.org/21879310:16
openstackgerritOlga Gusarenko proposed openstack/openstack-manuals: [Contributor Guide] RST references  https://review.openstack.org/21879910:33
*** matjazp has quit IRC10:34
openstackgerritOlga Gusarenko proposed openstack/openstack-manuals: [Contributor Guide] RST references  https://review.openstack.org/21879910:39
openstackgerritOlga Gusarenko proposed openstack/openstack-manuals: [Contributor Guide] RST references  https://review.openstack.org/21879910:41
*** dguitarbite has quit IRC11:04
*** matjazp has joined #openstack-doc11:07
*** dguitarbite has joined #openstack-doc11:20
*** stevemar has quit IRC11:22
*** amotoki has quit IRC11:39
*** amotoki has joined #openstack-doc11:39
*** openstackgerrit has quit IRC11:46
*** openstackgerrit has joined #openstack-doc11:47
*** pots has joined #openstack-doc11:54
*** petertr7_away is now known as petertr712:09
*** jpena is now known as jpena|lunch12:18
openstackgerritKeiichiro Tokunaga proposed openstack/api-site: Refactoring on "Security groups and rules" section  https://review.openstack.org/21692712:22
openstackgerritKeiichiro Tokunaga proposed openstack/api-site: Add missing object to "Security groups and rules"  https://review.openstack.org/21728512:22
*** steveg_afk has joined #openstack-doc12:30
openstackgerritEduardo Felipe Zecca da Cruz proposed openstack/openstack-manuals: HNAS documentation: Liberty Updates  https://review.openstack.org/21713012:36
*** annegentle has joined #openstack-doc12:44
*** adahms has quit IRC12:52
annegentlemorning!12:58
annegentlehey arrsim now I know your IRC nick, cool :)12:58
openstackgerritMerged openstack/openstack-manuals: Fix migrate command in admin doc  https://review.openstack.org/21813012:58
*** cloudtrainme has joined #openstack-doc13:00
*** pots1 has joined #openstack-doc13:03
*** pots has quit IRC13:04
openstackgerritShuquan Huang proposed openstack/openstack-manuals: Add an admonition about converting windows VM from vmdk to qcow2  https://review.openstack.org/21834713:06
*** pots has joined #openstack-doc13:06
*** pots1 has quit IRC13:08
*** rbowen has joined #openstack-doc13:11
*** kencjohn_ has joined #openstack-doc13:15
*** jpena|lunch is now known as jpena13:18
*** liangbo has quit IRC13:21
arrsimhey annegentle I'm about to head to bed it's getting late here, but i'll speak to you in the morning :)13:24
annegentlearrsim: sounds good :)13:26
*** shaunm has joined #openstack-doc13:29
*** stevemar has joined #openstack-doc13:34
*** salv-orlando has joined #openstack-doc13:36
*** stevemar has quit IRC13:39
*** matjazp has quit IRC13:39
*** cloudtrainme has quit IRC13:42
*** cloudtrainme has joined #openstack-doc13:46
*** annegentle has quit IRC13:49
openstackgerritEduardo Felipe Zecca da Cruz proposed openstack/openstack-manuals: HNAS documentation: Liberty Updates  https://review.openstack.org/21713013:51
*** KLevenstein has joined #openstack-doc13:52
*** dustins has joined #openstack-doc13:52
*** sigmavirus24_awa is now known as sigmavirus2413:56
*** cloudtrainme has quit IRC14:03
*** cloudtrainme has joined #openstack-doc14:08
*** jroll has quit IRC14:09
*** jroll has joined #openstack-doc14:09
*** pm90_ has joined #openstack-doc14:12
*** pm90__ has joined #openstack-doc14:14
*** pm90_ has quit IRC14:17
*** cloudtrainme has quit IRC14:18
*** annegentle has joined #openstack-doc14:19
*** cloudtrainme has joined #openstack-doc14:20
*** ildikov has quit IRC14:20
*** jmckind has joined #openstack-doc14:23
*** sayan has quit IRC14:23
*** cloudtrainme has quit IRC14:30
*** cloudtrainme has joined #openstack-doc14:34
*** cloudtrainme has quit IRC14:34
*** cloudtrainme has joined #openstack-doc14:35
*** ildikov has joined #openstack-doc14:36
*** stevemar has joined #openstack-doc14:48
*** stevemar has quit IRC14:50
*** petertr7 is now known as petertr7_away14:51
*** petertr7_away is now known as petertr714:59
openstackgerritMerged openstack/api-site: Refactoring on "Security groups and rules" section  https://review.openstack.org/21692715:01
openstackgerritMerged openstack/api-site: Add missing object to "Security groups and rules"  https://review.openstack.org/21728515:01
*** pm90__ has quit IRC15:04
*** pm90_ has joined #openstack-doc15:06
*** zz_steveortiz is now known as steveortiz15:06
openstackgerritDiane Fleming proposed openstack/api-site: Fix a mistake in decription about Volume manage extension  https://review.openstack.org/21870215:06
*** pots has left #openstack-doc15:08
*** sigmavirus24 is now known as sigmavirus24_awa15:09
*** stevemar has joined #openstack-doc15:16
*** sigmavirus24_awa is now known as sigmavirus2415:17
*** pm90_ has quit IRC15:17
*** stevemar has quit IRC15:21
*** etoews has joined #openstack-doc15:28
*** david-ly_ has joined #openstack-doc15:31
*** david-ly_ is now known as david-lyle_15:33
*** david-lyle has quit IRC15:33
*** david-lyle_ is now known as david-lyle15:35
*** puranamr has joined #openstack-doc15:35
*** pm90_ has joined #openstack-doc15:36
*** pm90_ has quit IRC15:39
*** pm90_ has joined #openstack-doc15:39
*** matjazp has joined #openstack-doc15:43
*** matjazp has quit IRC15:43
*** Piet has joined #openstack-doc15:44
*** amotoki has quit IRC15:50
*** stevemar has joined #openstack-doc15:57
*** sigmavirus24 is now known as sigmavirus24_awa15:59
*** annegentle has quit IRC15:59
*** matjazp has joined #openstack-doc16:00
*** puranamr has quit IRC16:01
*** sigmavirus24_awa is now known as sigmavirus2416:01
*** sayali has quit IRC16:04
*** sayali has joined #openstack-doc16:06
openstackgerritChris Maio proposed openstack/openstack-manuals: Vendor docs for Dot Hill, HP MSA and Lenovo arrays  https://review.openstack.org/21808516:09
*** pm90__ has joined #openstack-doc16:13
*** pm90_ has quit IRC16:16
*** Swami has joined #openstack-doc16:24
*** salv-orl_ has joined #openstack-doc16:25
*** salv-orlando has quit IRC16:28
*** liangbo has joined #openstack-doc16:31
*** jmckind_ has joined #openstack-doc16:34
openstackgerritMatjaz Pancur proposed openstack/training-guides: [training-guides] improve the index.rst file  https://review.openstack.org/21894316:35
*** jmckind has quit IRC16:35
*** annegentle has joined #openstack-doc16:35
*** geoffarnold has joined #openstack-doc16:39
openstackgerritDiane Fleming proposed openstack/api-site: Update rescue and unrescue operations  https://review.openstack.org/21605616:39
*** sicarie has joined #openstack-doc16:48
*** jpena has quit IRC16:51
*** sayan has joined #openstack-doc16:55
*** salv-orl_ has quit IRC16:56
*** puranamr has joined #openstack-doc17:01
*** exploreshaifali has joined #openstack-doc17:04
*** shaunm has quit IRC17:07
openstackgerritbruce-benjamin proposed openstack/security-doc: [security-guide] Ephemeral encryption setup The Data Encryption section in the OpenStack security guide needs some info added to describe how to enable ephemeral disk encryption. Change-Id: I58766ee7481ee9cbba3cd2a960adcaf4809d8ee0 Closes-Bug: #1467551  https://review.openstack.org/21895617:09
openstackbug 1467551 in openstack-manuals "Add info regarding recommended settings for ephemeral disk encryption in the Data Encryption section" [Wishlist,Confirmed] https://launchpad.net/bugs/1467551 - Assigned to Bruce Benjamin (bruce-benjamin)17:09
openstackgerritbruce-benjamin proposed openstack/security-doc: [security-guide] Ephemeral encryption setup  https://review.openstack.org/21895617:11
*** jmckind_ has quit IRC17:15
*** jmckind has joined #openstack-doc17:17
*** jmckind has quit IRC17:21
*** liangbo has quit IRC17:23
*** ildikov has quit IRC17:31
*** kencjohn_ has quit IRC17:32
*** stevemar has quit IRC17:35
*** stevemar has joined #openstack-doc17:38
*** stevemar has quit IRC17:42
*** ig0r__ has joined #openstack-doc17:43
*** ig0r_ has quit IRC17:46
*** sayan has quit IRC17:49
*** Guest57338 has joined #openstack-doc17:53
openstackgerritKaren Bradshaw proposed openstack/api-site: Fix typo in identity-api v3, href attr  https://review.openstack.org/21897118:01
*** KLevenstein has quit IRC18:03
*** stevemar has joined #openstack-doc18:03
*** salv-orlando has joined #openstack-doc18:04
*** shaunm has joined #openstack-doc18:07
*** salv-orlando has quit IRC18:09
*** cloudtrainme has quit IRC18:10
*** pm90_ has joined #openstack-doc18:11
*** pm90__ has quit IRC18:15
*** ildikov has joined #openstack-doc18:20
*** petertr7 is now known as petertr7_away18:23
*** petertr7_away is now known as petertr718:25
*** KLevenstein has joined #openstack-doc18:27
*** exploreshaifali has quit IRC18:28
*** matjazp has quit IRC18:36
*** salv-orlando has joined #openstack-doc18:39
*** KLevenstein has quit IRC18:42
*** pcm_ has joined #openstack-doc18:43
*** KLevenstein has joined #openstack-doc18:44
*** pc_m has quit IRC18:45
*** ig0r__ has quit IRC18:48
*** Guest57338 has quit IRC18:49
*** sayan has joined #openstack-doc18:50
*** sayan has quit IRC18:52
*** sayan has joined #openstack-doc18:52
*** MasterPiece has joined #openstack-doc18:52
*** sayan has quit IRC18:52
*** matjazp has joined #openstack-doc18:53
*** stevemar has quit IRC18:54
*** sayan has joined #openstack-doc19:00
*** MasterPiece has quit IRC19:00
*** matjazp has quit IRC19:06
*** matjazp has joined #openstack-doc19:12
*** pm90_ has quit IRC19:23
*** deepti-mtg has joined #openstack-doc19:23
*** dnavale has quit IRC19:24
*** sayan has quit IRC19:27
*** petertr7 is now known as petertr7_away19:28
*** exploreshaifali has joined #openstack-doc19:33
*** kencjohn_ has joined #openstack-doc19:36
*** salv-orlando has quit IRC19:37
openstackgerritDiane Fleming proposed openstack/api-site: Update rescue and unrescue operations  https://review.openstack.org/21605619:38
*** kencjohn_ has quit IRC19:46
openstackgerritDiane Fleming proposed openstack/api-site: Fix parameter description error  https://review.openstack.org/21747419:47
*** kencjohn_ has joined #openstack-doc19:47
*** petertr7_away is now known as petertr719:48
openstackgerritDiane Fleming proposed openstack/api-site: Fix parameter description error.  https://review.openstack.org/21747719:49
*** njohnston is now known as nate_gone19:49
*** salv-orlando has joined #openstack-doc19:50
*** stevemar has joined #openstack-doc19:54
openstackgerritMerged openstack/api-site: Fix a mistake in decription about Volume manage extension  https://review.openstack.org/21870219:56
*** stevemar has quit IRC19:59
arrsimannegentle: which room are we meeting in?20:01
openstackgerritChristian Berendt proposed openstack/openstack-doc-tools: Only extract subcommands from lastline of bash-completion output  https://review.openstack.org/21901420:01
*** david-lyle has quit IRC20:01
openstackgerritChristian Berendt proposed openstack/openstack-manuals: Update CLI reference for python-glanceclient 1.0.0  https://review.openstack.org/21901520:04
annegentlehey arrsim turns out Monty couldn't make it20:05
arrsim:(20:05
annegentleso rescheduled for tomorrow, but you and I can meet here now20:05
annegentleif that's ok20:05
arrsimyeah, it's fine20:06
*** david-lyle has joined #openstack-doc20:06
annegentleyay we got the talk proposal accepted!20:06
annegentle:)20:06
arrsimI saw that.  Pressure is on :)20:06
annegentlearrsim: we can do it!20:06
*** petertr7 is now known as petertr7_away20:06
annegentlearrsim: I can dig up the convo I had last Friday with the infra team, but the gist is, they coudln't tell from the spec that we'd need a whole 'nother server20:07
arrsimit's good because it will help create an deadline.  Makes motivation easier20:07
annegentlearrsim: oh for sure20:07
annegentleI need it!20:07
annegentleI'm happy to see Karen Bradshaw working issues20:07
arrsimyeah, I need it too20:07
arrsimyeah Karen making great progress considering the total lack of documentation20:08
arrsimI actually have a few email threads that I should convert into documentation.20:08
arrsimso what was the conversation with the infra team?20:08
annegentlearrsim: heh20:09
annegentlearrsim: oh let me dig it up20:09
*** stevemar has joined #openstack-doc20:10
annegentlearrsim: http://eavesdrop.openstack.org/irclogs/%23openstack-infra/%23openstack-infra.2015-08-28.log.html look around 2:2020:10
arrsimbecause I think that we have 2 options, at the moment there are no dynamic API queries, so we could make the website into a totally static one.  But at some point in the future, if we want to embed etc, we will probably want to be able to filter the API's that are returned, so it would need a server20:10
annegentleer, 20:2020:10
annegentleyeah we can make it static for October-ish20:10
annegentlethat'll help get heads wrapped around what we're trying to do20:10
annegentlearrsim: I need to make sure I am communicating it correctly, too, so feel free to edjumacate me as need be :)20:12
annegentlearrsim: I think we're converting for now20:12
openstackgerritMerged openstack/api-site: Fix typo in identity-api v3, href attr  https://review.openstack.org/21897120:14
openstackgerritChristian Berendt proposed openstack/openstack-doc-tools: openstack-auto-commands: fix issues with python-glanceclient 1.0.0  https://review.openstack.org/21901420:14
*** puranamr has quit IRC20:14
*** puranamr has joined #openstack-doc20:15
openstackgerritChristian Berendt proposed openstack/openstack-manuals: Update CLI reference for python-glanceclient 1.0.0  https://review.openstack.org/21901520:15
arrsimso at the moment, I'm actually aiming to have a live server that translates the RST on the fly20:17
annegentlearrsim: hey one part I want to understand, are the RST files pulled in now anywhere?20:17
annegentle(for display or whatever)20:17
arrsimin regards to the the generation of the documentation from the live services, I hear what they are saying.  Seems reasonable.20:17
arrsimyes20:17
annegentleand is there any "full Swagger spec" for any of the services that uses $ref references?20:18
annegentleI see a bunch of JSON but no overarching collection doc, is that right?20:18
arrsimso there are RST files stored in a directory, at server start, it reads them and generates a navigation.  From there the v2.rst and the v2-tags.rst are combined and rendered to JSON20:18
arrsimyes20:18
openstackgerritKaren Bradshaw proposed openstack/api-site: Fix missing methods, orchestration-api  https://review.openstack.org/21901820:18
arrsimat the moment I'm using $ref to pull in examples20:18
annegentleok! where's that $ref so I can see an example?20:19
annegentlewould it make sense to publish a full Swagger spec in addition to the readable pages?20:19
arrsimit doesn't need to be there, but it's there because when I made the RST, putting examples inline seemed ugly and would get worse when embedded in source code20:19
arrsimwe can do anything.  We could render a giant JSON file, but at the moment the browser doesn't support that20:20
arrsimwe could even render a simpler static page from the RST for offline delivery?20:21
arrsimchrome app?20:21
annegentleor, RST with swagger-ui inline?20:21
arrsimI mean, we have options.  Whether we make one monolithic file, or just have an offline browser that scrapes everything down.20:22
annegentleI'm trying to have fewer dependencies for infra to install, but we can talk more to Monty tomorrow about whether that's a "real" concern.20:22
annegentleI mean, what we want is readable docs, maintainable source.20:22
annegentlewe totally do have tons of options20:23
annegentlehey I just fwded an email to your gmail account20:23
arrsimwith the inline stuff, that is a bit more complicated.. But  when we make a sphinx plugin, it can pull down the JSON and store it in the static resources for that doc20:23
annegentleoh because swagger-ui wouldn't know about our vendor extensions necessarily? So we'd have to maintain a fork of swagger-ui anyway... then maintain a sphinx plugin too. hrm20:23
arrsimhow did I miss that email....20:24
annegentlewell I din't realize til just now that he only sent that reply to me20:24
annegentleso... onlist offlist I guess20:24
arrsimthe sphinx plugin, could use resources from the browser.20:24
annegentleis delivering swagger the outcoming, or is a readable web page the outcome? To me it's the readable web page.20:24
arrsimbasically, if I make the browser a widget, then we can embed it.  Angular tries to force you to break down the app into components anyway20:24
annegentleoutcome not outcoming :)20:24
arrsimyep I agree20:25
arrsimin the sphinx plugin we could pull down the Swagger, and then render it to HTML20:25
arrsimso that it doesn't rely on JS to convert it in the browser20:25
annegentleI sense it's phased: Phase I: get rid of WADL as much as possible, display what we can in a static site. Phase II: get teams to submit Swagger somewhere, publish it with the static site. Phase III: with Swagger files, compare new ones to old ones when the tool generates the Swagger files?20:26
annegentleI can't jump to Phase III yet :)20:26
arrsimactually.  I think I have a different phased approach.20:28
annegentlearrsim: go go :)20:28
annegentledo tell20:28
arrsimphase 1: convert all wadl to RST (confirm that nothing is lost, the best we can).  phase 2: all RST and JSONSchema files are stored within the fairy-slipper app.  phase 3: start pusing RST doc and JSONSchema to projects.20:29
openstackgerritPradeep Kilambi proposed openstack/openstack-manuals: Add docs around declarative meters  https://review.openstack.org/21778020:30
arrsimso in phase 2 we may still be maintain the doc, but during this phase, I intend on developing tools piggy back on Tempest, to hopefully reduce the bitrot.20:30
annegentlearrsim: just to clarify, phase 1: convert wadl/docbook to json/rst? Then push that into api-site?20:31
arrsimyep20:31
annegentleand then how do we store within fairy-slipper? is fairy-slipper a converter for phase 1, and becoming a generator for phase 2?20:32
arrsimit already is20:33
arrsimit doesn't need to be20:33
arrsimbut at the moment all the docs are centralised, and the conversion process is a one off thing20:33
annegentlearrsim: ok I need to understand the generation part, can we do a walk-through? Is it with cinder.py in fairy-slipper that's "generating" JSON?20:33
arrsimwe could put the RST/JSONSchema in it's own repo20:33
annegentlearrsim: not a bad idea, certainly helps with understanding what's what20:34
annegentlearrsim: with enough clarity we can move api-site to the attic perhaps20:34
arrsimwell that is the end game really20:34
openstackgerritMerged openstack/api-site: Remove extra "issued_at" parameter and add "token" parameter  https://review.openstack.org/21606820:35
openstackgerritMerged openstack/api-site: Fix inappropriate parameter type  https://review.openstack.org/21634920:35
arrsimok I have forwarded you an email, have a read from "OK, so the conversion_files are madness,"20:37
*** pm90_ has joined #openstack-doc20:37
annegentlearrsim: so looking at https://github.com/russell/fairy-slipper/blob/master/fairy_slipper/cinder.py -- is line 19 actually running through all the routes for a cinder service?20:37
openstackgerritMerged openstack/openstack-manuals: HNAS documentation: Liberty Updates  https://review.openstack.org/21713020:37
openstackgerritMerged openstack/openstack-manuals: [Contributor Guide] RST references  https://review.openstack.org/21879920:37
annegentlearrsim: basically, looking at https://github.com/russell/fairy-slipper/blob/master/fairy_slipper/controllers/routes.py as long as there's a /v1 route it can et all the possible routes?20:38
annegentleget, eat, et, whatever :)20:38
arrsimI am trying to bulid things iteratively, so in the middle step the projects don't have any RST, so in the mean time I have a repository of converted RST files that can power fairy-slipper20:41
arrsimyep you can parse all the routes,  but at the moment they have no data.20:41
annegentlearrsim: thinking of Monty's comment "because it looks like the cinder api code is copied in and stubbed out - which _also_ doesn't solve the "up to date" problem"20:41
arrsimwe can parse them to say, highlight missing routes in the doc20:41
annegentlearrsim: so, we'll get a baseline set of routes for at least four or five of the projects20:42
annegentlearrsim: maybe even 6-7 projects20:42
openstackgerritDiane Fleming proposed openstack/api-site: Add descriptions of timestamp parameters  https://review.openstack.org/21644020:42
*** cloudtrainme has joined #openstack-doc20:42
annegentlearrsim: but then still have to document how other projects can use this tool20:42
arrsimfor the time being, but as we push the documentation out to them we can start using them as the source.20:42
arrsimwe could then have one of the gate jobs regen the static RST files for the live site, or we could feed it live from an API20:43
*** puranamr has quit IRC20:46
arrsimI also saw Monty's concern about having it fed live from an API20:46
*** puranamr has joined #openstack-doc20:46
annegentleyah20:48
annegentleI think their team's concerns are about uptime, ensuring they can troubleshoot, maybe other things I'm not thinking of20:48
annegentleso we can meet with Monty tomorrow but this is good base layering for me20:49
*** adahms has joined #openstack-doc20:49
arrsimyep,  so at the moment, we can make the site static,  there is nothing that relies on it to be dynamic.  But.  In the future, we may need to be able to query things.20:50
annegentlegot it.20:50
arrsimBut..20:50
annegentleand then for now, the routes are based on the WADL that exists?20:50
annegentleor am I totally missing the point?20:51
arrsimif we change the API to merge all the versions of an service API together, and then have a version selector of some kind.  We may want to have a query API. (I'm thinking of micro versions)20:51
arrsimyep, correct20:51
annegentleomg likely. yah on micro versions20:51
arrsimthey are all parsed out of the WADL.20:51
annegentlearrsim: ok. I really think that was a good cleanup step.20:51
annegentlearrsim: the wadl check20:52
annegentlearrsim: so we dont' have a way for a project that doesn't have WADL to make swagger, they should make it another way20:52
annegentlefor now20:52
arrsimwe can do some filtering of the JSON in the browser, but the JSON payload may get too big20:52
arrsimthat is the real constraint.20:52
arrsimI actually do have a fully defined RST language, that covers the swagger, but to render it we will need to use the proto-type browser20:53
*** Swami has quit IRC20:53
arrsimI would also like some feedback on it before getting people to write real documentation in it20:53
*** ildikov has quit IRC20:54
annegentleIs that what I see when I run the pecan server locally?20:54
annegentlethe prototype browser?20:54
arrsimype20:54
arrsimyep20:54
annegentleok yeah let's get input on it20:55
*** cloudtrainme has quit IRC20:55
annegentlearrsim: I'm still liking the RST plus swagger-ui idea because that is a solution I think we can get more people to understand/maintain, but that might be me worrying too much20:56
arrsimthis is what it looks like for an API request/response http://pastebin.com/r6Y2yx9m20:56
annegentlearrsim: ok, yeah, that's what I can now view locally20:56
arrsimso those requestexamples translate into $ref fields20:56
arrsimit was just easier at the time20:57
arrsimbut the complexity at the moment with just relying on embedding is how versions and things like that are supported20:58
arrsimthere are also other things like filtering that will not be possible20:58
arrsimI think that the direct embedding has it's strengths, especially in the narrative documentation sense20:58
annegentlearrsim: I think those of us currently reading WADL+entity will want to read JSON+$ref20:59
*** furface_afk is now known as furface20:59
annegentleat least that's the way I think of it20:59
arrsimwhat do you mean by entity?  My wadl isn't that strong21:01
arrsimlike the substituting thing.  For common parameters?21:01
annegentleoh the common.ent references scattered throughout21:03
*** nate_gone is now known as njohnston21:03
*** furface has quit IRC21:03
*** furface has joined #openstack-doc21:04
*** annegentle has quit IRC21:04
arrsimyeah,  I'm not totally sure how that is going to work.  It reminds me of transclusion in mediawiki.  But at the moment I haven't supported it.21:05
arrsimit's going to be a similar problem to the one we will have when microversions comes to mess up our party21:06
arrsimJSON+$ref seems to be used in swagger so that JSONSchema and Examples don't need to be contained in the swagger itself21:07
*** matjazp has quit IRC21:07
*** stevemar has quit IRC21:08
arrsimbut any duplication is bad.  I hate duplication,   the problem is how do we solve it without making it impossible to understand the repercussion to other API's.21:09
arrsimgosh, we have gone way off topic now21:09
*** puranamr has quit IRC21:16
*** puranamr has joined #openstack-doc21:16
*** dustins has quit IRC21:26
openstackgerritMerged openstack/api-site: Fix parameter description error.  https://review.openstack.org/21747721:29
*** mudassirlatif has joined #openstack-doc21:32
*** kencjohn_ has quit IRC21:34
*** annegentle has joined #openstack-doc21:35
*** shaunm has quit IRC21:35
*** annegent_ has joined #openstack-doc21:38
openstackgerritRay Schneider proposed openstack/openstack-manuals: Fixing typo  https://review.openstack.org/21903921:39
*** annegentle has quit IRC21:40
arrsimannegent_, your back..  i’m such a noob,  i was talking to your dissconnected socket21:42
annegent_arrsim: sorry, had to drive to avoid traffice21:44
annegent_I'll catch up on eavesdrop21:44
*** matjazp has joined #openstack-doc21:45
*** matjazp has quit IRC21:55
openstackgerritRay Schneider proposed openstack/openstack-manuals: Fixing typo  https://review.openstack.org/21903921:58
*** pm90__ has joined #openstack-doc22:04
openstackgerritRay Schneider proposed openstack/openstack-manuals: Typo fix in dashboard_next_step.rst  https://review.openstack.org/21904422:07
*** pm90_ has quit IRC22:08
*** steveortiz is now known as zz_steveortiz22:12
*** sigmavirus24 is now known as sigmavirus24_awa22:15
*** asettle has joined #openstack-doc22:18
*** matjazp has joined #openstack-doc22:19
openstackgerritRay Schneider proposed openstack/openstack-manuals: Typo fix for neutron-compute-node.rst  https://review.openstack.org/21904922:21
*** Piet has quit IRC22:22
*** matjazp has quit IRC22:23
*** annegent_ has quit IRC22:32
openstackgerritbruce-benjamin proposed openstack/operations-guide: [openstack-ops] Adding storage decision entry about encryption  https://review.openstack.org/21905222:32
*** annegentle has joined #openstack-doc22:32
*** suyog_ has joined #openstack-doc22:32
*** pcm_ has quit IRC22:33
*** KLevenstein has quit IRC22:34
*** furface is now known as furface_afk22:37
*** steveg_afk has quit IRC22:38
*** furface_afk is now known as furface22:40
*** furface has quit IRC22:43
*** furface has joined #openstack-doc22:49
*** bmoss has joined #openstack-doc22:50
*** deepti-mtg is now known as dnavale22:51
*** furface has quit IRC22:51
*** Piet has joined #openstack-doc22:52
*** JRobinson__ has joined #openstack-doc22:53
*** furface has joined #openstack-doc22:54
openstackgerritMerged openstack/openstack-manuals: Fixing typo  https://review.openstack.org/21903922:58
openstackgerritMerged openstack/openstack-manuals: Typo fix for neutron-compute-node.rst  https://review.openstack.org/21904923:00
openstackgerritMerged openstack/openstack-manuals: Typo fix in dashboard_next_step.rst  https://review.openstack.org/21904423:00
*** stevemar has joined #openstack-doc23:04
*** annegentle has quit IRC23:04
*** exploreshaifali has quit IRC23:04
*** adahms has quit IRC23:14
openstackgerritMerged openstack/openstack-manuals:  Add settings tab in "log_in_dashboard.rst"  https://review.openstack.org/21815323:33
*** sicarie has quit IRC23:35
*** stevemar has quit IRC23:38
*** pm90__ has quit IRC23:44
*** yushiro has joined #openstack-doc23:47
openstackgerritAtsushi SAKAI proposed openstack/openstack-manuals: Add magnum/manila/murano on Chap1/AppendixA in CLI Reference  https://review.openstack.org/21814723:55

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