*** Swami has quit IRC | 00:00 | |
*** Swami_ has quit IRC | 00:00 | |
*** Swami has joined #openstack-doc | 00:01 | |
*** sayantani01 has joined #openstack-doc | 00:07 | |
*** yangyapeng has quit IRC | 00:08 | |
*** sayantani01 has quit IRC | 00:11 | |
*** sekelso has quit IRC | 00:15 | |
*** suyog has quit IRC | 00:23 | |
*** dmacpher has joined #openstack-doc | 00:24 | |
*** masaki has joined #openstack-doc | 00:26 | |
*** thorst_ has joined #openstack-doc | 00:28 | |
*** salv-orl_ has quit IRC | 00:32 | |
*** suyog has joined #openstack-doc | 00:39 | |
*** thorst_ has quit IRC | 00:45 | |
*** thorst_ has joined #openstack-doc | 00:45 | |
*** annegentle has quit IRC | 00:48 | |
*** thorst_ has quit IRC | 00:50 | |
*** yamamoto_ has joined #openstack-doc | 00:51 | |
*** hoangcx has joined #openstack-doc | 00:53 | |
*** bradjones has quit IRC | 00:55 | |
*** annegentle has joined #openstack-doc | 00:55 | |
*** phuongnh has joined #openstack-doc | 00:55 | |
openstackgerrit | Martin Lopes proposed openstack/security-doc: Adds ARP spoofing to Security Guide https://review.openstack.org/422947 | 01:02 |
---|---|---|
*** amotoki has joined #openstack-doc | 01:15 | |
*** thorst_ has joined #openstack-doc | 01:19 | |
*** thorst_ has quit IRC | 01:19 | |
*** annegentle has quit IRC | 01:20 | |
*** yangyapeng has joined #openstack-doc | 01:21 | |
*** Syed__ has quit IRC | 01:25 | |
*** adrianofr has quit IRC | 01:29 | |
*** yamamoto_ has quit IRC | 01:38 | |
*** sayantani01 has joined #openstack-doc | 01:39 | |
openstackgerrit | chen.xing proposed openstack/openstack-manuals: [user-guide] revert to nova client command https://review.openstack.org/419719 | 01:47 |
*** sofie has joined #openstack-doc | 01:59 | |
*** yangyape_ has joined #openstack-doc | 02:00 | |
*** furface has quit IRC | 02:01 | |
*** thorst_ has joined #openstack-doc | 02:01 | |
*** thorst_ has quit IRC | 02:01 | |
*** yangyapeng has quit IRC | 02:03 | |
*** yangyapeng has joined #openstack-doc | 02:10 | |
*** yangyape_ has quit IRC | 02:13 | |
*** cathrich_ has joined #openstack-doc | 02:14 | |
*** cathrichardson has quit IRC | 02:14 | |
*** sekelso has joined #openstack-doc | 02:15 | |
*** shaunm has quit IRC | 02:24 | |
*** yamamoto_ has joined #openstack-doc | 02:26 | |
*** masaki has quit IRC | 02:51 | |
openstackgerrit | KATO Tomoyuki proposed openstack/training-guides: Update OS to Ubuntu 16.04 https://review.openstack.org/423002 | 02:54 |
*** masaki has joined #openstack-doc | 02:55 | |
*** masaki has quit IRC | 02:55 | |
*** masaki has joined #openstack-doc | 02:55 | |
*** masaki has quit IRC | 03:06 | |
*** Swami__ has quit IRC | 03:07 | |
*** Swami has quit IRC | 03:07 | |
*** masaki has joined #openstack-doc | 03:09 | |
*** furface has joined #openstack-doc | 03:17 | |
*** masaki has quit IRC | 03:18 | |
*** masaki has joined #openstack-doc | 03:19 | |
*** masaki has quit IRC | 03:29 | |
*** itisha has joined #openstack-doc | 03:30 | |
*** masaki has joined #openstack-doc | 03:31 | |
*** thorst_ has joined #openstack-doc | 03:39 | |
*** thorst_ has quit IRC | 03:40 | |
*** armax has joined #openstack-doc | 03:40 | |
*** nicolasbock has quit IRC | 03:41 | |
*** amotoki has quit IRC | 03:49 | |
*** sekelso has quit IRC | 03:51 | |
*** erikmwilson has quit IRC | 03:51 | |
*** erikmwilson has joined #openstack-doc | 03:51 | |
*** john-davidge has joined #openstack-doc | 03:58 | |
*** john-davidge has quit IRC | 04:03 | |
*** sekelso has joined #openstack-doc | 04:04 | |
*** yangyapeng has quit IRC | 04:07 | |
*** yangyapeng has joined #openstack-doc | 04:09 | |
*** yangyapeng has quit IRC | 04:10 | |
*** vijaykc4 has joined #openstack-doc | 04:15 | |
*** yangyapeng has joined #openstack-doc | 04:17 | |
*** amotoki has joined #openstack-doc | 04:19 | |
openstackgerrit | Peter Wang proposed openstack/openstack-manuals: Add Unity Cinder driver doc https://review.openstack.org/422456 | 04:22 |
*** amotoki_ has joined #openstack-doc | 04:25 | |
*** amotoki has quit IRC | 04:27 | |
*** sekelso has quit IRC | 04:39 | |
*** gouthamr has quit IRC | 04:46 | |
*** vijaykc4 has quit IRC | 04:52 | |
*** sheel has joined #openstack-doc | 05:04 | |
*** bsilverman_ has quit IRC | 05:29 | |
*** bsilverman_5 has joined #openstack-doc | 05:29 | |
*** erikmwilson has quit IRC | 05:32 | |
*** thorst_ has joined #openstack-doc | 05:40 | |
*** thorst_ has quit IRC | 05:48 | |
*** furface has quit IRC | 06:06 | |
*** armax has quit IRC | 06:19 | |
*** armax has joined #openstack-doc | 06:20 | |
*** armax has quit IRC | 06:20 | |
openstackgerrit | Ha Dung proposed openstack/openstack-manuals: Fixes typo bug1 on hook.py for openstack-manuals https://review.openstack.org/422416 | 06:29 |
*** phuongnh has quit IRC | 06:30 | |
*** phuongnh has joined #openstack-doc | 06:31 | |
*** sayantani01 has quit IRC | 06:31 | |
*** dmacpher has quit IRC | 06:36 | |
*** mjura has joined #openstack-doc | 06:46 | |
openstackgerrit | Peter Wang proposed openstack/openstack-manuals: Update Unity Manila Docs for Ocata https://review.openstack.org/423085 | 06:52 |
*** salv-orlando has joined #openstack-doc | 07:09 | |
*** salv-orlando has quit IRC | 07:14 | |
*** phuongnh has quit IRC | 07:20 | |
*** suyog has quit IRC | 07:21 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/training-guides: Imported Translations from Zanata https://review.openstack.org/423098 | 07:32 |
*** yangyape_ has joined #openstack-doc | 07:33 | |
openstackgerrit | KATO Tomoyuki proposed openstack/openstack-manuals: Add Unity Cinder driver doc https://review.openstack.org/422456 | 07:33 |
*** yangyapeng has quit IRC | 07:35 | |
*** pcaruana has joined #openstack-doc | 07:43 | |
openstackgerrit | Merged openstack/training-guides: Imported Translations from Zanata https://review.openstack.org/423098 | 07:44 |
*** tdasilva has quit IRC | 07:51 | |
*** flwang has quit IRC | 07:51 | |
*** tdasilva has joined #openstack-doc | 07:51 | |
*** flwang has joined #openstack-doc | 07:54 | |
openstackgerrit | Merged openstack/openstack-manuals: [ha-guide] Edit incorrect command for assigning VIP https://review.openstack.org/422652 | 08:02 |
*** tesseract has joined #openstack-doc | 08:05 | |
openstackgerrit | Peter Wang proposed openstack/openstack-manuals: Add Unity Cinder driver doc https://review.openstack.org/422456 | 08:07 |
*** salv-orlando has joined #openstack-doc | 08:11 | |
*** phuongnh has joined #openstack-doc | 08:13 | |
openstackgerrit | Merged openstack/openstack-manuals: Fixes typo bug1 on hook.py for openstack-manuals https://review.openstack.org/422416 | 08:18 |
*** yangyapeng has joined #openstack-doc | 08:33 | |
*** yangyape_ has quit IRC | 08:36 | |
*** jpena|off is now known as jpena | 08:37 | |
*** jpena is now known as jpena|off | 08:51 | |
openstackgerrit | Merged openstack/openstackdocstheme: Includes checklist when filing a bug for osmanuals https://review.openstack.org/422605 | 08:52 |
*** jpena|off is now known as jpena | 08:54 | |
*** salv-orlando has quit IRC | 08:56 | |
*** egallen has joined #openstack-doc | 08:59 | |
*** vijaykc4 has joined #openstack-doc | 09:01 | |
*** openstackgerrit has quit IRC | 09:02 | |
*** openstackgerrit has joined #openstack-doc | 09:06 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/openstack-manuals: Imported Translations from Zanata https://review.openstack.org/423132 | 09:06 |
openstackgerrit | Peter Wang proposed openstack/openstack-manuals: Update Unity Manila Docs for Ocata https://review.openstack.org/423085 | 09:07 |
openstackgerrit | Cao Xuan Hoang proposed openstack/openstack-manuals: [network] - Include logging API sub-chapter https://review.openstack.org/395290 | 09:13 |
*** johnthetubaguy has quit IRC | 09:16 | |
*** johnthetubaguy has joined #openstack-doc | 09:19 | |
*** erikwilson has quit IRC | 09:32 | |
*** erikmwilson has joined #openstack-doc | 09:35 | |
openstackgerrit | Merged openstack/openstack-manuals: Imported Translations from Zanata https://review.openstack.org/423132 | 09:42 |
*** john-davidge has joined #openstack-doc | 09:45 | |
*** thorst_ has joined #openstack-doc | 09:46 | |
*** john-davidge has quit IRC | 09:47 | |
*** john-davidge has joined #openstack-doc | 09:47 | |
*** thorst_ has quit IRC | 09:51 | |
*** yangyapeng has quit IRC | 09:52 | |
*** john-dav_ has joined #openstack-doc | 09:53 | |
*** john-davidge has quit IRC | 09:53 | |
*** vijaykc4 has quit IRC | 10:13 | |
*** john-dav_ is now known as john-davidge | 10:15 | |
openstackgerrit | Nam Nguyen Hoai proposed openstack/api-site: Remove unnecessary f.close() https://review.openstack.org/423179 | 10:24 |
*** hoangcx has quit IRC | 10:25 | |
*** amotoki_ has quit IRC | 10:28 | |
*** pnavarro has joined #openstack-doc | 10:31 | |
*** vijaykc4 has joined #openstack-doc | 10:35 | |
*** amotoki has joined #openstack-doc | 10:38 | |
*** phuongnh has quit IRC | 10:40 | |
*** yamamoto_ has quit IRC | 10:50 | |
*** salv-orlando has joined #openstack-doc | 11:06 | |
*** adrianofr has joined #openstack-doc | 11:18 | |
*** salv-orlando has quit IRC | 11:24 | |
*** vijaykc4 has quit IRC | 11:30 | |
*** pkovar has joined #openstack-doc | 11:33 | |
*** nicolasbock has joined #openstack-doc | 11:35 | |
*** yamamoto has joined #openstack-doc | 11:40 | |
*** amotoki has quit IRC | 11:44 | |
*** thorst_ has joined #openstack-doc | 11:47 | |
*** thorst_ has quit IRC | 11:52 | |
*** pcaruana has quit IRC | 11:59 | |
*** yamamoto has quit IRC | 12:02 | |
*** yamamoto has joined #openstack-doc | 12:03 | |
*** pcaruana has joined #openstack-doc | 12:06 | |
*** yamamoto has quit IRC | 12:08 | |
*** yamamoto has joined #openstack-doc | 12:10 | |
openstackgerrit | Merged openstack/openstack-manuals: [www-id] add Indonesian Networking Guide for Newton as draft https://review.openstack.org/422515 | 12:25 |
*** steveg_afk has joined #openstack-doc | 12:30 | |
*** vijaykc4 has joined #openstack-doc | 12:38 | |
*** yamamoto has quit IRC | 12:44 | |
*** yamamoto has joined #openstack-doc | 12:44 | |
*** yangyapeng has joined #openstack-doc | 12:47 | |
*** thorst_ has joined #openstack-doc | 12:47 | |
*** sofie has quit IRC | 12:48 | |
*** yamamoto has quit IRC | 12:48 | |
*** yamamoto has joined #openstack-doc | 12:51 | |
*** JoseMello has joined #openstack-doc | 12:52 | |
*** yamamoto has quit IRC | 12:52 | |
*** vijaykc4 has quit IRC | 12:55 | |
*** amotoki has joined #openstack-doc | 12:56 | |
*** vijaykc4 has joined #openstack-doc | 13:11 | |
*** sayantani01 has joined #openstack-doc | 13:26 | |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals: Do not build PDF of draft arch-design guide https://review.openstack.org/423266 | 13:35 |
*** jpena is now known as jpena|lunch | 13:37 | |
*** bradjones has joined #openstack-doc | 13:38 | |
*** bradjones has quit IRC | 13:38 | |
*** bradjones has joined #openstack-doc | 13:38 | |
*** pnavarro has quit IRC | 13:49 | |
*** yamamoto has joined #openstack-doc | 13:52 | |
*** vijaykc4 has quit IRC | 13:54 | |
*** salv-orlando has joined #openstack-doc | 13:57 | |
*** yamamoto has quit IRC | 14:02 | |
*** erikmwil_ has joined #openstack-doc | 14:06 | |
*** sekelso has joined #openstack-doc | 14:12 | |
*** fguillot has joined #openstack-doc | 14:14 | |
*** sayantani01 has quit IRC | 14:14 | |
*** sayantani01 has joined #openstack-doc | 14:15 | |
*** cathrichardson has joined #openstack-doc | 14:18 | |
*** yangyapeng has quit IRC | 14:19 | |
*** yangyapeng has joined #openstack-doc | 14:20 | |
*** cathrich_ has quit IRC | 14:21 | |
*** gouthamr has joined #openstack-doc | 14:23 | |
*** yangyapeng has quit IRC | 14:25 | |
*** dustins has joined #openstack-doc | 14:39 | |
*** dustins has quit IRC | 14:45 | |
*** dustins has joined #openstack-doc | 14:45 | |
*** mjura has quit IRC | 14:46 | |
*** yamamoto has joined #openstack-doc | 14:47 | |
*** sheel has quit IRC | 14:47 | |
*** jpena|lunch is now known as jpena | 14:49 | |
*** sayantani01 has quit IRC | 14:51 | |
*** yamamoto has quit IRC | 14:53 | |
*** rbowen has quit IRC | 14:54 | |
*** masaki has quit IRC | 14:56 | |
*** pnavarro has joined #openstack-doc | 14:59 | |
*** dustins has quit IRC | 15:01 | |
*** dustins has joined #openstack-doc | 15:01 | |
*** sekelso has quit IRC | 15:04 | |
*** egallen has quit IRC | 15:04 | |
*** erikmwil_ has quit IRC | 15:05 | |
*** rbowen has joined #openstack-doc | 15:10 | |
*** Syed__ has joined #openstack-doc | 15:14 | |
*** amotoki has quit IRC | 15:24 | |
*** vijaykc4 has joined #openstack-doc | 15:30 | |
*** annegentle has joined #openstack-doc | 15:34 | |
*** yangyapeng has joined #openstack-doc | 15:34 | |
*** yangyapeng has quit IRC | 15:39 | |
*** salv-orlando has quit IRC | 15:44 | |
*** sekelso has joined #openstack-doc | 15:45 | |
*** yamamoto has joined #openstack-doc | 15:54 | |
*** john-davidge has quit IRC | 15:56 | |
*** vijaykc4 has quit IRC | 16:01 | |
*** sayantani01 has joined #openstack-doc | 16:02 | |
*** pcaruana has quit IRC | 16:03 | |
*** yamamoto has quit IRC | 16:03 | |
*** amotoki has joined #openstack-doc | 16:05 | |
*** amotoki has quit IRC | 16:06 | |
*** hieulq has quit IRC | 16:09 | |
*** armax has joined #openstack-doc | 16:14 | |
*** hieulq has joined #openstack-doc | 16:15 | |
*** vijaykc4 has joined #openstack-doc | 16:16 | |
*** egallen has joined #openstack-doc | 16:30 | |
*** salv-orlando has joined #openstack-doc | 16:31 | |
*** vijaykc4 has quit IRC | 16:31 | |
*** taroth has quit IRC | 16:49 | |
*** itisha has quit IRC | 16:52 | |
*** erikmwil_ has joined #openstack-doc | 16:59 | |
*** egallen has quit IRC | 17:00 | |
*** salv-orlando has quit IRC | 17:04 | |
*** fguillot has quit IRC | 17:04 | |
*** nicolasbock has quit IRC | 17:18 | |
*** nicolasbock has joined #openstack-doc | 17:18 | |
*** fguillot has joined #openstack-doc | 17:19 | |
*** kencjohnston has joined #openstack-doc | 17:20 | |
*** rbowen has quit IRC | 17:26 | |
*** rbowen has joined #openstack-doc | 17:28 | |
*** leong has joined #openstack-doc | 17:31 | |
leong | Is anyone here that i can talk about proposing new content to docs.openstack.org? | 17:33 |
*** yangyapeng has joined #openstack-doc | 17:36 | |
AJaeger | leong: that works best via email, but let's have an initial discusion here | 17:37 |
annegentle | leong here | 17:39 |
leong | i actually shot an email to Lana few days ago.. i suppose she is on vacation? | 17:40 |
annegentle | leong She's at a conference this week | 17:41 |
openstackgerrit | chen.xing proposed openstack/openstack-manuals: [install] Fix the irrelevant example output https://review.openstack.org/423388 | 17:41 |
*** yangyapeng has quit IRC | 17:41 | |
AJaeger | leong: openstack-docs email mailing list is the best place | 17:41 |
leong | i have been working in Enterprise WG for couple years, and in previous release, we worked closely with Foundation and published the Workload Reference Architecture | 17:41 |
AJaeger | leong: but feel free to tell us what you propose and we can give pointers | 17:41 |
leong | we (EWG) is looking at publishing those content on docs.openstack.org | 17:41 |
leong | right now, those content are available on openstack sample config page | 17:42 |
leong | https://www.openstack.org/software/sample-configs/#web-applications | 17:42 |
annegentle | leong these are on the app architecture side, right? | 17:42 |
annegentle | leong would it make sense to put these on developer.openstack? | 17:42 |
leong | yes.. it is more on the Application Workload | 17:42 |
annegentle | leong yeah | 17:43 |
AJaeger | leong: why should we publish them both on www.o.o and another site? | 17:43 |
AJaeger | leong: in general that's content that's appropriate... | 17:44 |
leong | that's my point.. we want to move over from o.o to docs.openstack.org and follow the docs publishing process | 17:44 |
AJaeger | ah... | 17:44 |
leong | we recently created a git repo for further development of these workload referene architecture | 17:45 |
leong | github.com/openstack/workload-ref-archs | 17:45 |
leong | we are still in the process of structuring the git repo | 17:46 |
AJaeger | leong: let's get that repo added to the list of "official repos" in governance project, please | 17:46 |
AJaeger | http://git.openstack.org/cgit/openstack/governance/tree/reference/user-committee-repos.yaml | 17:47 |
leong | it is now under "openstack" root repo, does it required to be a "official project"? | 17:47 |
leong | like projects such as nova, neutron...? | 17:48 |
AJaeger | leong: for publishing to docs.o.o: Yes. And since Enterprise WG is an official WG, that's just a formality... | 17:48 |
leong | ok.. no problem.. i will take the AR to do that | 17:48 |
annegentle | AJaeger these belong on developer. | 17:48 |
annegentle | AJaeger more than docs.os | 17:48 |
leong | is not so much for Developer.. more for Deployment | 17:48 |
AJaeger | annegentle: yes, developer - agred | 17:48 |
annegentle | leong are you at all familiar with the publishing jobs and config after governance? | 17:49 |
annegentle | leong that'll be your next steps | 17:49 |
annegentle | leong and I'd like to see the WG work on that landing page, haven't seen much progress there | 17:49 |
leong | annegentle, do you mean the "docs publishing" ? | 17:49 |
AJaeger | leong: we have standard ways to publish documentation. If you create the docs asa single book under docs/source/ and use the standard sphinx publishing way, it will be very easy | 17:49 |
leong | any pointers will be great? | 17:49 |
annegentle | leong yeah | 17:49 |
AJaeger | leong: like nova etc build docs | 17:50 |
annegentle | leong most similar will be https://git.openstack.org/cgit/openstack/api-site/tree/api-quick-start | 17:50 |
AJaeger | The only difference then would be where to *publish* but that can be changed easily | 17:50 |
leong | i am familiar with the gerrit system but might need to read more about the "docs publishing" process... | 17:50 |
AJaeger | annegentle: Please under doc/source | 17:50 |
annegentle | AJaeger leong yeah, https://git.openstack.org/cgit/openstack/api-site/tree/api-quick-start/source is more specific | 17:50 |
annegentle | leong also, find out where you want bugs reported in Launchpad - likely need a new project in Launchpad for bug reporting. | 17:51 |
annegentle | leong docs publishing is just like the code | 17:51 |
leong | annegentle.. what do you mean the "landing page" | 17:51 |
leong | already has that on launchpad | 17:51 |
annegentle | leong the landing page is http://developer.openstack.org. How will you get users to go to your new content? | 17:51 |
leong | https://launchpad.net/workload-ref-archs | 17:52 |
AJaeger | leong: I can setup the repo for you easily if you like - shall I do a change? | 17:52 |
annegentle | leong yeah, then in conf.py you'll configure workload-ref-archs | 17:52 |
annegentle | AJaeger might need to make sure the rest of the docs team gets it | 17:52 |
leong | annegentle, you mean this conf.py? https://github.com/openstack/workload-ref-archs/blob/master/doc/source/conf.py | 17:53 |
annegentle | yes, see https://git.openstack.org/cgit/openstack/api-site/tree/api-quick-start/source/conf.py#n68 for the log-a-bug config | 17:53 |
AJaeger | leong: you have already a correctly setup conf.py. | 17:53 |
annegentle | AJaeger by "gets it," I mean "understands the content, its audience, where it goes, the tasks they do based on this content" and so on | 17:54 |
AJaeger | in doc/source/conf.py - you can enhance that to use our openstackdocstheme and the log a bug | 17:54 |
AJaeger | annegentle: let's first set up the repo... | 17:54 |
leong | i follow "Project Creator" to setup this repo.. so generally i believe the structure is there.. just need to figure out how this can be integarted with Docs process | 17:54 |
annegentle | leong in a way, you're only using docs tooling though. Be clear, you don't get writers when you do this... right? | 17:54 |
annegentle | leong we're distributed work teams | 17:55 |
leong | annegentle, that's another question i want to ask.. | 17:55 |
annegentle | leong sure | 17:55 |
leong | the content will be contributed by many people, they might not be a "technical writer" | 17:55 |
annegentle | leong that's exactly what we enable | 17:55 |
leong | how do we ensure the "content quality" in terms of proper sentence, etc... | 17:56 |
annegentle | leong across hundreds of projects | 17:56 |
*** hieulq has quit IRC | 17:56 | |
annegentle | leong we use a central style guide when reviewing -- see http://docs.openstack.org/contributor-guide/writing-style.html | 17:56 |
AJaeger | leong: https://review.openstack.org/423394 sets up building of docs when you submit a change | 17:56 |
leong | for the existing reference architecture that we have published, Foundation assigned a Technical Writer to "beautify" the text | 17:56 |
annegentle | leong Right. I'm making sure you know you don't get that in this model. | 17:57 |
AJaeger | leong: could you +1 that change? | 17:57 |
*** john-davidge has joined #openstack-doc | 17:57 | |
leong | Ajaeger.. just _1 | 17:57 |
leong | +1.. | 17:57 |
AJaeger | yes | 17:58 |
leong | so in this docs process, does it relies on docs team to ensure the "text consistency"? | 17:58 |
annegentle | leong of course, the Foundation can keep the tech writer working on the text. | 17:58 |
annegentle | leong the review team | 17:58 |
annegentle | leong the review team is set up per repo | 17:58 |
leong | so the review team became the "technical writer" ? | 17:58 |
annegentle | leong not necessarily | 17:59 |
annegentle | leong but only core reviewers can publish | 17:59 |
annegentle | leong anyone can review | 17:59 |
annegentle | leong does that make sense? | 17:59 |
annegentle | leong AJaeger and I have a post about this, let me dig it up | 17:59 |
annegentle | leong https://opensource.com/business/15/7/continuous-integration-and-continuous-delivery-documentation | 18:00 |
AJaeger | leong: and anybody can contribute. But the review team ensures quality of content | 18:00 |
leong | a question raised by EWG team is: how can we ensure the text are properly written? | 18:00 |
AJaeger | leong: the reviewers need to ensure that | 18:01 |
annegentle | leong this article also discusses the quality checking https://opensource.com/business/15/4/git-and-github-open-source-documentation-reviews | 18:01 |
leong | in the past cycle, the "contributor" might be non-native-english, so sentences need to be reworked | 18:01 |
leong | so that became the reviewer responsibility... | 18:01 |
leong | thanks for the link.. i will check that out | 18:02 |
leong | so what's the next step for me to move forward? | 18:02 |
AJaeger | leong: and we normally have two reviewers - so you could have one that targets technical accuracy and one more on language | 18:02 |
AJaeger | leong: governance change - and setting up the repo so that the docs are build | 18:03 |
AJaeger | leong: "tox -e docs" will build the documents in your repo - and put them into doc/source/html for you to review | 18:03 |
AJaeger | So, next step is to move the texts to have into RST and add them to doc/source/ so that they are build as part of the doc building. | 18:04 |
AJaeger | Once that all works, we can discuss publishing again. | 18:04 |
leong | ok.. got it... will work on that.. | 18:04 |
leong | thanks for the help! | 18:05 |
leong | i will take the action and get back here... :) | 18:05 |
AJaeger | leong: I just pushed two proposed changes to your repo. One cleanup and one proposal on how to build and publish the web-applications content. | 18:07 |
leong | ok.. thanks! | 18:07 |
AJaeger | once https://review.openstack.org/423394 , with every change you get the documents build and can preview them. Just click on the docs job, it's a link to the generated documents. | 18:08 |
AJaeger | That makes reviewing easier | 18:09 |
*** hieulq has joined #openstack-doc | 18:12 | |
openstackgerrit | Merged openstack/training-guides: Update OS to Ubuntu 16.04 https://review.openstack.org/423002 | 18:19 |
*** jpena is now known as jpena|off | 18:19 | |
*** sekelso has quit IRC | 18:22 | |
*** sekelso has joined #openstack-doc | 18:22 | |
*** sayantani01 has quit IRC | 18:25 | |
*** pkovar has quit IRC | 18:30 | |
*** pblaho1 has quit IRC | 18:36 | |
*** annegentle has quit IRC | 18:36 | |
*** fedruantine has quit IRC | 18:41 | |
*** Swami has joined #openstack-doc | 18:43 | |
*** fedruantine has joined #openstack-doc | 18:51 | |
*** megm has quit IRC | 18:52 | |
*** megm has joined #openstack-doc | 18:54 | |
*** JoseMello has quit IRC | 18:55 | |
*** erikmwil_ has quit IRC | 18:58 | |
*** erikmwil_ has joined #openstack-doc | 18:59 | |
*** megm has quit IRC | 19:06 | |
leong | AJaeger, i just submit the changes to add into uc governance | 19:08 |
leong | https://review.openstack.org/#/c/423413/ | 19:08 |
*** megm has joined #openstack-doc | 19:08 | |
*** sayantani01 has joined #openstack-doc | 19:17 | |
*** pnavarro has quit IRC | 19:17 | |
*** john-davidge has quit IRC | 19:23 | |
*** slack_SLACK has joined #openstack-doc | 19:26 | |
*** tesseract has quit IRC | 19:32 | |
*** leong has quit IRC | 19:36 | |
AJaeger | leong | 19:46 |
AJaeger | leong has left ;( | 19:46 |
*** slack_SLACK has quit IRC | 19:49 | |
*** slack_SLACK has joined #openstack-doc | 19:54 | |
*** annegentle has joined #openstack-doc | 20:03 | |
*** gouthamr has quit IRC | 20:07 | |
*** fedruantine has quit IRC | 20:12 | |
*** fedruantine has joined #openstack-doc | 20:19 | |
*** dustins has quit IRC | 20:22 | |
*** slack_SLACK has quit IRC | 20:23 | |
*** fedruantine has quit IRC | 20:25 | |
*** fedruantine has joined #openstack-doc | 20:35 | |
*** salv-orlando has joined #openstack-doc | 20:38 | |
*** salv-orlando has quit IRC | 20:43 | |
*** leong has joined #openstack-doc | 20:50 | |
leong | AJaeger attending other meeting just now | 20:52 |
leong | i submitted this: https://review.openstack.org/#/c/423413/ to include EWG repo under UC | 20:53 |
*** bsilverman_5 has quit IRC | 20:58 | |
*** bsilverman_ has joined #openstack-doc | 20:58 | |
*** dustins has joined #openstack-doc | 21:01 | |
*** pnavarro has joined #openstack-doc | 21:03 | |
AJaeger | leong: check https://review.openstack.org/#/c/423414/ - the docs are build now... | 21:05 |
leong | yup.. just saw that.. | 21:06 |
leong | looks good, just need to touch up the layout and landing page | 21:06 |
*** sayantani01 has quit IRC | 21:06 | |
AJaeger | leong: yep... | 21:07 |
leong | so where would the "generated html" be eventually? | 21:07 |
AJaeger | what do you mean? | 21:07 |
leong | for example, the api doc is generated to here: http://developer.openstack.org/api-guide/quick-start/ | 21:07 |
leong | where should the ewg-doc be generated to? | 21:08 |
AJaeger | leong: we don't have a standard naming for developer.o.o, might be top-level like developer.o.o/workload-ref-archs/ - let's discuss later once there's more content | 21:09 |
AJaeger | sorry, have to leave now - have a great weekend | 21:09 |
leong | ok.. got it.. we are in the process of importing two more workloads in (Big Data and eCommerce) | 21:09 |
leong | just to make sure.. is this going to be the source of the landing page? https://github.com/openstack/workload-ref-archs/blob/master/doc/source/index.rst | 21:11 |
*** gouthamr has joined #openstack-doc | 21:14 | |
*** sayantani01 has joined #openstack-doc | 21:15 | |
*** gouthamr has quit IRC | 21:37 | |
*** yangyapeng has joined #openstack-doc | 21:37 | |
*** salv-orlando has joined #openstack-doc | 21:39 | |
*** yangyapeng has quit IRC | 21:42 | |
*** cathrichardson has quit IRC | 21:43 | |
*** salv-orlando has quit IRC | 21:44 | |
*** cathrichardson has joined #openstack-doc | 21:44 | |
*** gouthamr has joined #openstack-doc | 22:01 | |
*** thorst_ has quit IRC | 22:02 | |
*** thorst_ has joined #openstack-doc | 22:03 | |
*** rbowen has quit IRC | 22:05 | |
*** thorst_ has quit IRC | 22:07 | |
*** dustins has quit IRC | 22:13 | |
*** armax has quit IRC | 22:26 | |
*** leong has quit IRC | 22:28 | |
*** adrianofr has quit IRC | 22:39 | |
*** salv-orlando has joined #openstack-doc | 22:40 | |
*** armax has joined #openstack-doc | 22:42 | |
*** thorst_ has joined #openstack-doc | 22:43 | |
*** salv-orlando has quit IRC | 22:44 | |
*** thorst_ has quit IRC | 22:47 | |
*** sridhar_ram has joined #openstack-doc | 22:48 | |
sridhar_ram | Docs team - we have our manual install guide at http://docs.openstack.org/developer/tacker/install/manual_installation.html ... however this always points to the master. Is there a way to view the stable/newton version of this same doc? | 22:49 |
openstackgerrit | Merged openstack/security-doc: Use double backticks for command options https://review.openstack.org/420319 | 22:51 |
openstackgerrit | Merged openstack/security-doc: Update sphinx version https://review.openstack.org/420315 | 22:51 |
*** egallen has joined #openstack-doc | 22:59 | |
openstackgerrit | Merged openstack/openstack-manuals: Updating old policy.json syntax https://review.openstack.org/421305 | 23:00 |
*** thorst_ has joined #openstack-doc | 23:15 | |
*** thorst_ has quit IRC | 23:20 | |
*** annegentle has quit IRC | 23:20 | |
*** erikmwi__ has joined #openstack-doc | 23:22 | |
*** erikmwil_ has quit IRC | 23:22 | |
*** egallen has quit IRC | 23:23 | |
*** sayantani01 has quit IRC | 23:26 | |
*** yangyapeng has joined #openstack-doc | 23:41 | |
*** salv-orlando has joined #openstack-doc | 23:41 | |
*** armax has quit IRC | 23:41 | |
*** salv-orlando has quit IRC | 23:45 | |
*** yangyapeng has quit IRC | 23:45 |
Generated by irclog2html.py 2.14.0 by Marius Gedminas - find it at mg.pov.lt!