*** bmoss has joined #openstack-doc | 00:05 | |
*** deepti-mtg is now known as dnavale | 00:06 | |
*** thorst has joined #openstack-doc | 00:08 | |
*** Qiming_ has quit IRC | 00:14 | |
*** thorst has quit IRC | 00:27 | |
*** suyog has joined #openstack-doc | 00:28 | |
*** hoangcx has joined #openstack-doc | 00:51 | |
openstackgerrit | Nam Nguyen Hoai proposed openstack/api-site: Neutron Provider Networks' link references are wrong https://review.openstack.org/285277 | 00:53 |
---|---|---|
*** mfuruta has joined #openstack-doc | 00:57 | |
*** yangyapeng has joined #openstack-doc | 01:05 | |
*** yangyapeng has quit IRC | 01:05 | |
*** salv-orlando has joined #openstack-doc | 01:12 | |
*** Qiming_ has joined #openstack-doc | 01:14 | |
*** suyog_ has joined #openstack-doc | 01:18 | |
*** yangyapeng has joined #openstack-doc | 01:19 | |
*** salv-orlando has quit IRC | 01:20 | |
*** suyog has quit IRC | 01:21 | |
*** Marga_ has quit IRC | 01:21 | |
*** Marga_ has joined #openstack-doc | 01:22 | |
openstackgerrit | Nam Nguyen Hoai proposed openstack/api-site: Neutron Provider Networks' link references are wrong https://review.openstack.org/285277 | 01:22 |
*** Marga__ has joined #openstack-doc | 01:22 | |
*** Marga__ has quit IRC | 01:23 | |
*** Marga_ has quit IRC | 01:23 | |
*** Marga_ has joined #openstack-doc | 01:23 | |
openstackgerrit | Merged openstack/openstack-manuals: cleanup of operator requirements network design doc https://review.openstack.org/284759 | 01:23 |
*** Marga_ has quit IRC | 01:24 | |
*** Marga_ has joined #openstack-doc | 01:25 | |
openstackgerrit | Merged openstack/openstack-manuals: cleanup of op requirement sla file https://review.openstack.org/280973 | 01:26 |
openstackgerrit | Ha Van Tu proposed openstack/api-site: Firewall(s) methods do not show full parameters. https://review.openstack.org/285859 | 01:29 |
*** Marga__ has joined #openstack-doc | 01:42 | |
*** Marga_ has quit IRC | 01:46 | |
*** yamamoto_ has joined #openstack-doc | 01:50 | |
*** yamamoto_ has quit IRC | 01:55 | |
*** Qiming_ has quit IRC | 02:07 | |
*** Qiming has joined #openstack-doc | 02:08 | |
*** yamamoto_ has joined #openstack-doc | 02:08 | |
*** yamamoto_ has quit IRC | 02:09 | |
*** thorst has joined #openstack-doc | 02:28 | |
*** Marga__ has quit IRC | 02:33 | |
*** Marga_ has joined #openstack-doc | 02:33 | |
*** yamamoto has joined #openstack-doc | 02:33 | |
*** thorst has quit IRC | 02:36 | |
*** salv-orlando has joined #openstack-doc | 02:37 | |
*** dmacpher has joined #openstack-doc | 02:39 | |
*** yamamoto has quit IRC | 02:40 | |
*** yangyapeng has quit IRC | 02:44 | |
*** mfuruta has quit IRC | 02:44 | |
*** yangyapeng has joined #openstack-doc | 02:44 | |
*** mfuruta has joined #openstack-doc | 02:44 | |
openstackgerrit | NGUYEN TUONG THANH proposed openstack/api-site: [Telemetry API v2] Fixes heterogeneity data type https://review.openstack.org/285867 | 02:44 |
*** adreznec has quit IRC | 02:45 | |
*** suyog_ has quit IRC | 02:46 | |
*** suyog_ has joined #openstack-doc | 02:46 | |
*** adreznec has joined #openstack-doc | 02:47 | |
*** salv-orlando has quit IRC | 02:53 | |
*** furface has quit IRC | 02:54 | |
openstackgerrit | Ha Van Tu proposed openstack/api-site: Missing Response Parameters table of "GET /v2.0/tenants" https://review.openstack.org/285869 | 02:55 |
*** furface has joined #openstack-doc | 03:11 | |
openstackgerrit | Nguyen Hung Phuong proposed openstack/api-site: Glance: Incorrect Request parameters in "Show task details" API https://review.openstack.org/285874 | 03:15 |
openstackgerrit | Nguyen Hung Phuong proposed openstack/api-site: Glance: Incorrect Request parameters in "Show task details" API https://review.openstack.org/285874 | 03:18 |
*** tojuvone_ has quit IRC | 03:21 | |
*** yamamoto_ has joined #openstack-doc | 03:23 | |
*** mfuruta_ has joined #openstack-doc | 03:26 | |
*** mfuruta has quit IRC | 03:26 | |
*** tojuvone has joined #openstack-doc | 03:28 | |
*** thorst has joined #openstack-doc | 03:36 | |
*** thorst has quit IRC | 03:41 | |
*** stevemar has joined #openstack-doc | 03:53 | |
*** salv-orlando has joined #openstack-doc | 03:57 | |
*** itisha has joined #openstack-doc | 04:03 | |
*** salv-orlando has quit IRC | 04:03 | |
*** david-lyle has joined #openstack-doc | 04:13 | |
openstackgerrit | Ruchika Luthra proposed openstack/operations-guide: Adding more details about StackTach in Operations Guide https://review.openstack.org/285791 | 04:22 |
*** salv-orlando has joined #openstack-doc | 04:32 | |
*** Qiming_ has joined #openstack-doc | 04:35 | |
*** Qiming has quit IRC | 04:35 | |
*** david-lyle has quit IRC | 04:36 | |
*** salv-orlando has quit IRC | 04:38 | |
*** david-lyle has joined #openstack-doc | 04:50 | |
*** thorst has joined #openstack-doc | 04:54 | |
*** david-lyle has quit IRC | 04:56 | |
*** thorst has quit IRC | 05:03 | |
*** mine0901 has joined #openstack-doc | 05:33 | |
*** salv-orlando has joined #openstack-doc | 05:36 | |
openstackgerrit | Nguyen Hung Phuong proposed openstack/api-site: Glance: Incorrect Request parameters in "Show task details" API https://review.openstack.org/285874 | 05:38 |
*** suyog_ has quit IRC | 05:41 | |
*** watanabe_isao has joined #openstack-doc | 05:42 | |
*** suyog has joined #openstack-doc | 05:42 | |
*** salv-orlando has quit IRC | 05:47 | |
*** amotoki has joined #openstack-doc | 05:56 | |
*** thorst has joined #openstack-doc | 06:00 | |
*** suyog has quit IRC | 06:03 | |
*** suyog has joined #openstack-doc | 06:03 | |
*** thorst has quit IRC | 06:07 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/openstack-manuals: Imported Translations from Zanata https://review.openstack.org/285894 | 06:11 |
*** zhurong has joined #openstack-doc | 06:15 | |
*** dguitarbite has joined #openstack-doc | 06:20 | |
*** calebb has joined #openstack-doc | 06:20 | |
*** dguitarbite has quit IRC | 06:20 | |
*** dguitarbite has joined #openstack-doc | 06:23 | |
*** dguitarbite has quit IRC | 06:24 | |
*** dguitarbite has joined #openstack-doc | 06:24 | |
*** calebb has quit IRC | 06:25 | |
*** zhurong has quit IRC | 06:29 | |
*** zhurong has joined #openstack-doc | 06:30 | |
*** JRobinson__ is now known as JRobinson__afk | 06:31 | |
*** salv-orlando has joined #openstack-doc | 06:42 | |
*** zhurong has quit IRC | 06:43 | |
*** rcernin has joined #openstack-doc | 06:45 | |
*** JRobinson__afk is now known as JRobinson__ | 06:45 | |
*** yangyapeng has quit IRC | 06:46 | |
*** bmoss has quit IRC | 06:47 | |
*** rcernin has quit IRC | 06:49 | |
*** adahms has joined #openstack-doc | 06:49 | |
openstackgerrit | Lucky samadhiya proposed openstack/ha-guide: Correct the commands for pacemaker https://review.openstack.org/285905 | 06:50 |
*** AJaeger has quit IRC | 06:58 | |
*** AJaeger has joined #openstack-doc | 07:02 | |
*** JRobinson__ has quit IRC | 07:03 | |
*** hoangcx has quit IRC | 07:04 | |
*** mjura has joined #openstack-doc | 07:04 | |
*** thorst has joined #openstack-doc | 07:05 | |
*** thorst has quit IRC | 07:12 | |
*** amotoki has quit IRC | 07:19 | |
*** hoangcx has joined #openstack-doc | 07:21 | |
*** rcernin has joined #openstack-doc | 07:24 | |
*** amotoki has joined #openstack-doc | 07:31 | |
*** suyog has quit IRC | 07:31 | |
*** furface has quit IRC | 07:33 | |
*** amotoki has quit IRC | 07:35 | |
*** pcaruana has joined #openstack-doc | 07:43 | |
*** amotoki has joined #openstack-doc | 07:49 | |
*** amotoki has quit IRC | 07:49 | |
*** yangyapeng has joined #openstack-doc | 07:51 | |
*** mine0901 has quit IRC | 08:09 | |
*** thorst has joined #openstack-doc | 08:11 | |
*** dmacpher has quit IRC | 08:11 | |
*** zhurong has joined #openstack-doc | 08:16 | |
*** thorst has quit IRC | 08:17 | |
*** jpena has joined #openstack-doc | 08:25 | |
*** rcernin has quit IRC | 08:29 | |
*** taroth1 has joined #openstack-doc | 08:35 | |
*** amotoki has joined #openstack-doc | 08:35 | |
*** amotoki has quit IRC | 08:36 | |
*** rcernin has joined #openstack-doc | 08:37 | |
*** deepti-mtg has joined #openstack-doc | 08:40 | |
*** dnavale has quit IRC | 08:44 | |
*** amotoki has joined #openstack-doc | 08:45 | |
*** watanabe_isao has quit IRC | 08:49 | |
*** taroth1 has quit IRC | 09:01 | |
*** taroth1 has joined #openstack-doc | 09:05 | |
openstackgerrit | Tomoki Sekiyama proposed openstack/openstack-manuals: [admin-guide] Update note of block-storage Volume-backed Image https://review.openstack.org/285813 | 09:09 |
*** amotoki has quit IRC | 09:10 | |
*** amotoki has joined #openstack-doc | 09:13 | |
*** thorst has joined #openstack-doc | 09:15 | |
*** asettle has joined #openstack-doc | 09:19 | |
*** huats is now known as Guest33875 | 09:22 | |
*** thorst has quit IRC | 09:22 | |
*** haarika_ has joined #openstack-doc | 09:23 | |
*** mfuruta_ has quit IRC | 09:23 | |
*** amotoki has quit IRC | 09:24 | |
*** patrickeast has quit IRC | 09:24 | |
*** patrickeast has joined #openstack-doc | 09:25 | |
*** zhurong has quit IRC | 09:34 | |
*** amotoki has joined #openstack-doc | 09:34 | |
openstackgerrit | Ha Van Tu proposed openstack/api-site: Missing Response Parameters table of "GET /v2.0/users" method. https://review.openstack.org/285958 | 09:54 |
*** salv-orl_ has joined #openstack-doc | 09:59 | |
*** thorst has joined #openstack-doc | 09:59 | |
*** salv-orlando has quit IRC | 10:02 | |
openstackgerrit | NGUYEN TUONG THANH proposed openstack/api-site: The type of "virtual_interfaces" parameter is declared incorrectly https://review.openstack.org/285965 | 10:05 |
*** thorst has quit IRC | 10:06 | |
openstackgerrit | Nguyen Hung Phuong proposed openstack/api-site: [Image service API v2] Incorrect description for List API https://review.openstack.org/285966 | 10:09 |
*** yangyapeng has quit IRC | 10:18 | |
*** Qiming_ has quit IRC | 10:20 | |
*** salv-orlando has joined #openstack-doc | 10:42 | |
*** salv-orlando has quit IRC | 10:43 | |
*** salv-orl_ has quit IRC | 10:43 | |
*** salv-orlando has joined #openstack-doc | 10:43 | |
*** yamamoto_ has quit IRC | 10:53 | |
openstackgerrit | NGUYEN TUONG THANH proposed openstack/api-site: Declaring the type of "router:external " parameter is incorrect. https://review.openstack.org/285978 | 10:58 |
*** hoangcx has quit IRC | 10:59 | |
*** amotoki has quit IRC | 11:00 | |
*** amotoki has joined #openstack-doc | 11:03 | |
*** thorst has joined #openstack-doc | 11:06 | |
*** thorst has quit IRC | 11:11 | |
*** amotoki has quit IRC | 11:11 | |
*** Qiming has joined #openstack-doc | 11:16 | |
openstackgerrit | Merged openstack/openstack-manuals: [config-ref] Manage/Unmanage volumes for zfssa-iscsi/nfs drivers https://review.openstack.org/285638 | 11:25 |
*** yamamoto has joined #openstack-doc | 11:31 | |
*** yamamoto_ has joined #openstack-doc | 11:33 | |
*** yamamoto has quit IRC | 11:36 | |
openstackgerrit | Maria Zlatkova proposed openstack/openstack-manuals: Update HPE 3PAR supported operations for CGs https://review.openstack.org/285582 | 11:37 |
openstackgerrit | Nguyen Hung Phuong proposed openstack/api-site: [Image service API v2] Incorrect description for List API https://review.openstack.org/285966 | 11:47 |
*** haarika_ has quit IRC | 11:52 | |
*** marcusvrn_ has joined #openstack-doc | 11:55 | |
*** spotz_zzz is now known as spotz | 12:03 | |
-openstackstatus- NOTICE: Infra currently has a long backlog. Please be patient and where possible avoid rechecks while it catches up. | 12:06 | |
openstackgerrit | Merged openstack/openstack-manuals: Imported Translations from Zanata https://review.openstack.org/285894 | 12:13 |
*** dencaval has quit IRC | 12:14 | |
*** dencaval has joined #openstack-doc | 12:27 | |
*** amotoki has joined #openstack-doc | 12:30 | |
*** thorst has joined #openstack-doc | 12:32 | |
*** dencaval has quit IRC | 12:39 | |
*** adahms has quit IRC | 12:45 | |
*** amotoki has quit IRC | 12:45 | |
*** Guest33875 has quit IRC | 12:45 | |
*** huats_ has joined #openstack-doc | 12:47 | |
*** pkovar has joined #openstack-doc | 12:49 | |
*** dencaval has joined #openstack-doc | 12:53 | |
*** pcaruana has quit IRC | 12:53 | |
*** yangyapeng has joined #openstack-doc | 12:55 | |
*** spotz is now known as spotz_zzz | 13:00 | |
*** amotoki has joined #openstack-doc | 13:02 | |
*** mine0901 has joined #openstack-doc | 13:07 | |
*** pcaruana has joined #openstack-doc | 13:08 | |
*** huats_ has quit IRC | 13:10 | |
*** huats_ has joined #openstack-doc | 13:11 | |
*** huats_ has quit IRC | 13:11 | |
*** huats_ has joined #openstack-doc | 13:11 | |
*** huats_ has quit IRC | 13:30 | |
*** huats_ has joined #openstack-doc | 13:31 | |
*** annegentle has joined #openstack-doc | 13:35 | |
*** amotoki has quit IRC | 13:39 | |
*** dmacpher has joined #openstack-doc | 13:40 | |
*** jpena is now known as jpena|lunch | 13:52 | |
annegentle | krotscheck: around? | 13:53 |
*** amotoki has joined #openstack-doc | 13:53 | |
*** rromans_afk is now known as rromans | 13:56 | |
krotscheck | annegentle: ALmost | 14:01 |
*** bswartz has joined #openstack-doc | 14:01 | |
annegentle | krotscheck: or asquare? :) | 14:01 |
krotscheck | annegentle: http://www.angryflower.com/189.html | 14:01 |
krotscheck | cuuuuube | 14:03 |
krotscheck | annegentle: Ok, what's up? | 14:04 |
annegentle | krotscheck: heh | 14:04 |
annegentle | krotscheck: so the main goal is to replace this series of pages: http://developer.openstack.org/api-ref.html | 14:04 |
annegentle | krotscheck: by changing the source files | 14:05 |
krotscheck | Righto. There was some talk about swagger, right? | 14:05 |
annegentle | krotscheck: I wanted to understand two items in infro: | 14:05 |
annegentle | krotscheck: yes, we have Swagger files to replace the source for those pages | 14:05 |
krotscheck | Cool. | 14:05 |
annegentle | krotscheck: item 1 I need to understand: Can I write a script that will build flat HTML files with two npm commands and run that in openstack infra? | 14:06 |
krotscheck | Yes. | 14:06 |
krotscheck | Item two? | 14:06 |
krotscheck | :D | 14:06 |
krotscheck | Details: | 14:06 |
annegentle | item 2 is: is it better to run an angularJS server to serve JSON Swagger rather than convert to flat html? | 14:06 |
krotscheck | urrrr.... ok, so we have two things there that don't make sense together. | 14:07 |
krotscheck | (on your second question) | 14:07 |
krotscheck | Let me answer the first one first. | 14:07 |
annegentle | krotscheck: sure | 14:07 |
krotscheck | We have an npm-run-<command> macro, which will install NPM, all the browsers, set up a virtual screen session so we can do browser testing, and then execute any command found in a package.json file. | 14:07 |
krotscheck | That last bit is more or less equivalent to running tox -e, except more like javascript, and less with the multiple venvs. | 14:08 |
annegentle | wow. | 14:08 |
*** calebb has joined #openstack-doc | 14:08 | |
annegentle | krotscheck: ok, just talking through what I think I do to run this macro? | 14:08 |
annegentle | do I write a tox command and script in the repo where I want to run this macro (such as openstack/api-site)? | 14:09 |
krotscheck | In addition to that, npm-based projects have their own lifecycle. | 14:09 |
krotscheck | It gets a bit complciated when you have python + javascript munged in one, because the jobs assume that you have one, or the other, but not both. | 14:09 |
annegentle | krotscheck: ah ok, that makes sense. | 14:10 |
krotscheck | It's assumed that if you have a two-language project, you know enough about both languages to hook one into the lifecycle of the other. | 14:10 |
annegentle | krotscheck: for this particular job, creating flat html from swagger, I need npm only | 14:10 |
krotscheck | Right | 14:10 |
annegentle | krotscheck: however it'll be dependent on fairy-slipper making the swagger (that job is already in the gate now) | 14:10 |
krotscheck | So, there's already a template in place for that, lemme find it. | 14:10 |
krotscheck | So there's this, which also runs language tests: http://git.openstack.org/cgit/openstack-infra/project-config/tree/zuul/layout.yaml#n710 | 14:11 |
krotscheck | Which can be invoked like this: http://git.openstack.org/cgit/openstack-infra/project-config/tree/zuul/layout.yaml#n5006 | 14:11 |
annegentle | krotscheck: ok trying to connect the dots | 14:12 |
krotscheck | Or, if you want individual contorl over the command, you can do this: http://git.openstack.org/cgit/openstack-infra/project-config/tree/zuul/layout.yaml#n6650 (except with <commandname> instead of lint) | 14:12 |
annegentle | krotscheck: ok I think instead of "lint" it'll be something like "buildswagger"? | 14:13 |
annegentle | krotscheck: er, buildhtmlfromswagger or some such | 14:13 |
krotscheck | Yes. That will then correspond to the actual command in package.json. | 14:13 |
krotscheck | So. | 14:13 |
annegentle | ah | 14:13 |
krotscheck | Step 1: Make sure that a package.json file exists in your project. | 14:13 |
krotscheck | It should include all your dependencies (`npm install --save-dev <depname>`) | 14:14 |
krotscheck | It should have a 'commands' hash that includes the commands you want to invoke. | 14:14 |
* krotscheck goes to get an example. | 14:14 | |
annegentle | krotscheck: you're awesome. | 14:14 |
krotscheck | Sorry | 14:15 |
krotscheck | Not commands, scripts. | 14:15 |
krotscheck | http://git.openstack.org/cgit/openstack/ironic-webclient/tree/package.json#n7 | 14:15 |
krotscheck | The important bit there to hook into is the 'prepublish' hook. | 14:15 |
krotscheck | In the example, it uses a tool like gulp, which serves the same purpose as a scripting build tool like ant, maven, etc. | 14:16 |
krotscheck | In reality, you can invoke any commandline script in there, with the added knowledge that anything in the 'dependencies' or 'devDependencies' section will be accessible. | 14:16 |
annegentle | ok | 14:16 |
krotscheck | Then, locally, you can invoke that by calling `npm install` (only once), then `npm pack` | 14:17 |
krotscheck | npm pack will create a tarball. You have fine-tuned control about what goes into that tarball, which can be glob-maniupulated using the files:[] array in package.json | 14:17 |
annegentle | https://github.com/nknapp/bootprint-openapi/blob/master/package.json is what I'm looking at | 14:17 |
*** calebb has quit IRC | 14:18 | |
*** Qiming has quit IRC | 14:19 | |
krotscheck | Looks pretty sophisticated. I'm not familiar with standard and/or thought as commands. | 14:19 |
annegentle | krotscheck: heh me neither | 14:19 |
krotscheck | But, well, you can see that it's pretty flexible | 14:19 |
annegentle | krotscheck: "works on my machine" is what I know so far. | 14:19 |
*** Qiming has joined #openstack-doc | 14:19 | |
annegentle | krotscheck: so that gets me to part one, build flat html from swagger files. | 14:20 |
annegentle | krotscheck: part two, if possible, would be to use fairy-slipper to serve json + rst files | 14:20 |
krotscheck | annegentle: An interesting thing to note there, is that "thought" is a custom command. You can use that 'scripts' dict to basically call any commands you want, which will then be accessible via npm run `<command`. | 14:20 |
annegentle | krotscheck: spec here: https://review.openstack.org/#/c/276484/ | 14:20 |
krotscheck | But that's an aside. | 14:20 |
annegentle | krotscheck: ok, good to know! | 14:21 |
krotscheck | Reading | 14:21 |
krotscheck | Hrm. Ok | 14:22 |
krotscheck | So, first things first: angularjs doesn't require a server. | 14:22 |
krotscheck | Well, that's wrong | 14:22 |
krotscheck | It requires a place where it can be served form, but it's an in-browser framework. | 14:22 |
krotscheck | No server overhead required. | 14:23 |
krotscheck | (That's from your question 2) | 14:23 |
krotscheck | Actually, let me finish answering question 1. | 14:23 |
annegentle | krotscheck: ok but on Cloud Sites, which is where developer.openstack.org is hosted, there's only flat file serving. | 14:23 |
annegentle | krotscheck: ok | 14:23 |
krotscheck | Once you have your commands working locally, then you add gate-<project>-npm-run-<command> job. | 14:23 |
krotscheck | That will pack up your thing. | 14:24 |
krotscheck | Additionally, there's a thing taht will upload that packed thing to docs-draft so you can see what it built. | 14:24 |
krotscheck | <project>-npm-publish-draft | 14:24 |
annegentle | krotscheck: nice. we'll want that for sure. | 14:24 |
krotscheck | This command will run 'npm pack', then untar the tarball, and upload it so you can see what's going on. | 14:25 |
annegentle | krotscheck: ok, repeating to be sure I understand. Because fairy-slipper has a package.json, it can be packed up and then unpacked as flat files? | 14:25 |
krotscheck | annegentle: You can see an example here https://review.openstack.org/#/c/266050/ | 14:25 |
krotscheck | annegentle: Yeeees... | 14:26 |
*** KLevenstein has joined #openstack-doc | 14:26 | |
annegentle | krotscheck: and this is an example? http://docs-draft.openstack.org/50/266050/5/check/ironic-webclient-npm-publish-draft/bf055f4//dist/#/config | 14:27 |
krotscheck | annegentle: Yes. If you had an ironic-api running somewhere, you could actually connect to it and test to see how it works. | 14:27 |
krotscheck | (caveat: It'll need CORS configured) | 14:27 |
krotscheck | ANyway | 14:27 |
annegentle | krotscheck: nice. yes that's same for swagger and swagger-ui | 14:27 |
krotscheck | The entire premise of our JS build chain is that any javascript we write is entirely static. As in, no server component required, it runs in the browser and talks to the API directly | 14:27 |
annegentle | ok! | 14:27 |
krotscheck | Ok, so now you have your package.json file, your run-command build, your publish-draft build. | 14:28 |
*** rromans has quit IRC | 14:28 | |
krotscheck | The only thing remaining is the npm-publish-tarball build. | 14:28 |
*** rromans has joined #openstack-doc | 14:28 | |
krotscheck | Which, well, does the exact same thing as publish-draft, except it just uploads the tarball. | 14:29 |
krotscheck | And that rather long drawn out convoluted question is how you go from code to statically built HTML in the gate. | 14:29 |
annegentle | dannng. Okay! | 14:29 |
annegentle | so I think I can get from point a to point b. | 14:29 |
krotscheck | After I get this CORS silliness figured out I may be able to help get the build up and running for you. | 14:30 |
krotscheck | But that's not until I find people to help me land 22 patches in mitaka. | 14:30 |
krotscheck | So, question two: | 14:31 |
annegentle | heh | 14:32 |
krotscheck | What does fairy-slipper actually do? i.e. if I want to play with nova, what would it build? | 14:32 |
annegentle | krotscheck: 2 things: 1, migrate WADL to Swagger, 2, display Swagger + RST | 14:33 |
annegentle | krotscheck: so for nova, migrate a ton of wadl to swagger, then display it in a web page | 14:33 |
*** pt_15 has joined #openstack-doc | 14:34 | |
annegentle | the design is what we want to keep working on | 14:34 |
* krotscheck goes to see what WADL actually is. | 14:35 | |
annegentle | XML | 14:35 |
krotscheck | Oh god | 14:35 |
krotscheck | xml | 14:35 |
krotscheck | wow | 14:35 |
krotscheck | 1995 called, they want their markup back ;) | 14:35 |
annegentle | a standard for describing REST APIs that we must get rid of | 14:35 |
annegentle | yes | 14:35 |
*** rbowen has joined #openstack-doc | 14:35 | |
annegentle | hence, swagger | 14:35 |
krotscheck | Ok. Lemme go see what swagger needs. | 14:35 |
krotscheck | Huhn. E | 14:37 |
krotscheck | "Evergreen desktop browser" | 14:37 |
krotscheck | That's a new term for me. | 14:37 |
*** lwilliams has joined #openstack-doc | 14:38 | |
*** pcaruana has quit IRC | 14:38 | |
annegentle | for me too, where'd you see that krotscheck? | 14:39 |
krotscheck | annegentle: https://github.com/swagger-api/swagger-ui | 14:39 |
krotscheck | The readme | 14:39 |
annegentle | ha, ok | 14:39 |
krotscheck | Ok, so from what I can tell, the swagger ui doesn't need a server.... | 14:40 |
krotscheck | It just needs to be configured and told where there's a swagger.json file against which it can explore itself. | 14:40 |
krotscheck | Downside is that it doesn't appear to do multi-api. So this particular bit can do Keystone OR Nova, but not both. | 14:41 |
krotscheck | That's something we can adjust though. | 14:41 |
* krotscheck goes and runs the demo... | 14:41 | |
*** sigmavirus24_awa is now known as sigmavirus24 | 14:42 | |
*** knikolla has joined #openstack-doc | 14:42 | |
annegentle | krotscheck: from what I've read you have to make nginx or apache serve more than one swagger file | 14:44 |
krotscheck | Yeah, it's a solvable problem. | 14:45 |
krotscheck | annegentle: Swagger's going to make calls against an API- are we standing up a devstack for devs to use? | 14:48 |
annegentle | krotscheck: not yet, in this iteration | 14:49 |
annegentle | krotscheck: and maybe never devstack, a mock or trystack instead perhaps | 14:49 |
annegentle | krotscheck: but yeah, this is about publishing not "try it out" | 14:49 |
annegentle | this iteration anyway | 14:49 |
krotscheck | The end deliverable of fairy-slipper then would be RST-parsed-into-HTML + interactive angular app that talks to API directly? | 14:51 |
*** pcaruana has joined #openstack-doc | 14:52 | |
annegentle | krotscheck: maybe someday but honestly the "interactive" part I don't mind dropping because please oh please get off wadl | 14:52 |
annegentle | krotscheck: and it seems like "replace WADL" can be done with what we have | 14:53 |
krotscheck | Well, I'm saying future. | 14:53 |
krotscheck | As in, ideal future omg yay. | 14:53 |
krotscheck | rainbows, unicorns, etc. | 14:54 |
krotscheck | Ok. So, WADL -> Swagger.json, then render a docs site off of that. | 14:54 |
krotscheck | I feel like the only sticking point there is that sphinx already has all the tools set up to build docs. | 14:55 |
krotscheck | And converting RST to HTML using npm would just be rebuilding all that. | 14:55 |
krotscheck | i.e. use one tool to build one thing, another ot build another. | 14:55 |
krotscheck | Hrm. | 14:55 |
krotscheck | Trickypants | 14:55 |
krotscheck | annegentle: Ok, sorry, what question was I answering again? | 15:01 |
annegentle | hm | 15:01 |
annegentle | it's about the integration of info tho | 15:01 |
annegentle | swagger plus rst gives us both ref info and narrative info | 15:01 |
krotscheck | And, ultimately, you _want_ to serve static HTML, because SEO. | 15:02 |
annegentle | krotscheck: ok that's the main point! | 15:02 |
krotscheck | So all the narrative info lives in RST, and should be published as HTML. | 15:02 |
krotscheck | But it should contain some (potentially interactive) reference information, which should come from a JS app that parses swagger.json | 15:03 |
annegentle | krotscheck: what's happened is narrative + ref is in wadl | 15:03 |
annegentle | we're pulling that out | 15:03 |
krotscheck | I don't suppose you have a sample of that? | 15:03 |
krotscheck | (of the wadl) | 15:03 |
annegentle | https://github.com/openstack/api-site/blob/master/api-ref/src/wadls/identity-api/src/v2.0/wadl/OS-KSVALIDATE-admin.wadl#L103 | 15:04 |
annegentle | it's not really reference info but concept info about tokens and extensions | 15:05 |
*** jpena|lunch is now known as jpena | 15:08 | |
krotscheck | annegentle: The current build process that I have in my brain is "build HTML from RST" -> "Convert WADL to Swagger.json" -> "Include swagger-ui" -> "Tarball and publish", is that about right? | 15:08 |
annegentle | krotscheck: that's in my brain too! | 15:08 |
annegentle | I think that's right | 15:08 |
krotscheck | Ok. | 15:08 |
krotscheck | The first step is tox. | 15:08 |
krotscheck | The second step is made easier by a tool written in javascript. | 15:09 |
annegentle | krotscheck: I could also do "include fairy-slipper" right? | 15:09 |
krotscheck | RIght | 15:09 |
annegentle | I have to drive in now, but I can get some reviews going now | 15:09 |
krotscheck | Ok. | 15:09 |
krotscheck | I have to do reviews for the ironic project anyway, then do CORS things | 15:09 |
annegentle | krotscheck: thanks SO much | 15:09 |
annegentle | krotscheck: super helpful | 15:10 |
krotscheck | No worries :) | 15:10 |
*** annegentle has quit IRC | 15:12 | |
*** permalac has joined #openstack-doc | 15:19 | |
*** permalac has quit IRC | 15:19 | |
*** permalac has joined #openstack-doc | 15:20 | |
*** yangyapeng has quit IRC | 15:20 | |
*** pots has left #openstack-doc | 15:24 | |
*** lwilliams has quit IRC | 15:24 | |
*** spotz_zzz is now known as spotz | 15:28 | |
*** annegentle has joined #openstack-doc | 15:35 | |
*** pblaho_ is now known as pblaho | 15:38 | |
*** annegentle has quit IRC | 15:42 | |
*** annegentle has joined #openstack-doc | 15:42 | |
*** pushkaru has joined #openstack-doc | 15:45 | |
*** dguitarbite has left #openstack-doc | 15:45 | |
*** sneti has joined #openstack-doc | 15:47 | |
*** armax has joined #openstack-doc | 15:50 | |
*** Qiming has quit IRC | 15:52 | |
*** salv-orl_ has joined #openstack-doc | 16:00 | |
*** sc68cal has joined #openstack-doc | 16:01 | |
*** salv-orlando has quit IRC | 16:03 | |
*** mjura has quit IRC | 16:08 | |
*** rcernin has quit IRC | 16:16 | |
*** pcaruana has quit IRC | 16:17 | |
*** rromans has quit IRC | 16:19 | |
*** mine0901 has quit IRC | 16:21 | |
*** yangyapeng has joined #openstack-doc | 16:21 | |
*** rromans has joined #openstack-doc | 16:21 | |
*** mine0901 has joined #openstack-doc | 16:22 | |
annegentle | in tox.ini are you supposed to add to envlist list as you add more testenv:? | 16:23 |
*** dmacpher is now known as dmacpher-afk | 16:23 | |
*** sigmavirus24 is now known as sigmavirus24_awa | 16:25 | |
*** sigmavirus24_awa is now known as sigmavirus24 | 16:25 | |
*** yangyapeng has quit IRC | 16:29 | |
openstackgerrit | Matthew Kassawara proposed openstack/openstack-manuals: Modify DB support for Aodh https://review.openstack.org/285216 | 16:39 |
*** taroth1 has quit IRC | 16:42 | |
*** taroth1 has joined #openstack-doc | 16:43 | |
*** calebb has joined #openstack-doc | 16:43 | |
*** thorst is now known as thorst_afk | 16:44 | |
openstackgerrit | Michael McCune proposed openstack/security-doc: add a readme to the security guide project https://review.openstack.org/286152 | 16:45 |
*** katyafervent_awa has quit IRC | 16:46 | |
openstackgerrit | Anne Gentle proposed openstack/api-site: Identity v3 - Domain configuration: "config" have wrong type https://review.openstack.org/282916 | 16:47 |
*** katyafervent_awa has joined #openstack-doc | 16:47 | |
*** annegentle has quit IRC | 16:52 | |
*** yamamoto_ has quit IRC | 16:54 | |
*** yamamoto has joined #openstack-doc | 16:55 | |
*** petertr7 is now known as petertr7_away | 16:55 | |
*** petertr7_away is now known as petertr7 | 17:01 | |
*** sheel has joined #openstack-doc | 17:05 | |
sheel | kvmahesh : hi | 17:05 |
sheel | AJaeger: hi there | 17:06 |
sheel | AJaeger: could you please review https://review.openstack.org/#/c/284056/ ? | 17:06 |
sheel | AJaeger: its quite small patch for changing API option | 17:06 |
*** deepti-afk has joined #openstack-doc | 17:08 | |
*** yamamoto has quit IRC | 17:10 | |
*** deepti-mtg has quit IRC | 17:10 | |
*** amotoki has quit IRC | 17:13 | |
*** openstackgerrit has quit IRC | 17:18 | |
*** openstackgerrit has joined #openstack-doc | 17:18 | |
*** sc68cal has quit IRC | 17:22 | |
*** asettle has quit IRC | 17:23 | |
*** sigmavirus24 is now known as sigmavirus24_awa | 17:26 | |
sheel | Hello All | 17:26 |
sheel | could you please find some time to review https://review.openstack.org/#/c/284056/ | 17:27 |
*** john-davidge has joined #openstack-doc | 17:27 | |
*** david-lyle has joined #openstack-doc | 17:30 | |
*** khushbu_ has joined #openstack-doc | 17:41 | |
*** rbradfor_ is now known as rbradfor | 17:49 | |
*** annegentle has joined #openstack-doc | 17:53 | |
*** Marga_ has quit IRC | 17:54 | |
*** david-lyle has quit IRC | 17:55 | |
*** david-lyle_ has joined #openstack-doc | 17:55 | |
*** annegentle has quit IRC | 17:59 | |
*** Guest67703 is now known as me_ | 18:01 | |
*** me_ is now known as med_ | 18:01 | |
*** med_ has quit IRC | 18:01 | |
*** med_ has joined #openstack-doc | 18:01 | |
*** annegentle has joined #openstack-doc | 18:07 | |
*** sarob has joined #openstack-doc | 18:09 | |
*** petertr7 is now known as petertr7_away | 18:13 | |
*** Swami has joined #openstack-doc | 18:14 | |
*** yamamoto has joined #openstack-doc | 18:16 | |
*** sc68cal has joined #openstack-doc | 18:19 | |
AJaeger | sheel: commented. Thanks for the change | 18:20 |
sheel | AJaeger: thank u | 18:20 |
*** yamamoto has quit IRC | 18:21 | |
sheel | AJaeger: you mentioned it wrong, plz clarify a bit more | 18:21 |
sheel | AJaeger: k, so you are askinf aboutzml update as well | 18:22 |
sheel | sure i ll update | 18:22 |
AJaeger | sheel: you changed the JSON file, did you review that the XML file as well? | 18:22 |
sheel | i ll update | 18:22 |
sheel | AJaeger: thank you | 18:22 |
AJaeger | thanks | 18:22 |
*** thorst_afk is now known as thorst | 18:23 | |
*** Guest63721 is now known as mfisch | 18:24 | |
annegentle | krotscheck: I know it's probably late in your work day, but I found that fairy-slipper uses grunt not gulp, do I need to write a file similar to the ironic-webclient gulpfile.js? http://git.openstack.org/cgit/openstack/ironic-webclient/plain/gulpfile.js | 18:24 |
*** mfisch is now known as Guest2004 | 18:25 | |
krotscheck | Grunt and gulp are just two different approaches. | 18:25 |
annegentle | krotscheck: yeah I'm reading that, but what's compatible with the infra scripts? | 18:25 |
annegentle | krotscheck: or do I just have package.json "grunt serve" instead of "gulp serve?" | 18:25 |
krotscheck | annegentle: Anything that can be invoked via 'npm run <command>'. | 18:25 |
krotscheck | Yep | 18:25 |
annegentle | krotscheck: check | 18:25 |
annegentle | krotscheck: thanks for the sanity check | 18:26 |
annegentle | carry on! | 18:26 |
annegentle | :) | 18:26 |
krotscheck | ANytime | 18:26 |
*** yangyapeng has joined #openstack-doc | 18:26 | |
krotscheck | annegentle: Today's day 1 of daycare. | 18:26 |
*** petertr7_away is now known as petertr7 | 18:26 | |
krotscheck | So my crazy workday is a little (but not much) less crazy. | 18:26 |
annegentle | oh! I hope it's going well for baby :) | 18:26 |
annegentle | krotscheck: you get to eat lunch and such :) | 18:26 |
krotscheck | And exercise! | 18:27 |
krotscheck | No more dad bod! | 18:27 |
* krotscheck lost the abdominal strength to do inversions :/ | 18:27 | |
*** Marga_ has joined #openstack-doc | 18:28 | |
*** Guest2004 is now known as mfisch | 18:28 | |
*** mfisch has quit IRC | 18:28 | |
*** mfisch has joined #openstack-doc | 18:28 | |
*** thorst is now known as thorst_afk | 18:31 | |
annegentle | heh I don't know if I ever had that abdominal strength! | 18:31 |
annegentle | Ok but here's the thing, the "server" that fairy-slipper runs is a pecan server. hrmity. | 18:32 |
annegentle | krotscheck: turtles all the way down | 18:32 |
annegentle | krotscheck: I'll get there. | 18:32 |
krotscheck | What does that server do? | 18:32 |
*** huats_ has quit IRC | 18:33 | |
*** huats_ has joined #openstack-doc | 18:33 | |
*** huats_ has quit IRC | 18:33 | |
*** huats_ has joined #openstack-doc | 18:33 | |
annegentle | krotscheck: pecan serve config.py | 18:33 |
annegentle | krotscheck: that's all I know... hrmity | 18:33 |
annegentle | https://github.com/openstack/fairy-slipper/blob/master/config.py | 18:33 |
*** yangyapeng has quit IRC | 18:34 | |
annegentle | krotscheck: ah, and that indicates the layouts https://github.com/openstack/fairy-slipper/blob/master/fairy_slipper/templates/layout.html | 18:34 |
krotscheck | annegentle: Yeah, looks like the real meat is in https://github.com/openstack/fairy-slipper/blob/master/fairy_slipper%2Fcontrollers%2Froot.py | 18:35 |
annegentle | krotscheck: ok, that pulls in all the pieces yeah | 18:35 |
annegentle | krotscheck: ok speaking of lunch because I'm hungry! Going to get some lunch :) | 18:37 |
*** annegentle has quit IRC | 18:37 | |
krotscheck | :) | 18:37 |
*** cloudtrainme has joined #openstack-doc | 18:37 | |
*** emagana has joined #openstack-doc | 18:38 | |
openstackgerrit | Matthew Kassawara proposed openstack/openstack-manuals: Install: Launch an instance updates for Mitaka https://review.openstack.org/285540 | 18:41 |
*** jpena has quit IRC | 18:43 | |
*** pkovar has quit IRC | 18:52 | |
*** thorst_afk is now known as thorst | 18:52 | |
*** khushbu_ has quit IRC | 18:52 | |
*** sigmavirus24_awa is now known as sigmavirus24 | 18:53 | |
*** annegentle has joined #openstack-doc | 19:12 | |
*** pt_15 has quit IRC | 19:12 | |
*** annegentle has quit IRC | 19:13 | |
*** pt_15 has joined #openstack-doc | 19:14 | |
*** annegentle has joined #openstack-doc | 19:16 | |
*** dfflanders has joined #openstack-doc | 19:16 | |
*** khushbu__ has joined #openstack-doc | 19:30 | |
*** khushbu___ has joined #openstack-doc | 19:31 | |
*** knikolla has quit IRC | 19:34 | |
*** john-davidge has quit IRC | 19:40 | |
*** dencaval has quit IRC | 19:45 | |
*** dencaval has joined #openstack-doc | 19:51 | |
*** knikolla has joined #openstack-doc | 19:51 | |
*** john-davidge has joined #openstack-doc | 19:52 | |
*** armax has quit IRC | 19:59 | |
*** Guest71383 is now known as redrobot | 20:01 | |
*** steveg_afk has joined #openstack-doc | 20:09 | |
*** david-lyle_ is now known as david-lyle | 20:12 | |
*** pushkaru has quit IRC | 20:13 | |
*** pushkaru has joined #openstack-doc | 20:13 | |
*** yangyapeng has joined #openstack-doc | 20:31 | |
*** annegentle has quit IRC | 20:31 | |
*** annegentle has joined #openstack-doc | 20:32 | |
*** salv-orlando has joined #openstack-doc | 20:36 | |
*** yarkot_ has joined #openstack-doc | 20:36 | |
*** yangyapeng has quit IRC | 20:37 | |
openstackgerrit | Denis Cavalcante proposed openstack/openstack-manuals: Updates HNAS driver config-reference https://review.openstack.org/286267 | 20:38 |
*** yarkot_ has quit IRC | 20:38 | |
*** salv-orl_ has quit IRC | 20:39 | |
*** pots2 has joined #openstack-doc | 20:43 | |
*** pots2 has left #openstack-doc | 20:43 | |
*** pots has joined #openstack-doc | 20:44 | |
*** knikolla has quit IRC | 20:45 | |
*** pt_15 has quit IRC | 20:45 | |
*** steveg_afk has quit IRC | 20:46 | |
*** mine0901 has quit IRC | 20:49 | |
*** itisha has quit IRC | 20:49 | |
*** mine0901 has joined #openstack-doc | 20:53 | |
*** chlong_ has joined #openstack-doc | 21:01 | |
*** sneti has quit IRC | 21:01 | |
*** knikolla has joined #openstack-doc | 21:07 | |
*** salv-orlando has quit IRC | 21:08 | |
*** salv-orlando has joined #openstack-doc | 21:09 | |
*** pushkaru has quit IRC | 21:09 | |
annegentle | dfflanders: around? | 21:10 |
*** john-davidge has quit IRC | 21:10 | |
*** khushbu__ has quit IRC | 21:13 | |
*** khushbu___ has quit IRC | 21:13 | |
*** sheel has quit IRC | 21:17 | |
*** cloudtrainme has quit IRC | 21:19 | |
*** cloudtrainme has joined #openstack-doc | 21:21 | |
*** john-davidge has joined #openstack-doc | 21:24 | |
openstackgerrit | Carl Baldwin proposed openstack/openstack-manuals: Document Neutron subnet pools https://review.openstack.org/286293 | 21:42 |
openstackgerrit | Carl Baldwin proposed openstack/openstack-manuals: Document Neutron address scopes https://review.openstack.org/286294 | 21:42 |
*** armax has joined #openstack-doc | 21:53 | |
*** salv-orl_ has joined #openstack-doc | 21:59 | |
*** salv-orlando has quit IRC | 22:02 | |
*** annegentle has quit IRC | 22:02 | |
*** sarob has quit IRC | 22:08 | |
*** knikolla has quit IRC | 22:09 | |
*** petertr7 is now known as petertr7_away | 22:15 | |
*** deepti-afk is now known as dnavale | 22:16 | |
*** bmoss has joined #openstack-doc | 22:19 | |
*** armax has quit IRC | 22:19 | |
*** cloudtrainme has quit IRC | 22:20 | |
*** sarob has joined #openstack-doc | 22:25 | |
*** armax has joined #openstack-doc | 22:26 | |
*** reed_ has joined #openstack-doc | 22:35 | |
*** thorst has quit IRC | 22:35 | |
*** yangyapeng has joined #openstack-doc | 22:35 | |
*** yangyapeng has quit IRC | 22:40 | |
*** thorst has joined #openstack-doc | 22:42 | |
*** rbowen has quit IRC | 22:43 | |
*** rbowen has joined #openstack-doc | 22:43 | |
*** thorst has quit IRC | 22:46 | |
*** rbowen has quit IRC | 22:55 | |
*** dfflanders has quit IRC | 22:55 | |
*** JRobinson__ has joined #openstack-doc | 22:59 | |
*** KLevenstein has quit IRC | 22:59 | |
*** thorst has joined #openstack-doc | 23:00 | |
*** cloudtrainme has joined #openstack-doc | 23:05 | |
*** thorst has quit IRC | 23:05 | |
*** pots has quit IRC | 23:07 | |
*** yamamoto_ has joined #openstack-doc | 23:11 | |
*** sarob has quit IRC | 23:11 | |
*** sarob has joined #openstack-doc | 23:11 | |
*** furface has joined #openstack-doc | 23:13 | |
*** salv-orl_ has quit IRC | 23:15 | |
*** yamamoto_ has quit IRC | 23:16 | |
*** salv-orlando has joined #openstack-doc | 23:19 | |
*** spotz is now known as spotz_zzz | 23:24 | |
*** Qiming has joined #openstack-doc | 23:30 | |
*** sc68cal has quit IRC | 23:34 | |
*** yamamoto_ has joined #openstack-doc | 23:42 | |
*** mine0901 has quit IRC | 23:49 | |
*** Swami has quit IRC | 23:55 | |
*** thorst has joined #openstack-doc | 23:56 | |
*** thorst_ has joined #openstack-doc | 23:58 |
Generated by irclog2html.py 2.14.0 by Marius Gedminas - find it at mg.pov.lt!