| *** brinzhang has joined #openstack-doc | 00:35 | |
| *** jamesmcarthur has joined #openstack-doc | 03:48 | |
| *** jamesmcarthur has quit IRC | 04:06 | |
| *** jamesmcarthur has joined #openstack-doc | 04:09 | |
| *** jamesmcarthur has quit IRC | 04:14 | |
| *** jamesmcarthur has joined #openstack-doc | 04:23 | |
| *** jamesmcarthur has quit IRC | 04:56 | |
| *** jamesmcarthur has joined #openstack-doc | 05:25 | |
| *** jamesmcarthur has quit IRC | 05:33 | |
| *** miloa has joined #openstack-doc | 05:50 | |
| *** jamesmcarthur has joined #openstack-doc | 06:29 | |
| *** jamesmcarthur has quit IRC | 06:34 | |
| *** brinzhang has quit IRC | 06:40 | |
| *** brinzhang has joined #openstack-doc | 06:40 | |
| *** kopecmartin has joined #openstack-doc | 06:53 | |
| *** tesseract has joined #openstack-doc | 06:56 | |
| *** rcernin has quit IRC | 07:08 | |
| *** rcernin has joined #openstack-doc | 07:24 | |
| *** jamesmcarthur has joined #openstack-doc | 07:30 | |
| *** tosky_ has joined #openstack-doc | 07:34 | |
| *** jamesmcarthur has quit IRC | 07:35 | |
| *** rcernin has quit IRC | 07:48 | |
| *** pcaruana has joined #openstack-doc | 07:49 | |
| *** alexmcleod has joined #openstack-doc | 08:27 | |
| *** jamesmcarthur has joined #openstack-doc | 08:31 | |
| *** tosky_ is now known as tosky | 08:32 | |
| *** jamesmcarthur has quit IRC | 08:36 | |
| *** jamesmcarthur has joined #openstack-doc | 09:33 | |
| *** jamesmcarthur has quit IRC | 09:44 | |
| asettle | tosky, that's an odd one (cant can't) | 10:08 |
|---|---|---|
| asettle | AJaeger_, amotoki - apologies for being entirely out last week. During training I was very sick and came home and did not return to work until today. | 10:08 |
| asettle | I need to catch up on everything. | 10:08 |
| *** jamesmcarthur has joined #openstack-doc | 10:29 | |
| *** jamesmcarthur has quit IRC | 10:34 | |
| stephenfin | asettle: weak. | 10:43 |
| asettle | stephenfin, ain't I just | 10:47 |
| *** brinzhang_ has joined #openstack-doc | 10:50 | |
| *** brinzhang has quit IRC | 10:53 | |
| tosky | asettle: should I add them to the etherpad, even though I don't have neither a workaround nor a solution? | 10:58 |
| asettle | tosky, yes I think that's suitable. Something weird is happening there | 11:04 |
| amotoki | asettle: no worries. I hope you've recovered. | 11:11 |
| asettle | Much better, thank you amotoki :) I have meetings now but I will soon read scrollback and go through your requests | 11:11 |
| asettle | Thank you for sending the update email | 11:11 |
| asettle | I will also include a patch to update the goal | 11:12 |
| amotoki | asettle: I have some questions to you. I will drop them later. | 11:12 |
| asettle | amotoki, please do | 11:12 |
| asettle | I will be busy today but I will do my best :) | 11:12 |
| asettle | Catching up, you know how it is :P | 11:12 |
| *** jamesmcarthur has joined #openstack-doc | 11:14 | |
| *** jamesmcarthur has quit IRC | 11:24 | |
| *** jamesmcarthur has joined #openstack-doc | 11:25 | |
| *** jamesmcarthur has quit IRC | 11:35 | |
| *** jamesmcarthur has joined #openstack-doc | 12:09 | |
| *** jamesmcarthur has quit IRC | 12:13 | |
| *** brinzhang has joined #openstack-doc | 12:25 | |
| *** brinzhang_ has quit IRC | 12:28 | |
| *** jamesmcarthur has joined #openstack-doc | 12:45 | |
| amotoki | asettle: when I read "Completion Criteria" in the goal definition and have some questions. | 13:00 |
| amotoki | regarding 1. you said the criteria is to succeed to build a PDF doc but it says "Each team needs to ensure ... that the PDFs look respectable". which is the criteria? | 13:00 |
| amotoki | regarding 4, I am not sure how we can do it. Do you have any idea on this? | 13:00 |
| asettle | Let me review amotoki :) | 13:01 |
| asettle | 1. Do you mean, how to define "respectable"? | 13:02 |
| asettle | 4. My idea was to have a stamp. So when the guide is generated, the template has a faded background that provides the release name. What do you think? | 13:04 |
| asettle | Or even if the PDF is generated and a notice is included in the build. | 13:04 |
| tosky | if I may, in the meantime... in some cases we need to set a few values in latex_elements; but don't we lose the options set by default then? (like, for example, the A4 paper size and the font size)? | 13:11 |
| amotoki | asettle: 1. yes, from my experience on neutron, even after we can build PDF doc, we need some improvements to make PDF docs ready for use. for example, in case of neutron, we need to adjust TOC levels and toctree so that readers can jump to a section they want easily. | 13:23 |
| amotoki | I am not sure what we expect to individual project teams. | 13:23 |
| asettle | amotoki, that's a good point. I think the hard thing is that it's subjective to the project. Whihc is why it was quite a vague statement at the beginning | 13:24 |
| asettle | Like, make it respectable as far as you see fit. Ensure it is readable | 13:24 |
| amotoki | :-) | 13:24 |
| amotoki | A document with hundred of pages without appropriate TOC is hard to read :p | 13:25 |
| asettle | Exactly. So, that is how you've defined it as "respectable". Perhaps I can define that as "respectable and readable to a human user audience"? | 13:26 |
| amotoki | asettle: regarding 4., it would be nice. Can we get a branch name when generating the PDF guide? | 13:26 |
| asettle | Would that be helpful? I can also include that this may differ per project team | 13:26 |
| asettle | amotoki, hmmm I would think so. I think it is something we have done before, but I'd have to ask AJaeger_ | 13:26 |
| amotoki | asettle: (on 1.) yes, it would be helpful. | 13:27 |
| asettle | amotoki, okay will do. So I have a few updates to do :) I will let you know when I push it up. | 13:27 |
| amotoki | asettle: thanks! | 13:28 |
| asettle | amotoki, okay, I have rephrased to: | 13:44 |
| asettle | "The doc gate job should run and produce PDFs for all projects, it may also | 13:44 |
| asettle | depend on in-repository declarations of new dependencies or a new tox env. | 13:44 |
| asettle | The intention is to keep these changes at a minimum. " | 13:44 |
| asettle | Any suggestions? | 13:44 |
| *** jamesmcarthur has quit IRC | 13:49 | |
| amotoki | asettle: generally looks good. one question: what do you mean by "in-repository declarations of new dependencies"? | 13:49 |
| asettle | amotoki, that was the language already included. | 13:50 |
| amotoki | asettle: Ah, I see | 13:50 |
| asettle | I can adjust if it is unclear. | 13:51 |
| asettle | But I did not change it. | 13:51 |
| amotoki | asettle: The current version was written before investigating the detail, so I think it covers possible changes. We can update it to something like "Each team needs to define a new tox env to enable the PDF build". it is an idea from me. | 13:54 |
| asettle | amotoki, I think that sounds reasonable. | 13:55 |
| asettle | amotoki, https://review.opendev.org/679654 | 13:56 |
| asettle | Also stephenfin andymccr ^ | 13:57 |
| asettle | ... sorry | 13:57 |
| asettle | AJaeger_, ^ | 13:57 |
| *** KeithMnemonic has joined #openstack-doc | 14:03 | |
| *** kopecmartin is now known as kopecmartin|off | 14:54 | |
| *** jamesmcarthur has joined #openstack-doc | 15:25 | |
| *** jamesmcarthur has quit IRC | 15:31 | |
| *** jamesmcarthur has joined #openstack-doc | 16:02 | |
| *** jamesmcarthur has quit IRC | 16:06 | |
| *** alexmcleod has quit IRC | 16:19 | |
| *** jamesmcarthur has joined #openstack-doc | 16:49 | |
| *** miloa has quit IRC | 17:07 | |
| *** miloa has joined #openstack-doc | 17:07 | |
| *** jamesmcarthur has quit IRC | 17:20 | |
| *** KeithMnemonic1 has joined #openstack-doc | 17:27 | |
| *** KeithMnemonic1 has quit IRC | 17:27 | |
| *** jamesmcarthur has joined #openstack-doc | 17:29 | |
| *** tesseract has quit IRC | 17:30 | |
| *** KeithMnemonic has quit IRC | 17:31 | |
| *** jamesmcarthur has quit IRC | 17:57 | |
| *** miloa has quit IRC | 18:12 | |
| *** pcaruana has quit IRC | 18:19 | |
| *** pcaruana has joined #openstack-doc | 18:19 | |
| AJaeger_ | amotoki: branch name? What do you have in mind? We publish to branch/<project>.pdf - to display branch name in the PDF itself, you can use the zuul.branch variable for example. stephenfin should be able to help with that | 18:52 |
| *** pcaruana has quit IRC | 20:36 | |
| openstackgerrit | Brian Rosmaita proposed openstack/openstack-manuals master: Update the VM Image Guide https://review.opendev.org/678856 | 21:09 |
| *** jamesmcarthur has joined #openstack-doc | 21:24 | |
| *** jamesmcarthur has quit IRC | 22:02 | |
| *** tosky_ has joined #openstack-doc | 22:04 | |
| *** tosky has quit IRC | 22:06 | |
| *** tosky_ is now known as tosky | 22:09 | |
| *** jamesmcarthur has joined #openstack-doc | 22:31 | |
| *** rcernin has joined #openstack-doc | 22:54 | |
| *** jamesmcarthur has quit IRC | 22:59 | |
| *** jamesmcarthur has joined #openstack-doc | 23:03 | |
| *** jamesmcarthur has quit IRC | 23:05 | |
| *** jamesmcarthur has joined #openstack-doc | 23:05 | |
| *** jamesmcarthur has quit IRC | 23:23 | |
| *** jamesmcarthur has joined #openstack-doc | 23:27 | |
| *** jamesmcarthur has quit IRC | 23:32 | |
| *** jamesmcarthur has joined #openstack-doc | 23:56 | |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!