1692111634458 <@orandon:ansible.im> #o/ 1692111642604 <@orandon:ansible.im> #hey TVo 1692111649663 <@tvo318:matrix.org> #You have my full attention today, the other community call has been miraculously moved! 1692111655635 <@samccann:ansible.im> #^info we're trying the draft Matrix meeting bot this week. Commands are ^info and ^action. Only works from Matrix right now. 1692111661399 <@samccann:ansible.im> #woot! full-time-tvo! 1692111672082 <@samccann:ansible.im> #^info will eventually log to the forum once it's active. 1692111678532 <@samccann:ansible.im> #@room Meeting time! Who is here to talk the docs? 1692111686864 <@samccann:ansible.im> #Raise your ascii hand (o/) to say hi or any other way you want to let us know you are here. And Welcome to any new folks! 1692111702218 <@samccann:ansible.im> #General run of the meeting - We go over action items, give docs updates.. maybe have a topic or two, and go over doctooling updates (all the fun stuff behind the scenes that get us docs.ansible.com!) 1692111740736 <@relaybot:ansible.im> #samccann_irc_> felixfontein briantist - you around to talk docs today? 1692111757290 <@samccann:ansible.im> #^^ cuz pings don't work on the relaybot 1692111759733 <@relaybot:ansible.im> #briantist> unfortunately no, I can't today 1692111772437 <@relaybot:ansible.im> #oranod> hey briantist 1692111789095 <@samccann:ansible.im> #ok thanks! hope to see ya around later! 1692111826176 <@relaybot:ansible.im> #briantist> gey oranod 1692111828831 <@relaybot:ansible.im> #briantist> hey* 1692111853877 <@samccann:ansible.im> #gey could be a fun new greeeting! 1692111869531 <@samccann:ansible.im> #greeeeeeeting. omgosh.. fun with typing 1692111883811 <@samccann:ansible.im> #official agenda at https://github.com/ansible/community/issues/678#issuecomment-1669889575 1692111892394 <@samccann:ansible.im> #so let's get started! 1692111903530 <@felixfontein:matrix.org> #I'm busy with an emergency, will join once I'm done with it 1692111916691 <@orandon:ansible.im> #good luck Felix Fontein 1692111917938 <@samccann:ansible.im> #ok thanks! hope it goes well 1692111940654 <@_discord_848870546254069761:ansible.im> #Hey samcann (@_discord_930864645756035143:ansible.im) trying to join the right channel on matrix for docs 1692111940778 <@samccann:ansible.im> #^topic Documentation Updates 1692111961020 <@samccann:ansible.im> #Welcome dule_martins 1692111976720 <@samccann:ansible.im> #It's the https://matrix.to/#/#docs:ansible.com channel 1692111983667 <@acozine:ansible.im> #o/ 1692111986534 <@samccann:ansible.im> #hmm.. that might not have been helpful lol 1692111990785 <@relaybot:ansible.im> #samccann_irc_> https://matrix.to/#/#docs:ansible.com 1692112015793 <@samccann:ansible.im> #oh well. if you can't find it, then let me know your matrix ID and maybe I can just invite you 1692112110481 <@dulemartins:matrix.org> #Thank you samccann 1692112112196 <@samccann:ansible.im> #hey there ya are! Welcome Tabah Baridule (aka Dule_martins 1692112123166 <@samccann:ansible.im> #ok where were we? 1692112126307 <@dulemartins:matrix.org> #😍😍 1692112154934 <@tvo318:matrix.org> #We are just getting started... 1692112156615 <@samccann:ansible.im> #^info awx operator RTD is nearly there! This was a community-writer project and we are nearly at the point of publishing it! 1692112218689 <@samccann:ansible.im> #Not sure if sutapa_bhattacharjee is around today to chat about the cheatsheet effort? 1692112273975 <@orandon:ansible.im> #congrats on that awx operator doc everyone πŸŽ‰ 1692112288455 <@acozine:ansible.im> #awesome work! 1692112290358 <@samccann:ansible.im> #^info kickstarting a community effort to create docs for the new galaxy collection https://github.com/ansible-community/community-team/issues/310 1692112306267 <@samccann:ansible.im> #so yeah we're going from one success story (nearly there) to the next one. 1692112324450 <@samccann:ansible.im> #and kudos to Tabah Baridule for spearheading the community-writers group btw! 1692112341464 <@orandon:ansible.im> #great work Tabah Baridule 1692112361091 <@orandon:ansible.im> #it really is awesome to see what's happening 1692112418156 <@samccann:ansible.im> #And 0xanon.eth and LuluNwenyi for doing the hard work of converting the Readme to docs... and sutapa_bhattacharjee for setting up the mkdocs scaffolding 1692112440173 <@samccann:ansible.im> #are real community win. and once the RTD is published, y'all have to remind me to newsbot the whole thing for the bullhorn 1692112479904 <@samccann:ansible.im> #Don Naro: did you want to take this one? 1692112487240 <@orandon:ansible.im> #we also need to add that to the ecosystem page when it's live 1692112492788 <@samccann:ansible.im> #yeppers 1692112520793 <@samccann:ansible.im> #^action samccann to announce awx-operator docs and kudos to bullhorn when it's published 1692112521120 <@orandon:ansible.im> #ah, so we're ready to move on to the docsite topic? 1692112535198 <@samccann:ansible.im> #^action add to ecosystem page as well (awx-operator) 1692112540022 <@samccann:ansible.im> #yes please 1692112603725 <@orandon:ansible.im> #gotcha. so this is mostly for awareness but we're porting over the templates and build stuff for the docsite landing pages. here's the PR: https://github.com/ansible/docsite/pull/182 1692112646318 <@orandon:ansible.im> #to follow up on something we've talked about before here, I plan to just remove the `prod` branch 1692112683122 <@orandon:ansible.im> #that was needed for that RH-internal jenkins job that deploys to the web server. but now we can just build and deploy in jenkins. 1692112698362 <@orandon:ansible.im> #so no using github to store generated artifacts on a dedicated branch 1692112747880 <@orandon:ansible.im> #the other thing is that I plan to use Read The Docs for PR previews and a test / staging site 1692112760236 <@samccann:ansible.im> #^info porting over the jinja2-docsite etc to the ansible/docsite repo - https://github.com/ansible/docsite/pull/182 1692112760971 <@orandon:ansible.im> #which is probably something the community cares a bit more about 1692112798390 <@samccann:ansible.im> #ah so if someone changes those main docsite pages, the pr will now post to RTD? 1692112852427 <@orandon:ansible.im> #indeed. we'll stage on RTD and also get PR previews. it's a little unusual for a site but we're trying to support the RTD community too. 1692112872848 <@samccann:ansible.im> #coolness 1692112946653 <@orandon:ansible.im> #right. the other thing I had might be a more interesting discussion. 1692112957050 <@samccann:ansible.im> #topic change? 1692112961552 <@orandon:ansible.im> #^topic ecosystem docs 1692112967877 <@samccann:ansible.im> #not that topics work but still ;-) 1692113072671 <@orandon:ansible.im> #like that? 1692113083223 <@samccann:ansible.im> #you were right the first time... ^topic (when it works in the future) 1692113094349 <@dulemartins:matrix.org> #Thank you very much Don Naro 1692113190450 <@orandon:ansible.im> #ok, so we talked a little about this before but we've been talking about setting up a structure in the `ansible-documentation` repository like this: ``` docs/ β”œβ”€ core/ β”‚ β”œβ”€ rst/ β”‚ β”‚ β”œβ”€ index.rst β”œβ”€ ecosystem/ β”‚ β”œβ”€ rst/ β”‚ β”‚ β”œβ”€ index.rst β”œβ”€ package/ β”‚ β”œβ”€ rst/ β”‚ β”‚ β”œβ”€ index.rst ``` 1692113221089 <@orandon:ansible.im> #that doesn't actually look too bad on irc 1692113253306 <@orandon:ansible.im> #anyway the purpose here is to find a place for "top-level" docs that span projects 1692113261154 <@dulemartins:matrix.org> #That structure doesn’t look bad 1692113268299 <@orandon:ansible.im> #project docs would lean more towards getting started, concepts, reference 1692113299221 <@orandon:ansible.im> #ecosystem docs would tackle more how to style content 1692113343288 <@samccann:ansible.im> #so the EE getting started would be like an ecosystme doc? 1692113369715 <@orandon:ansible.im> #yeah, exactly. the one we just stuck on devel 1692113399914 <@samccann:ansible.im> #So rough question - with everything-but-package docs on RTD, how does that affect search? 1692113417705 <@samccann:ansible.im> #or would you still have the core docs (playbooks/inventoryetc) still on the package docs? 1692113435987 <@samccann:ansible.im> #or maybe I'm jumping the gun and should just let you finish 1692113460226 <@orandon:ansible.im> #no, it's cool. I don't want to touch those package docs really. 1692113520269 <@orandon:ansible.im> #maybe decouple some of the core content like those porting guides at some stage 1692113537678 <@samccann:ansible.im> #ah ok so restructuring the repo, but the end result (for package docs ) are the same for now? 1692113574773 <@orandon:ansible.im> #yeah for sure. I don't want to change the package docs. 1692113650341 <@acozine:ansible.im> #Reading that structure, it looks like `core` and `ecosystem` and `package` are all on the same "level" - is that the intention? 1692113661054 <@orandon:ansible.im> #yes 1692113699426 <@orandon:ansible.im> #it seems better than creating yet another repo. `ansible-documentation` can give us more of a one stop shop for contributors. 1692113714549 <@acozine:ansible.im> #I think of `core` and `package` as parts of the ecosystem 1692113721771 <@acozine:ansible.im> #but I think I'm not following the constraints here 1692113767236 <@orandon:ansible.im> #I think they're definitely part of the ecosystem too. I see your point, thanks. that could be confusing. 1692113778945 <@dulemartins:matrix.org> #What is RTD? 1692113784312 <@orandon:ansible.im> #probably just had ecosystem stuck in my head 1692113790155 <@acozine:ansible.im> #ReadTheDocs 1692113791900 <@orandon:ansible.im> #Tabah Baridule: RTD = Read The Docs 1692113793692 <@tvo318:matrix.org> #Read the Docs 1692113800218 <@orandon:ansible.im> #it's the community docs hosting platform 1692113814980 <@acozine:ansible.im> #https://docs.readthedocs.io/en/stable/ 1692113807779 <@dulemartins:matrix.org> #Ooh! Thank you Don Naro 1692113821590 <@dulemartins:matrix.org> #Ya! I know about that 1692113825927 <@dulemartins:matrix.org> #Platform 1692113838337 <@orandon:ansible.im> #no worries 1692113863033 <@dulemartins:matrix.org> #I have some questions to ask about the community 1692113909416 <@orandon:ansible.im> #ok, why don't you go ahead Tabah Baridule I think I can put some of my discussion stuff in a community topic and not take too much time 1692113917394 <@samccann:ansible.im> #Don Naro: so what is 'ecosystem'? Are they cross-project docs? So combining navigator with execution environments? 1692113942677 <@orandon:ansible.im> #samccann: yes, cross-project tutorials and how tos 1692113942522 <@felixfontein:matrix.org> #o/ 1692113979865 <@samccann:ansible.im> #Welcome Felix Fontein 1692113992081 <@samccann:ansible.im> #^Open Floor 1692114032099 <@dulemartins:matrix.org> #Okay Don Naro My question is about the disconnection of Matrix and Discord I really will love to keep up the channel we have on discord and do my best to bring more contributors to the project But don’t know how this can work with the bridge soon to collapse 1692114037646 <@samccann:ansible.im> #^topic Open Floor 1692114062565 <@samccann:ansible.im> #Tabah Baridule: Can we get people to join matrix like you did? 1692114077466 <@orandon:ansible.im> #Gwmngilfen: any suggestions ^? 1692114079476 <@samccann:ansible.im> #from what I hear, the bridge may not come back any time soon 1692114079880 <@tvo318:matrix.org> #I just joined Discourse 1692114108876 <@relaybot:ansible.im> #bcoca> discourse? is that the 'polite' competitor to discord? 1692114110486 <@samccann:ansible.im> #oh yeah.. Tabah Baridule - ansible will have a discourse forum open to everyone ..erm.. in September I think 1692114132584 <@samccann:ansible.im> #That will have dedicated places to talk about docs and might be even better than people joining matrix. 1692114137766 <@dulemartins:matrix.org> #That will be kind of difficult samccann 1692114148222 <@relaybot:ansible.im> #felixfontein> bcoca: they are two unrelated products of similar name 1692114152501 <@relaybot:ansible.im> #bcoca> ^ meant it as a joke .. but seems i was right ... 1692114163740 <@relaybot:ansible.im> #oranod> lol 1692114171329 <@tvo318:matrix.org> #I don't know for sure. 1692114173855 <@relaybot:ansible.im> #bcoca> `Discourse is the place to build civilized communities ` 1692114198574 <@dulemartins:matrix.org> #I’m thinking maybe we can keep up with the task board on GitHub and I make announcements on discord 1692114217157 <@dulemartins:matrix.org> #Since basically why we are doing this is to make contributions 1692114233365 <@samccann:ansible.im> #Tabah Baridule: yeah the discord ansible writers group can stay active for sure.. and the github board and the new forum as a place to discuss 1692114235985 <@tvo318:matrix.org> #What I understand about Discourse is where you drop in your ideas 1692114254441 <@samccann:ansible.im> #The only thing we loose is bridging this docs channel to the discord. I'm not sure how many people over there are following all this 1692114253367 <@tvo318:matrix.org> #and the community will see and discuss. 1692114262231 <@gwmngilfen:ansible.im> #1. Discourse and Discord are entirely separate. Ansible has no *official* Discord presence 2. The Discord bridge to Matrix isn't going away, we pay for that 1692114267195 <@samccann:ansible.im> #I've only seen you and maybe two others poke in here from time to time? 1692114308605 <@dulemartins:matrix.org> #samccann: that is why I feel information can be easily move across platform by me 1692114362529 <@samccann:ansible.im> #yeah I think with the new forum, we may get more attention from the ecosystem projects as well to add more docs issues to the project board 1692114444336 <@tvo318:matrix.org> #@Gwmngilfen so is there a bridge from Matrix to Discourse, or just use Discourse exclusively? 1692114454887 <@samccann:ansible.im> #matrix to DISCORD 1692114471573 <@tvo318:matrix.org> #I'm specifically asking about Discourse 1692114474694 <@samccann:ansible.im> #so bit of history - Tabah Baridule set up a DISCORD community of writers because that's the tool they use 1692114480611 <@samccann:ansible.im> #it's like matrix - a chat client 1692114492280 <@samccann:ansible.im> #matrix, irc, discord are all in the same family so to speak 1692114492335 <@relaybot:ansible.im> #bcoca> i dont see current plugin on discourse side, but API seems easy to create plugin to send/repost messages 1692114499449 <@tvo318:matrix.org> #I am not familiar with Doscord. 1692114507789 <@tvo318:matrix.org> #I am not familiar with Discord. 1692114525755 <@relaybot:ansible.im> #bcoca> discord started as a gamers version of slack 1692114537924 <@relaybot:ansible.im> #bcoca> its a hosted service, like slack 1692114554941 <@samccann:ansible.im> #TVo: it's not a place anyone else needs to be. It's just a way for me to communicate with those writers. We use a github project board to coordinate issues/PRs that are simple docs fixes mostly 1692114562839 <@relaybot:ansible.im> #bcoca> while matrix and discourse CAN be hosted, the software is opensource (clienet and server) and you can self host 1692114571880 <@gwmngilfen:ansible.im> #bcoca++ spot on 1692114579416 <@tvo318:matrix.org> #ah ok, thanks for the background samccann and bcoca 1692114598354 <@samccann:ansible.im> #ok we have one more item to talk about today so let's move on 1692114612197 <@samccann:ansible.im> #^topic AWX/controller docs effort 1692114617175 <@relaybot:ansible.im> #bcoca> ^ this is my first job in which i don't set up an internal irc/jabber/X chat server 1692114651710 <@relaybot:ansible.im> #bcoca> technically 3rd .. if i count being aquired as job change ... 1692114663044 <@orandon:ansible.im> #So on the topic there is some exciting news to share with the community about the AWX documentation. For quite some time there has been a set of content for the downstream platform controller on β€œdocs.ansible.com” with no real community equivalent. This has lead to confusion and some misunderstanding for everyone involved. 1692114701444 <@orandon:ansible.im> #To tackle that TVo and I are moving the RST source files for what is currently the platform controller from a private repository to the public `ansible/awx` repository. The output of that will be a single docs build that we’ll host on Read The Docs. 1692114709366 <@orandon:ansible.im> #AWX documentation will join the Ansible project ecosystem! 1692114723651 <@orandon:ansible.im> #Here's the WIP PR so you can see what we’re doing: https://github.com/ansible/awx/pull/14328 1692114731716 <@orandon:ansible.im> #^info WIP PR so you can see what we’re doing: https://github.com/ansible/awx/pull/14328 1692114744329 <@orandon:ansible.im> #TVo: anything you want to add in there? 1692114747443 <@samccann:ansible.im> #^info controller docs are being ported to ansible/awx to become AWX docs! https://github.com/ansible/awx/pull/14328 1692114762430 <@relaybot:ansible.im> #bcoca> +100 1692114801149 <@relaybot:ansible.im> #bcoca> is it going to be the same for all anslbe projects? 1692114831909 <@tvo318:matrix.org> #Thanks for the mention, Don Naro . Don has done a lot of infrastructure updates to build files, stylesheets, conf files.. I am working on the content itself, Currently going through the admin guide, updating all information not pertinent to community and replacing screens with AWX ones. 1692114872165 <@relaybot:ansible.im> #oranod> bcoca how do you mean? if we're on the same page I just meant we'll have community AWX docs in the ecosystem along with all the other project docs 1692114899097 <@tvo318:matrix.org> #I'll comb through each guide currently hosted on docs.ansible.com/automation-controller and get it all in one PR to merge to the main before it becomes "official" and ready for community contribution. 1692114922267 <@samccann:ansible.im> #coolness! Exciting times! 1692114924836 <@relaybot:ansible.im> #bcoca> oranod: i konw core was being moved there also and that runner was already there, i inffer from your resposne that the others are also there already, which answers my question 1692114945666 <@samccann:ansible.im> #yeah i think the goal is all docs except the package docs go to RTD 1692114962503 <@samccann:ansible.im> #package docs are ..erm.. too resource-intensive to build on that platform if I recall? 1692114970133 <@orandon:ansible.im> #maybe we'll be able to talk about those package docs at some point too 1692114976705 <@samccann:ansible.im> #woot! 1692114990464 <@orandon:ansible.im> #I see promise in the nox stuff that gotmax23 is putting together 1692114992912 <@relaybot:ansible.im> #bcoca> also something a lot of people asked for ... pdf copy for offline use! 1692115001301 <@relaybot:ansible.im> #bcoca> now its 'built in' 1692115014343 <@samccann:ansible.im> #oh I'm mixing topics here Don Naro but is the restructure of the `ansible-documentation` repo what is needed before we get core docs on RTD? 1692115036265 <@relaybot:ansible.im> #felixfontein> did I understood that correctly, the ansible-core docs move to RTD? 1692115038022 <@samccann:ansible.im> #haha yea was about to say that as well bcoca - we'll get PDF finally!!! 1692115045288 <@orandon:ansible.im> #we don't have to restructure everything to do that 1692115073805 <@relaybot:ansible.im> #oranod> felixfontein: hey, not that the core docs will move, just that we'll be able to duplicate them on RTD 1692115098376 <@relaybot:ansible.im> #felixfontein> ah ok 1692115107380 <@samccann:ansible.im> #yeah kind of like how we have them on docs.ansible.com/ansible-core today 1692115109044 <@relaybot:ansible.im> #oranod> maybe that'll make it possible to revisit some things and do some further decoupling 1692115160177 <@samccann:ansible.im> #ok we have a minute left.. anything else to talk about today? 1692115214374 <@tvo318:matrix.org> #not from me... 1692115268416 <@orandon:ansible.im> #thanks samccann and all