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