18:00:01 #startmeeting Ansible Community Meeting 18:00:01 Meeting started Wed Feb 16 18:00:01 2022 UTC. 18:00:01 This meeting is logged and archived in a public location. 18:00:01 The chair is dmsimard. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 18:00:01 Useful Commands: #action #agreed #halp #info #idea #link #topic. 18:00:01 The meeting name has been set to 'ansible_community_meeting' 18:00:10 o/ 18:00:22 #topic Agenda https://github.com/ansible/community/issues/645 18:00:40 #info Agenda: https://github.com/ansible/community/issues/645 / Topics: https://github.com/ansible-community/community-topics 18:00:47 o/ 18:00:48 o/ 18:00:53 #chair andersson007_ cyberpear samccann jillr 18:00:53 Current chairs: andersson007_ cyberpear dmsimard jillr samccann 18:00:56 o/ 18:01:26 hi folks! Steering Committee, this is the last chance to vote on https://github.com/ansible-community/community-topics/issues/67 who hasn't do it yet as I'm gonna count the votes within 30 minutes 18:01:32 #topic updates 18:01:34 please vote who didn't 18:01:58 #chair acozine 18:01:58 Current chairs: acozine andersson007_ cyberpear dmsimard jillr samccann 18:02:04 * dericcrago waves 18:02:11 * gundalow waves 18:02:14 #chair dericcrago gundalow 18:02:14 Current chairs: acozine andersson007_ cyberpear dericcrago dmsimard gundalow jillr samccann 18:02:57 #info There is still work to do but we are in the process of bootstrapping community maintained images for ansible-test and execution environments: https://github.com/ansible-community/images 18:03:29 just voted, sorry I thought I had already voted on that one 18:03:57 thanks briantist :) 18:04:00 #chair briantist 18:04:00 Current chairs: acozine andersson007_ briantist cyberpear dericcrago dmsimard gundalow jillr samccann 18:04:09 one thing I find difficult about the async process is always getting notifications about issues when other people vote and being unsure whether I already voted or not 18:04:37 #info Ansible 5.4.0 coming next week (Feb 22) 18:04:55 briantist: Yup, I struggle with that. Wonder what we can do to improve that 18:05:17 hey all! 18:05:32 I counted too soon, I'll update #67 in a few minutes to give people more time 18:05:39 Wonder if 👍️ 👎️ reactions could help (one comment per vote) 18:06:01 #chair cidrblock 18:06:01 Current chairs: acozine andersson007_ briantist cidrblock cyberpear dericcrago dmsimard gundalow jillr samccann 18:06:06 any other updates before we switch to a topic ? 18:06:27 thumbs ups / downs should work I think 18:06:29 I think it would be better.. but we specifically ask people to comment and not emoji react, so I figured there was some reason for that 18:07:18 let's try to use them instead of commens? 18:07:34 is it because emoji are easier to undo? 18:07:41 ah... 18:07:47 true 18:07:59 is that important? 18:08:23 we could try:) 18:08:41 not to me, but I think that was the reason we came to the conclusion we did 18:09:01 I'm all for trying emoji reactions instead of separate comments 18:09:20 we could attach a screenshot to vote results posted in a topic:) 18:09:34 joking 18:09:46 not to be meta, but I suppose it requires a vote in and of itself? to switch to reactions? 18:09:56 I think we can trust that folks won't change their votes on a whim 18:10:08 iirc emoji reactions can be difficult to count who did what when there's a lot of them, you have to use the graphql api because the web UI condenses it after a point to just a number 18:10:22 like to differentiate SC vs community 18:10:50 oh interesting.. I don't think we have enough people voting for that to happen, but I suppose that could be a concern at some point 18:11:06 yeah mainly to be aware that if that happens, there is a way to get the data 18:11:12 but it's non-obvious 18:11:21 that's cool, TIL 18:12:14 Going to highlight some active discussions and we can continue chatting 18:12:20 I think I could write a quick github action to pull the data and tally votes, as long as the data is available (overkill maybe.. but I wonder if it could trigger on each reaction, and update a vote tally comment so it also won't spam watchers... 🤔) 18:12:35 dmsimard: sounds good, sorry for derail 18:12:39 #topic Active discussions 18:12:59 #info FEEDBACK WANTED: which directories / files / file patterns should be excluded from the Ansible installation? https://github.com/ansible-community/community-topics/issues/65 18:13:11 #info How to handle moving of content from collections inside the Ansible package to collections outside the Ansible package? https://github.com/ansible-community/community-topics/issues/66 18:13:48 #info FEEDBACK WANTED: Crafting better changelog fragments https://github.com/ansible-community/community-topics/issues/64 18:14:13 #info Revamping the community/contributor documentation https://github.com/ansible-community/community-topics/issues/60 18:14:30 I thought this was a good opportunity to share those even if they aren't a vote :) 18:15:01 @cybette:ansible.im cyb-clock chimes every 15 minutes during the community meeting 18:15:28 Any particular topic we want to tackle or should we continue talking about how voting works ? 18:17:56 Just noticing we didn't get any discussion on https://github.com/ansible-community/community-topics/issues/60 18:18:26 specifically, whether we should eventually move these source files 'someplace else" out of ansible/ansible 18:18:27 samccann: I saw that too, would you like to talk to us about it ? 18:18:31 ah I subscribed to that one.. but haven't had a chance to absorb it 18:19:06 The gist of it is - we are currently forcing docs into ansible/ansible repo that aren't related directly to core. It's how our docs publication works right now. 18:19:17 #topic Revamping the community/contributor documentation https://github.com/ansible-community/community-topics/issues/60 18:19:40 So the contributing to collections guide for example - not really core related, but I'm putting the files in ansible/ansible so they can get published. 18:20:55 the benefit is, someone can easily hop from "I'm learning about X module" to "how would I contribute to the docs for this?" to "hm, how could I get involved in the community?", because all those topics are addressed in one place 18:21:14 I know there's a docs directory in hashi_vault: https://github.com/ansible-collections/community.hashi_vault/tree/main/docs, though my understanding is that these are not incorporated in the docs.ansible.com docsite -- are you suggesting we provide a mechanism in order to be able to do that ? 18:21:29 they are incorporated in docs.ansible.com 18:21:42 oh, my bad :o 18:21:44 for example: https://docs.ansible.com/ansible/latest/collections/community/hashi_vault/docsite/contributor_guide.html 18:21:49 acozine: we aren't (yet) talking about moving the html files off of docs.ansible.com/ansible 18:22:04 briantist: that's great, actually 18:22:06 ah, sorry, I misunderstood then 18:22:09 just source files. We'd have to extend `antsibull` for example to pull the rst files for this from another repo during build time 18:22:20 ah, gotcha 18:23:02 talking about this guide - https://docs.ansible.com/ansible/devel/community/contributions_collections.html 18:23:06 (and there's more like that) 18:24:26 so I guess the community discussion is - are there benefits to keeping some docs files in a separate repo if they are not directly related to ansible-core? With the understanding it takes some coding to make this happen? 18:25:14 ok I did write some pros n cons down a bit back - https://hackmd.io/3Cvy2N8tTfSrUzqYZmfEHA#Options 18:25:37 I do think that makes sense... a no coding approach would be to make a pseudo-collection that only has a docsite and include it in the ansible package.. I doubt that's how we'd actually want to go about that though 18:25:38 o/ 18:25:38 sorry, was in another meeting that started late and went over the allotted time 18:25:42 #link https://hackmd.io/3Cvy2N8tTfSrUzqYZmfEHA#Options 18:25:54 #chair cybette 18:25:54 Current chairs: acozine andersson007_ briantist cidrblock cyberpear cybette dericcrago dmsimard gundalow jillr samccann 18:27:32 samccann: is it fair to say that there is no need for these to be versioned after ansible-core or ansible itself ? as in, there would only be latest (or devel) 18:28:19 Yeah that's a separate discussion https://hackmd.io/pEw-17IvQ-Ce1cBZG-pXQQ 18:28:51 I haven't put that into a community-topic yet, but that's the ideas there. Basically, community and contributor guides aren't tied to a release so how can we get around having different versions of them 18:29:16 I like the idea of those pages only being in `latest` if we can make it work 18:29:32 ^^ is closer to acozine's original worry/question - how can we publish them 'someplace else' w/o a version, but still allow curious users to realize they can also contribute 18:30:00 @cybette:ansible.im cyb-clock chimes every 15 minutes during the community meeting 18:30:06 if we could make `antsibull` pull certain docs in for `latest` builds only . . . 18:30:13 acozine - we can't have them only on /latest/. It's either we backport to keep latest/devel in sync, or publish only to /devel/ or... ?? 18:30:35 they should show up in `devel` too, since `devel` is later than `latest` 🙃 or at least redirect 18:30:38 but if they're not in the ansible/ansible repo . . . might that be possible? 18:30:39 the time consuming part isn't the publishing, it's the backports 18:31:09 as in noticing someone made a change on devel and remembering to backport it to latest so that stays accurate. It's not something we've been good at in the past (thus the few files we already only publish to devel) 18:32:19 acozine: possible - we'd need a 'nightly' build for latest then as that is typically only updated when a minor release happens 18:32:30 ...and someone reminds me... cus it's not automated as part of a release anymore 18:33:14 I feel like I've talked myself into a tangled little knot here :-) 18:33:32 haha, you've described the existing knot 18:33:32 maybe what would help is just setting some guardrails. 18:33:51 guardrail one: Ideally, docs in ansible/ansible should relate to core. 18:33:58 is that ^^ something folks agree on? 18:34:29 sounds reasonable 18:34:44 as long as we have a way to keep other docs in `/latest/ansible` 18:34:45 I'm not sure that is entirely up to us to decide 18:35:21 I'm pretty out of my depth with docs but on its own it sounds sensible? 18:35:46 there is a distinct difference even now between what's in `ansible/ansible` (the git repo), and what's published on `docs.ansible.com` (the site) 18:36:11 and I think (correct me if I'm wrong) the crux of samccann 's proposal/discussion is about the former 18:36:24 briantist: agreed. Which is why I'm wondering if this should be another case where source files are not in ansible/ansible.... or am I just making more work for myself and others :-) 18:37:15 We've probably chewed on this quite a bit so far... I don't want to hog the whole community meeting for sure 18:37:28 I do think it's a good thing to think about yeah, takes work to implement, but is probably more correct in the long run.. 18:38:09 ok cool thanks! 18:38:16 samccann: unless mistaken there are no other burning topics and discussion has been somewhat productive so I don't mind continuing if we can straigthen this out 18:39:31 okay so I'm already working on merging what andersson007_ has in the community-docs repo into ansible/ansible so I can get it published 18:39:43 But the next steps after that are probably to dig deeper into two things: 18:40:01 1 - how to pull docs from another repo (so we can move these 'someplace else' and not clutter up ansible/ansible 18:40:16 2- Decide how or if we can create unversioned docs from these files 18:40:51 #2 requires keeping inside the general guardrail of 'as a user/developer of ansible, I want to be able to find out how to contribute to the project' 18:41:19 my mention of a pseudo collection (not a great idea really) is to point out that we DO include docs on docs.ansible.com that do not come from core, so there's a little bit of precedent 18:41:35 yep we do! 18:41:53 yeah, we can build on that 18:42:31 briantist: a pseudo collection (or even an existing one) is not that far fetched considering the mechanism already exists 18:43:08 we could have the exercise of thinking about what the collection could look like, if there are things other than docs that could go in there 18:43:30 right, it should work (as long a collection with no plugins or modules doesn't accidentally breaks omething), but it requires someone to do "releases" of it, and it will show up in the list of collections and such, so it does have some side effects 18:43:31 if there turns out to be a better idea, that's cool too 18:44:25 Yeah we would still need antsibull changes imo because we can't move the contributor stuff into the collection index imo. 18:44:35 I will have to run in a minute or two, but good chat! 18:44:45 I've built roles and some minor plugins for the purpose of building and testing the ansible package itself as well as these new community images -- was thinking whether these should go into a collection :p 18:45:01 @cybette:ansible.im cyb-clock chimes every 15 minutes during the community meeting 18:45:26 samccann: makes sense 18:46:41 ok thanks for the feedback everyon! 18:46:43 samccann: I suggest we check with felixfontein who probably knows antsibull best and can tell us how this looks to him 18:46:45 s/everyon/everyone/ 18:46:54 yep, thanks 18:49:40 thanks everyone for voting on https://github.com/ansible-community/community-topics/issues/67 and reviewing the PR, jillr thanks for helping with vote count! 18:50:14 #topic open floor 18:50:40 #info changelog guidance PR ready for review - https://github.com/ansible/ansible/pull/77040 18:51:11 ^^ that was based on the changelog feedback community topic. I moved the results into a PR for review and merging. Thanks everyone for helping in that discussion! 18:51:51 I mentioned this earlier but gonna toss it in an info... 18:51:55 #info looking for feedback on whether or not to post community guides only to devel. See for a rough draft of the pros n cons. - https://hackmd.io/pEw-17IvQ-Ce1cBZG-pXQQ 18:52:01 #undo 18:52:01 Removing item from minutes: INFO by samccann at 18:51:55 : looking for feedback on whether or not to post community guides only to devel. See for a rough draft of the pros n cons. - https://hackmd.io/pEw-17IvQ-Ce1cBZG-pXQQ 18:52:15 woopsie. I should turn it into a community-topic first.. sorry bout that! 18:54:12 samccann: not a bad thing to share it ahead of time ¯\_ (ツ)_/¯ 18:54:50 If there are any topics we want to share wider, would be good to put them in #social:ansible.com so they can go in tomorrow's edition of The Bullhorn 18:55:24 share early, share often 18:55:36 +1 18:56:29 does that translate to #ansible-social on IRC? 18:56:32 incremental sharing:) 18:56:38 cyberpear: Yup 18:57:10 anything else for open floor before we close the meeting ? 18:58:26 going once 18:59:10 going twice 18:59:32 thanks everyone for joining :) 18:59:36 #endmeeting