14:31:20 <acozine> #startmeeting docs working group aka DaWGs 14:31:20 <zodbot> Meeting started Tue Aug 27 14:31:20 2019 UTC. 14:31:20 <zodbot> This meeting is logged and archived in a public location. 14:31:20 <zodbot> The chair is acozine. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:31:20 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:31:20 <zodbot> The meeting name has been set to 'docs_working_group_aka_dawgs' 14:31:25 <acozine> who's around? 14:31:43 <acozine> huh, I seem to have lost my ops 14:31:49 <acozine> ah, well 14:32:45 <acozine> gundalow alongchamps andersson007_ belfast77 cyberpear dag dfed felixfontein madonius mrproper Pilou shaps theo-o tributarian Xaroth zoredache any of you around? 14:33:00 * gundalow waves 14:33:16 <acozine> #chair gundalow 14:33:16 <zodbot> Current chairs: acozine gundalow 14:33:24 <gundalow> acozine: I think you've lost ops are you aren't logged in 14:33:30 <gundalow> to Freenode 14:33:36 * alongchamps o/ 14:33:43 <acozine> #chair alongchamps 14:33:43 <zodbot> Current chairs: acozine alongchamps gundalow 14:33:52 <acozine> gundalow: ah, that's weri 14:33:55 <acozine> weird 14:34:08 * acozine has a cat on her lap, which interferes with typing 14:34:44 <acozine> well, freenode is letting me run the meeting, so I'll deal with logging back in later 14:35:12 <gundalow> You zodbot doesn't need Freenode/Ops 14:35:19 <gundalow> Ping me later if you need details 14:35:23 <acozine> thanks 14:35:25 <gundalow> anyways 14:35:29 <gundalow> What's on the agenda today? 14:35:42 <acozine> main thing is samccann's theme changes 14:35:58 <acozine> we're trying to get the Ansible site up to the latest release of our Sphinx theme 14:36:10 <acozine> #topic PR 61189 14:36:12 <acozine> https://github.com/ansible/ansible/pull/61189/files 14:36:30 <acozine> the current output is published to the test site also 14:36:42 <acozine> http://docs.testing.ansible.com/ansible/latest/dev_guide/index.html 14:37:15 <acozine> the one known issue shows up on small screens - tablets or phones, or if you just make your browser really narrow 14:37:43 <acozine> with a small screen, if you scroll up and down, the Ansible A logo follows you up and down in a strange and slightly unsettling way 14:37:52 <gundalow> I know people do browse the docs on mobiles 14:38:14 <acozine> huh, today I can't make it do that 14:38:42 * acozine looks back at samccann's note 14:39:12 <gundalow> acozine: looks like she's fixed it https://github.com/ansible/ansible/pull/61189/commits/339fd6d9fcc4e510bbcbf1a50c4f6054aafff4bb 14:39:20 <acozine> oh, heh 14:39:25 <acozine> she's way ahead of me 14:39:37 <gundalow> oh, though commit after that reverts it 14:39:53 <gundalow> so I don't know 14:40:41 <acozine> she said she kept trying different ideas, and some of the changes fixed one thing and broke three others 14:41:42 <acozine> okay, this is very strange 14:41:52 <acozine> does anyone else see different colors on these two pages? 14:41:56 <acozine> http://docs.testing.ansible.com/ansible/devel/index.html 14:42:14 <acozine> and http://docs.testing.ansible.com/ansible/latest/dev_guide/developing_modules.html 14:42:18 <acozine> d'oh 14:42:24 <acozine> that's two different versions 14:42:36 * acozine head-meet-desk 14:43:15 <acozine> okay, so the `latest` version on docs.ansible.com is still the old theme 14:43:24 <acozine> aaarh 14:43:40 <acozine> the `latest` version on docs.testing.ansible.com is still the old theme 14:44:04 <acozine> and the `devel` version on docs.testing.ansible.com is from samccann's branch 14:44:41 <acozine> you can see the behavior on the `devel` version - the header in general scrolls correctly 14:45:04 <acozine> but the Ansible A follows you around like a ghostly puppy 14:46:49 <acozine> does `position: fixed` mean "always keep it in the same place on the screen, so it follows when the user scrolls" or "always keep it in the same place on the page, so it disappears when the user scrolls"? 14:47:28 <alongchamps> for me it's staying at the top along with the blue header (e.g. Ansible Documentation) 14:47:37 <alongchamps> testing on Safari on iOS 14:47:51 <acozine> alongchamps: are you looking at `devel` on docs.testing.ansible.com? 14:48:03 <alongchamps> now I am :) 14:48:14 <alongchamps> and yep the 'A' sticks around in the top left corner 14:48:15 <acozine> :-) 14:48:31 <acozine> thanks for confirming 14:48:43 <acozine> any idea where we should be looking in the CSS? 14:48:59 * gundalow knows nothing about CSS :( 14:49:10 * acozine knows just enough to be really dangerous 14:49:12 <alongchamps> It looks like the 'A' doesn't go behind like the white circle and word 'Documentation' 14:49:25 <alongchamps> which get pushed up as the page scrolls 14:49:35 * alongchamps knows even less of CSS 14:50:00 <acozine> I think the white circle sticks with the A, it's just hard to see once the background is also white 14:50:06 <alongchamps> ah, true 14:50:26 <alongchamps> now that I look closely, the word 'Documentation' also stays there 14:50:33 <acozine> ah, it does? 14:50:38 <acozine> that's actually comforting 14:51:01 <alongchamps> yep one moment 14:51:07 <acozine> it suggests that the fix would apply to the entire header 14:51:19 <acozine> ooh, yeah, I see what you mean 14:51:42 <acozine> if you stop scrolling over some thicker text, you can see the white of the "Documentation" covering some of it 14:51:51 <alongchamps> yep, or the yellow background 14:52:07 <alongchamps> e.g. https://imgur.com/a/7WVNZRe 14:52:14 <acozine> good eyes alongchamps 14:52:33 <alongchamps> I remembered to put my contacts in :) 14:52:46 <acozine> heh, that does help 14:52:50 <alongchamps> indeed 14:53:31 <alongchamps> so it looks like only the color background slides up (black then green) not sure if there's a way to group them up somehow 14:54:11 <acozine> does the text `Ansible` also "stick", or is it only the stuff in the black header? 14:54:33 <alongchamps> the 'Ansible' at top scrolls or me 14:54:37 <alongchamps> s/or/for 14:54:37 <acozine> looks like it's only the text in the top header, the black one 14:54:47 <acozine> wait, it does? 14:55:07 <alongchamps> yep 14:55:13 <alongchamps> does it do that for you? 14:55:20 <acozine> oh, you mean, it scrolls off the screen the way we want it to 14:55:28 <acozine> yes, it does that for me also 14:55:31 <alongchamps> ah ok 14:55:35 <alongchamps> yes that's what I mean 14:55:40 <alongchamps> that part seems to be working as intended 14:55:42 <acozine> so it's only the text in the top black banner we need to fix 14:55:47 <acozine> text and logo 14:56:03 <alongchamps> seems like it 14:57:04 <acozine> looking at the source for that page, it looks like the problem section is 14:57:22 <acozine> https://www.irccloud.com/pastebin/hYOPNyxT/non-scrolling%20section%20of%20header 14:58:01 <acozine> yep, that's the one 14:58:02 <acozine> http://docs.testing.ansible.com/ansible/devel/_static/images/logo_invert.png 14:58:07 * samccann with very late wave 14:58:13 * alongchamps o/ 14:58:15 <acozine> #chair samccann 14:58:15 <zodbot> Current chairs: acozine alongchamps gundalow samccann 14:58:31 <samccann> gonna scroll back and see what i've missed 14:58:50 <acozine> samccann: alongchamps and gundalow and me flailing about amidst the CSS 14:59:41 <acozine> so do we have a style set for `DocSite-nav`? 15:00:40 <samccann> finally caught up 15:00:43 <acozine> found it: https://github.com/ansible/ansible/pull/61189/files#diff-5e763c4f430124095f513e8749d1cc35R147 15:00:52 <samccann> and yes `Docsite-nav` has css 15:01:17 <acozine> I'm gonna guess it's something to do with `flex` 15:01:30 <samccann> oo haven't tried that one 15:01:48 <acozine> we've got: 15:01:55 <samccann> other than the floating A and Documentation, does it all look okay for y'all? 15:02:08 <acozine> https://www.irccloud.com/pastebin/prrrRDdo/styling%20for%20DocSite-nav 15:02:44 <acozine> samccann: good question - it took us a while to sort out which branch to look at 15:03:24 <acozine> I'd like to override the default blue on the section titles in the left nav with the Ansible teal 15:03:34 <acozine> (for example, USING ANSIBLE) 15:03:46 <samccann> okay I can try to find that. I wasn't sure if that would end up looking too light 15:03:56 <acozine> ah, it might 15:04:00 <samccann> then again, the old one is gray, so probably not a worry :-) 15:04:53 <acozine> our usual "problem child" pages so far look okay 15:04:58 <acozine> for example, http://docs.testing.ansible.com/ansible/devel/network/user_guide/platform_index.html 15:05:25 <acozine> and http://docs.testing.ansible.com/ansible/devel/reference_appendices/module_utils.html 15:05:56 <acozine> and http://docs.testing.ansible.com/ansible/devel/reference_appendices/config.html 15:07:44 <samccann> actually those last two both have problems as well 15:08:05 <samccann> scroll all the way down, and you'll start to see text overwriting the top nav 15:08:15 <samccann> hadn't seen that before. 15:09:48 <acozine> uh-oh 15:10:21 <samccann> good that we found it tho! 15:10:29 <acozine> ah, it's the same issue 15:11:05 <acozine> actually, I think the fix might be to change the style of the black background 15:11:09 <samccann> similar yep. fix one then hunt where the other is 15:11:43 <acozine> it looks like the section headers are taking precedence over the main header 15:11:56 <samccann> just some of them, but yeah 15:12:15 <acozine> make it small enough and I think they all do 15:12:51 <samccann> not sure what you mean? 15:13:02 <samccann> if I make it small, that black bar goes away entirely 15:13:18 <acozine> https://usercontent.irccloud-cdn.com/file/CWNa4dgC/Under%20and%20over%20the%20black%20bar 15:13:38 <samccann> yeah that's the error I was talking about. What did you see other than that? 15:13:56 <acozine> that's it 15:14:09 <samccann> ok wew. thought we had a third problem to fix :-) 15:14:22 <acozine> but I think both that error and the "floating A" error might be fixed by the same change 15:14:33 <acozine> maybe 15:14:41 <samccann> i can hope, eh? 15:15:07 <acozine> I'm thinking the error is in the styling on the black bar - if that followed the Ansible A and stayed in the foreground, both issues would go away 15:16:04 * acozine wonders if there's a good CSS forum somewhere 15:16:13 <acozine> yikes, it's quarter past 15:16:17 <samccann> there's some great web pages. 15:16:23 * acozine checks the agenda page 15:16:51 <acozine> no other agenda items 15:18:00 <gundalow> Next PR review Days are Tuesday 3rd and Thursday 19th Sept 15:18:25 <samccann> \o/ woot! 15:18:35 <acozine> gundalow: excellent! 15:18:54 <acozine> meanwhile code freeze for Ansible 2.9 is THIS THURSDAY 15:19:10 <acozine> #topic upcoming dates to know 15:19:37 <acozine> Code Freeze for Ansible 2.9: August 29, 2019 15:19:57 <acozine> PR Review Day: September 3 (Tues.) 15:20:08 <acozine> PR Review Day: September 19 (Thurs.) 15:20:42 <acozine> AnsibleFest Atlanta: 15:21:06 <acozine> Contributor Summit September 23 (Mon.) 15:21:21 <acozine> Main Conference September 24-25 (Tues. & Weds.) 15:21:28 <samccann> that Aug 29th means no more feature code merged after the 28th, right? 15:21:49 <acozine> I believe we can merge features through midnight US-time on the 29th 15:22:04 <samccann> erm. thought I heard the opposite.. gundalow ? 15:22:26 <acozine> oh, we can merge features through midnight US-time on the 28th? 15:22:40 <acozine> a.k.a. tomorrow? 15:22:43 <gundalow> Can merge till people go to bed on Wednesday 15:23:00 <samccann> lemme see if I can find it... something like when someone wakes up on the 29th, the freeze has begun so to speak? 15:23:03 * acozine plans for a late night tomorrow 15:23:07 <gundalow> > just a friendly reminder. Freeze starts on Thursday along with abadger making the first pre-release. So you should plan on having all feature work done when you "go home" on Wednesday. 15:23:19 <acozine> thanks gundalow samccann 15:23:26 <samccann> thanks! that's what I recall hearing 15:24:19 <acozine> #topic open floor 15:24:37 <acozine> what's on people's minds, other than summer vacations? 15:26:00 <acozine> well, crickets are appropriate to the season 15:26:07 <samccann> ice cream.... mostly just ice cream 15:26:16 <acozine> mmm, ice cream 15:26:36 <samccann> as in we haven't gone to the local ice cream place that stares down a hill at the cows it all came from. :-) 15:26:53 <acozine> are they open year-round? 15:27:05 <samccann> dunno... we go in the summer :-) 15:27:28 <samccann> my guess is it closes after the fall folliage cuz not much else to be driving that way for 15:27:29 <acozine> time to get over there, then! 15:28:16 <acozine> thanks alongchamps gundalow samccann 15:28:34 <acozine> happy Final Days Before Freeze 15:28:42 <acozine> and happy Last Days of Summer 15:28:55 <alongchamps> thanks everyone 15:29:04 <samccann> A Breezy Freezy end to Summer 15:29:07 <acozine> as always, agenda items welcome at https://github.com/ansible/community/issues/389 15:29:19 <acozine> and chat welcome in this channel any time 15:29:26 <acozine> #endmeeting