14:30:58 <acozine> #startmeeting Docs Working Group aka DaWGs 14:30:58 <zodbot> Meeting started Tue Sep 8 14:30:58 2020 UTC. 14:30:58 <zodbot> This meeting is logged and archived in a public location. 14:30:58 <zodbot> The chair is acozine. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:30:58 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:30:58 <zodbot> The meeting name has been set to 'docs_working_group_aka_dawgs' 14:31:10 <acozine> #topic opening chatter 14:31:13 <acozine> who's around? 14:31:19 <acozine> samccann is out today 14:31:37 <acozine> gundalow is out as well 14:32:03 <acozine> official agenda begins with https://github.com/ansible/community/issues/521#issuecomment-684942921 14:33:30 <acozine> andersson007_: briantist cyberpear felixfontein madonius persysted shaps tremble wangbaoshan_ zbr are you talking docs today? 14:36:03 <acozine> sounds like I'm on my own today 14:36:08 <acozine> I'll post a couple of updates 14:36:26 <acozine> #topic status updatest 14:36:29 <acozine> er 14:36:36 <acozine> #topic status updates 14:36:49 <acozine> it wouldn't do to have typos in the topics!!! 14:36:55 <felixfontein> hey! 14:37:01 <acozine> felixfontein: hey~ 14:37:07 <acozine> heh, I can't type today 14:37:11 <acozine> #chair felixfontein 14:37:11 <zodbot> Current chairs: acozine felixfontein 14:37:22 <felixfontein> isn't it still early for you? ;) 14:37:37 <acozine> not super early - 9:30 AM 14:37:44 <acozine> I'm in the midwest 14:38:07 <felixfontein> for some people, that qualifies as almost in the middle of the night ;) 14:38:18 <acozine> heh, that is true 14:38:35 <acozine> I see US people posting at 1:00 AM 14:39:41 <acozine> I'm just posting a couple of updates about the release 14:40:16 <acozine> #info the Ansible 2.10.0 package release date has slipped to September 15 14:41:36 <felixfontein> #undo 14:41:36 <zodbot> Removing item from minutes: INFO by acozine at 14:40:16 : the Ansible 2.10.0 package release date has slipped to September 15 14:41:44 <felixfontein> it's September 22 14:41:49 <acozine> ??? 14:41:57 <felixfontein> Sept 15 will be RC1 14:42:02 <acozine> oh, the 15th is the final freeze 14:42:03 <felixfontein> (since ansible-base 2.10.1 slipped) 14:42:15 <acozine> I was reading the PR for the roadmap 14:42:25 <felixfontein> ah. I was looking at T.'s email :) 14:42:26 <acozine> guess I need some coffee 14:42:49 <acozine> #info see https://docs.ansible.com/ansible/devel/roadmap/COLLECTIONS_2_10.html for the latest schedule details 14:43:20 <acozine> looks like we are not committing to an actual release date ;-) 14:44:12 <felixfontein> I guess we'll try, but first we need ansible-base 2.10.1 to be released 14:44:17 <acozine> oh, we are, we just didn't update it 14:44:30 <acozine> https://github.com/ansible/ansible/pull/71647/files#diff-6813b85d2e1c466d67be180ed2f57b74R38 14:44:52 <acozine> okay, I think I'm up to date now 14:47:16 <acozine> #info Ansible 2.10.0 package release date is September 22 14:47:16 <felixfontein> from my side there are zero updates, I've not done anything with changelogs or ansible release this last week 14:47:47 <acozine> I know I did things last week 14:48:04 <acozine> but what they were . . . . well, that's a bit fuzzy in my mind 14:48:35 <acozine> ah, I was working on updating more pages for the collections ecosystem 14:48:39 <acozine> https://github.com/ansible/ansible/pull/71606/files 14:48:41 <acozine> etc. 14:48:58 <acozine> #topic updating docs for collections 14:49:40 <acozine> #info if you notice a docs page that needs updates to reflect the collections ecosystem, please post a note in the ansible-docs channel 14:49:50 <acozine> (PRs always welcome as well) 14:51:29 <acozine> oh, we had the first conversation with the web team about the "bitflip" release process - it looks like we will be able to store built artifacts on the webservers to have them ready for the release 14:52:00 <acozine> more details to come on that 14:52:10 <acozine> #topic redirect status 14:52:31 <acozine> docs team needs to publish the redirects to the testing site - that should happen this week 14:52:40 <acozine> then we can try them out 14:53:12 <felixfontein> bitflip: cool! 14:53:20 <felixfontein> redirects: also cool! :) 14:53:29 <acozine> it's coming together 14:53:40 <acozine> kinda last minute, but it's coming together 14:54:01 <acozine> oh, and I'm having a pre-collections redirect mystery 14:54:02 <felixfontein> indeed 14:54:36 <acozine> if you hit http://docs.ansible.com/ping_module.html it redirects to a nonsense URL 14:54:44 <acozine> I thought I'd found the problem and fixed it 14:54:54 <acozine> the fix worked on the test site 14:55:10 <acozine> but I published to production and the problem has not gone away 14:56:21 * acozine digs for the regex 14:56:32 <felixfontein> what do you mean by nonsense URL? 14:57:00 <felixfontein> for me, it first redirects to https, then to https://docs.ansible.com/ansible/ping_module.html, then to https://docs.ansible.com/ansible/latest/ping_module.html, and then finally to http://docs.ansible.com/ansible/latest/modules/ping_module.html (which actually works) 14:57:32 <acozine> huh, okay that's how it's supposed to work 14:57:48 * abadger1999 waves 14:57:49 <acozine> why is it still sending me to https://docs.ansible.com/ansible/latest/ping_module/modules/.html ? 14:57:56 <felixfontein> morning abadger1999! 14:57:58 <acozine> must be a local cacheing issue 14:58:19 <acozine> welcome abadger1999 14:58:21 <acozine> #chair abadger1999 14:58:21 <zodbot> Current chairs: abadger1999 acozine felixfontein 14:58:30 <felixfontein> acozine: it uses 301 Moved Permanently, so in case the redirect was broken once when you tried it in your browser, your browser stores it indefinitely 14:58:49 <felixfontein> clearing the/some sort of cache should solve it 14:58:57 <acozine> phew, this is great 14:59:06 <acozine> I was racking my brains, trying to figure out why it wasn't fixed 14:59:19 <felixfontein> I usually prefer to trace redirects manually with `curl -i` to see what they really are, because browsers are too clever ;) 15:00:11 <acozine> that sounds like a great approach - you just post the first URL in a terminal? 15:00:38 <acozine> TIL 15:00:57 <felixfontein> yes, I start with `curl -i http://docs.ansible.com/ping_module.html`, and then look at its `Location:` header, curl that one, etc. 15:01:36 <acozine> that is going to be a sanity-saver with collections 15:01:40 <acozine> thanks! 15:03:36 <felixfontein> you can probably also use the browser's dev tools by going to the network tab, disable caching (usually a checkbox), and set it so it won't clear on a redirect; then you can also follow redirects pretty well 15:03:54 <felixfontein> I'm not sure if the disable caching checkbox affects the 301 Moved Permanently cache though 15:04:05 <acozine> good to know - I like the command-line solution, though 15:04:25 <acozine> it makes the process visible 15:06:01 <acozine> #topic more status updates 15:06:09 <acozine> I have a couple of other changes to report 15:06:28 <acozine> we've started interviewing candidates for the open Technical Writer position 15:06:55 <acozine> if anyone in the community is interested, please reach out to me as quickly as you can! 15:07:29 <felixfontein> good news :) 15:07:43 <acozine> and, because we expect to welcome a third writer to the internal team, samccann and I are experimenting with an agile process for docs work 15:08:20 <acozine> as we figure out what works for us, we will post updates and invitations to participate to the DaWGs 15:08:41 <acozine> (up until now we have organized our work very informally) 15:09:03 <felixfontein> just don't make it too formal :) 15:09:14 <acozine> heh, we won't 15:10:05 <acozine> but some sense of "what are we hoping to achieve on what time-scale" would probably be helpful 15:10:52 <acozine> and it might be fun to post weekly challenges for docs 15:11:11 <abadger1999> <nod> 15:11:38 <acozine> "this is community.general week" or something, that would give new contributors some direction 15:12:42 <acozine> hm, I should info the job one 15:13:13 <acozine> #info if you are interested in the open Technical Writer position on the Ansible team, reach out to acozine as quickly as you can! Interviews have begun. 15:13:47 <acozine> that's all I can remember for now . . . 15:13:56 <acozine> there's a reason we didn't schedule this meeting for Mondays 15:14:04 <abadger1999> :-) 15:14:12 <abadger1999> Question about the redirects. 15:14:16 <acozine> I need a day back at my desk to pick up the threads 15:14:37 <acozine> abadger1999: excellent, I may or may not have an answer 15:14:37 <abadger1999> What's the next step? Should we check the .htaccess files I have on toshio.fedorapeople.org into the private repo? 15:15:13 <acozine> Next step on redirects: open a PR against the private repo so we can publish to the testing site 15:15:15 * abadger1999 hasn't looked if there's a way to send them just to the testing server and not to the production site 15:15:20 <acozine> yes, there is 15:15:21 <abadger1999> Cool. 15:15:33 <acozine> which has saved me many times 15:16:17 <acozine> I'd like to try putting that .htaccess file in a subdirectory 15:16:25 <abadger1999> <nod> 15:16:50 <acozine> do you have that file as a commit against ansible/docsite? 15:16:53 <acozine> or just as a file? 15:16:55 <abadger1999> Currently we have two .htaccess files. They end up in the ansible/X.Y/ directories. 15:17:04 <acozine> ah, that sounds even better 15:17:22 <abadger1999> acozine: They're just files. There's a WIP PR in antsibull for the script which generates them. 15:17:37 <acozine> okay, I can pull them into the repo 15:18:03 <abadger1999> acozine: I can try to break it up by collection on the 2.10+ directories if you want (or that could be an enhancement for later) 15:18:16 <abadger1999> Cool 15:18:21 <acozine> hmmm 15:18:34 <abadger1999> acozine: I will get you the files.... tarball to download sound good? 15:18:40 <acozine> sure, that sounds fine 15:19:18 <acozine> despite the XKCD classic cartoon, I do have one `tar` command embedded in my memory 15:19:27 <acozine> `tar -xvzf` 15:19:37 <acozine> we'll see if that works in this instance ;-) 15:19:40 <felixfontein> you can also leave the `-` away 15:19:59 <acozine> felixfontein: no doubt, but then my fingers get confused 15:20:13 * acozine types that again without the - 15:20:21 <acozine> `tar xvzf` 15:20:38 <acozine> huh, that works from muscle memory too 15:20:40 <felixfontein> I always forget which one of zZjJ are needed for which compression algorithm... 15:21:37 <acozine> that muscle-memory command works with the specific tarballs we used at my old job (on a digital library project) 15:21:47 <acozine> I could not tell you what algorithm we used, though 15:21:50 <abadger1999> http://toshio.fedorapeople.org/ansible/ansible-docs-redirects.tar.gz 15:22:08 <abadger1999> Untarring will create 2.10/.htaccess and 2.9/.htaccess 15:22:20 <acozine> I just did it so often it got hardwired into my fingers 15:22:55 <acozine> heh, or there's the built-in mac utility, which figures it out for you 15:22:58 * acozine gets lazy 15:23:01 <abadger1999> :-) 15:28:21 <acozine> all right, I need more caffeine before I tackle that task 15:28:27 <acozine> thanks abadger1999 15:28:34 <abadger1999> No problem :-) 15:28:37 <acozine> anything else for the DaWGs today? 15:28:57 <acozine> I saw andersson007_'s PR to postgresql_user docs 15:29:07 <acozine> I'll go through that later today 15:30:20 <acozine> considering it was a long weekend in the US, the PR count isn't too bad 15:30:28 <acozine> up to 70 open docs PRs on ansible/ansible 15:31:15 <acozine> I was worried it would be back to 90 or so 15:31:23 <abadger1999> Cool :-) 15:31:51 <acozine> hey, we're going to finish in exactly an hour 15:31:54 <acozine> amazing~ 15:32:07 <acozine> s/~/! 15:32:42 <abadger1999> A sure sign that we're forgetting something ;-) 15:33:08 <acozine> heh, true - I forgot to do an open floor 15:33:14 <acozine> #topic open floor 15:34:08 <acozine> this is an opportunity to ask questions, make comments, request help, or raise topics related to documentation for Ansible 15:34:40 <acozine> anyone can add a topic to the formal agenda by adding a comment to https://github.com/ansible/community/issues/521 15:34:45 <felixfontein> :) 15:34:55 <acozine> or bring it up in open floor any time 15:35:22 <acozine> is there anyone who has been waiting patiently to chat? 15:36:05 <acozine> we welcome all participants and all questions, from beginner to advanced 15:36:56 <acozine> hearing none for this week, I'm going to close out the official meeting 15:37:02 <acozine> thanks again abadger1999 felixfontein 15:37:05 <acozine> #endmeeting