09:13:53 #startmeeting Fedora Documentation FAD 2018 - Day 5 09:13:53 Meeting started Fri Mar 2 09:13:53 2018 UTC. The chair is jwf. Information about MeetBot at http://wiki.debian.org/MeetBot. 09:13:53 Useful Commands: #action #agreed #halp #info #idea #link #topic. 09:13:53 The meeting name has been set to 'fedora_documentation_fad_2018_-_day_5' 09:13:58 #meetingname fedora_docs 09:13:58 The meeting name has been set to 'fedora_docs' 09:14:01 #topic Hack Time! 09:14:47 #chair asamalik[m] bexelbie coremodule cverna jsmith langdon mattdm mayorga ryanlerch sumantro zoglesby 09:14:47 Current chairs: asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga ryanlerch sumantro zoglesby 09:15:07 sumantro: If you want to jump in on the video bridge, let us know and I can put it up for you 09:15:49 Southern_Gentlem: We didn't see your question before we broke for lunch. 09:16:11 Southern_Gentlem: Everything in the quick-docs repos were taken verbatim from the wiki pages in October 2017. Were the changes made after October? 09:16:48 If so, they may have been missed in the docs conversion. We can go back and update it if there is more recent information. 09:18:54 Southern_Gentlem: I see that coremodule is currently working on the "Fedora Live CD" and sumantro was working on the "Fedora Media Writer" article. They may have more information. 09:23:03 good morning everyone 09:23:23 * jwf waves to mattdm 09:23:27 #chair asamalik 09:23:27 Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga ryanlerch sumantro zoglesby 09:30:57 cverna: I just did a commit on the fedora-docs/documentation-guide -- where should I expect to get notified of the CI run? (Or is it only running for PRs at this point?) 09:32:05 jsmith: so commit will trigger a build to update the production site 09:32:57 jsmith: but looking at the log there was an error. also I am not sure we are actually rebuilding production yet 09:33:14 cverna: In the future, I do think that's what we want, but it's my understanding that we *don't* want to push to production at this point. 09:34:10 jsmith: yes I think the production part in not yet 100% ready. but in the case of the commit you did to the documentation-guide 09:34:22 something went wrong before triggering the build 09:34:28 I am looking at it 09:34:54 Thanks... 09:35:24 mattdm bexelbie: I'd like either of you to review this page specifically because CoC and subtle legal warnings are implied in the doc: https://pagure.io/fedora-commops/onboarding-guide/pull-request/2 09:42:50 mattdm, ^^ please review my comment in the file 09:48:14 #chair shaunm rkratky 09:48:14 Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch shaunm sumantro zoglesby 09:48:33 jsmith: ok I deployed a fix, so for now on commit we will rebuild this site http://docs-ci-fedora-docs.apps.ci.centos.org/ 09:57:02 cverna: Thanks :-) 10:02:43 cverna: That site doesn't look it's being built from master, or at least hasn't been rebuilt lately... can you give me any more insight into how you're building? 10:03:06 cverna: (This is after I committed another change to fedora-docs/documentation-guide 10:03:23 jsmith: ok let me look :) 10:05:56 so we correctly triggered the build 10:06:21 the build is using the builder.sh from https://pagure.io/fedora-docs/docs-fp-o 10:06:59 .and I think the documentation guide is not included in this script 10:07:31 jsmith: ^^ 10:08:39 When someone has a chance to review and pull: https://pagure.io/fedora-docs/quick-docs/pull-request/21# 10:16:11 cverna: It's not yet, but the rest of the site that's getting built is not what's in master there. 10:16:45 cverna: Or, in other words, the content that you're building seems to be out of date 10:22:28 jsmith: Oh ok I got it :) 10:22:51 jsmith: we are rebuilding a for of docs-fp-o 10:23:01 https://pagure.io/forks/bstinson/fedora-docs/docs-fp-o.git 10:23:18 bstinson's fork is probably not up to date 10:27:47 jsmith: is that better http://docs-ci-fedora-docs.apps.ci.centos.org/ 10:29:04 #chair x3mboy 10:29:04 Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch shaunm sumantro x3mboy zoglesby 10:54:15 cverna: Still looks out of date, but I'm waiting to talk w/ bexelbie about it, because he knows that stuff better. 10:54:39 jsmith: we really only run the builder.sh 10:54:54 from fp-docs-o 11:01:08 cverna: OK. I'll follow up with bexelbie after he finishes his other discussions 11:07:12 jsmith: no problem thanks 11:10:02 Hi everyone. The following docs are ready for review/pull at your convenience: dnf.adoc & dnf-system-upgrade.adoc (https://pagure.io/fedora-docs/quick-docs/pull-request/31), upgrading.adoc & firewalld.adoc (https://pagure.io/fedora-docs/quick-docs/pull-request/28), flash.adoc (https://pagure.io/fedora-docs/quick-docs/pull-request/33). 11:24:53 bexelbie mattdm: Thanks for the feedback, opted to keep it simple: https://pagure.io/fedora-commops/onboarding-guide/pull-request/2#comment-47035 11:25:27 jsmith: I think I've beaten this one to death with coremodule – would you mind taking a look, and if it checks out, merge it into quick-docs? https://pagure.io/fedora-docs/quick-docs/pull-request/21 11:25:37 #link https://pagure.io/fedora-docs/quick-docs/pull-request/21 11:25:43 #link https://pagure.io/fedora-docs/quick-docs/pull-request/28 11:25:47 #link https://pagure.io/fedora-docs/quick-docs/pull-request/31 11:25:53 #link https://pagure.io/fedora-docs/quick-docs/pull-request/33 11:26:16 And then adding the three PRs sassam wanted review on into the minutes 11:26:28 sassam: Oops, I was thinking you were shaunm, my mistake! 11:26:34 #unchair shaunm 11:26:34 Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch sumantro x3mboy zoglesby 11:26:36 #chair sassam 11:26:36 Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch sassam sumantro x3mboy zoglesby 11:52:20 cverna: Is it possible you're not pulling the latest version of builder.sh? 11:52:48 cverna: bexelbie seems to think you're using an old version of builder.sh, and should be rebuilding the s2i image whenever the builder.sh script is updated 11:52:56 jwf: Looking at it now 11:57:21 jsmith: Thanks! 12:02:13 jsmith: might be possible 12:05:33 jsmith: yes the s2i image is quite old 8days 12:05:43 oh 5days :) 12:06:12 we need bstinson to rebuilt it and push it to the registry 12:24:35 cverna, that image needs to be rebuilt every time there is an update to fedora-docs/docs-fp-o 12:24:40 master branch 12:27:21 Asking this in channel for the benefit of remotees and the logs, but bexelbie, was there any headway on deploying a staging version of sub-project docs like CommOps? 12:29:41 bexelbie: ok I ll discuss with bstinson how we will do that 12:30:58 To be discussed soon™ 12:31:04 #topic Lunch time! 15:01:51 When someone has a chance to review and pull: https://pagure.io/fedora-docs/quick-docs/pull-request/34 15:09:39 jwf not that i know of because i checked them in december and it had not changed (this is a major issue for me) 15:10:19 jwf, and of course with the forward you cannot get into the wiki to see when and whom set the forward 15:13:01 Oops, forgot to change the topic 15:13:06 #topic Hack Time! (Round 2) 15:14:44 Southern_Gentlem: It looks like there were changes made after the page was pulled: https://fedoraproject.org/w/index.php?title=Livemedia-creator-_How_to_create_and_use_a_Live_CD&action=history 15:15:15 Southern_Gentlem: I'm sure this was an intentional move to delete information but an oversight for more recent changes 15:15:46 I'm not sure if coremodule was working on _this_ page right now already or if it's a different one. Otherwise, I'm actually not sure what's the best thing to do here or what happened to the missing info 15:15:50 cverna: the s2i image doesn't actually contain any of the source code, it should be pulling directly from fedora-docs/docs-fp-o (including the new builder.sh) every time 15:15:51 this is the latest commit we built: af004193891b5dad8de1334bbf410462f80be09d 15:16:49 bstinson: Weird -- it wasn't using the latest builder.sh earlier, but seems to be working better now 15:17:08 I'll take a closer look after the FESCo meeting. 15:17:10 bstinson: so this is the latest commit 15:21:43 Southern_Gentlem: yeah, sorry, that was my mistake. 15:21:56 that said, if you want to migrate this over to an updated adoc, that'd be _awesome_ :) 15:23:04 jwf, Southern_Gentlem, the page I'm working on is the live-cd install page, but I can look at this one if you want. 15:23:25 i point to the earlier version for my respins and when the whole toolchain information suddenly disappears that raising a lot of concerns 15:24:00 Southern_Gentlem: yeah, that wasn't the intention -- I just mis-matched the titles 15:24:09 mattdm, if someone could just turn off the redirect it would be very helpful 15:24:19 Southern_Gentlem: oh, already done :) 15:24:40 Southern_Gentlem: ftr it can be removed by going to 15:24:44 https://fedoraproject.org/w/index.php?title=Livemedia-creator-_How_to_create_and_use_a_Live_CD&action=edit 15:24:46 or 15:24:48 https://fedoraproject.org/w/index.php?title=Livemedia-creator-_How_to_create_and_use_a_Live_CD&action=history 15:25:02 nothing is deleted 15:27:30 mattdm, i suspect the livemedia and livecd-creator sites got tagged as the same 15:34:24 Southern_Gentlem: it's simpler than that. I went looking for the livemedia page, found that one and didn't look closely enough :) 16:27:23 build-custom-kernel.adoc is ready for review/pull at https://pagure.io/fedora-docs/quick-docs/pull-request/35 16:45:29 cverna, bexelbie: the docs pipeline has a new home: https://pagure.io/aquedoc 16:46:02 nice, I like the name :) 16:52:19 bstinson++ 16:52:19 mattdm: Karma for bstinson changed to 5 (for the f27 release cycle): https://badges.fedoraproject.org/tags/cookie/any 16:54:56 bstinson++ 16:54:56 mayorga: Karma for bstinson changed to 6 (for the f27 release cycle): https://badges.fedoraproject.org/tags/cookie/any 16:56:05 bstinson++ 16:56:50 bstinson++ 16:56:50 sumantrom: Karma for bstinson changed to 7 (for the f27 release cycle): https://badges.fedoraproject.org/tags/cookie/any 17:17:58 https://fedoraproject.org/wiki/How_to_reset_a_root_password 17:49:08 coremodule: https://access.redhat.com/solutions/43133 17:57:20 Side note, we still need to fix the badges for doc writers, the code to award badges was never moved to pagure repos. At the time that I looked at it I don't think (when we first moved) no one had implamented the changes for pagure, but I figure by this point someone must have done this same thing for other badges. 17:57:51 I am not saying that it needs done during the FAD, but I wanted to get it on other peoples radar. 18:12:09 bstinson++ Thanks for all your help on the CI! 18:12:09 jwf: Karma for bstinson changed to 8 (for the f27 release cycle): https://badges.fedoraproject.org/tags/cookie/any 18:12:29 zoglesby: I'm interested in helping with that 18:12:40 zoglesby: Could you file an issue on the Badges repository? https://pagure.io/fedora-badges 18:12:52 I think the badges are a good motivator for getting more people on-board with docs 18:12:59 So I think we should def get that on the radar too 18:13:29 Sadly, the Pagure badges as a whole are broken, but hopefully we can fix those and then update the docs badges 18:13:34 Yeah, I will do that in a bit 18:13:38 Maybe update the names too, from writing beats to pages 18:13:44 zoglesby++ Thank you! 18:37:35 #topic Wrapping up 18:37:44 mattdm speaking now 18:37:52 #info Thanks everyone for coming out and working during this week! 18:38:57 #link http://etherpad.osuosl.org/fdocs2018 18:39:23 #info Before this, Docs project was mostly automated message for meeting that people weren't attending; we want people who were here or participating remote to keep the momentum after FAD 18:40:12 #info bexelbie is great, but he is no longer able to contribute significantly to documentation 18:40:32 #info If leadership isn't interesting, join the docs team! A team of enthused people is even more important than a single leader 18:41:23 #help For those interested in becoming active, keep participating! Easier for bexelbie to run meetings than to spend large portion of time hacking on docs. Come to the meetings and keep working with us on putting up the docs. 18:42:06 #info ryanlerch made the front page more simple and cleaned up the design 18:42:14 #link https://docs.stg.fedoraproject.org/ 18:43:11 #info mattdm: Spent a lot of time working on the Council Docs repositories, expanded on leadership for Fedora Project 18:43:16 #link https://docs.stg.fedoraproject.org/fedora-project/project/leadership.html 18:43:37 #link https://docs.stg.fedoraproject.org/fedora-project/project/objectives.html 18:43:58 #info Objectives page is expanded with an overview and how to propose one 18:44:13 #info Lists current objectives, but that was mostly wiki copypaste 18:44:28 #info Most data is intended to be static in the Council Docs with minor changes each release or year 18:45:19 #info langdon: Details for Objectives should be more detailed 18:46:25 #info rkratky: Better header rendering between Objectives 18:46:56 #info mattdm drew a lovely mindmap of the entire Fedora community! 18:47:04 #link https://docs.stg.fedoraproject.org/fedora-project/project/orgchart.html 18:47:34 #info By itself, hard to read: But a good representation of how the Fedora community is spread apart 18:47:55 bexelbie> suggestions: make the objectives page in the council more visually distinctive to keep the objectives from bleeding together 18:47:55 suggestion: maybe put objectives on the leadership page or reference them from there 18:47:55 #info look at the amazing map on the high-level org page :) 18:47:58 moving to the right meeting 18:48:31 #info many pages still need work - there is still room for you to contribute 18:48:34 #help Council Docs: "Get help!" and "Get involved!" pages need help 18:50:50 #info Fedora Project leadership pages expanded with pictures and other changes to make them more personal, to show that it's a community of people behind the project 18:51:06 #link https://docs.stg.fedoraproject.org/fedora-project/council/fpl.html 18:51:53 #info Goal is to have this info for all Council members 18:53:11 #link https://docs.stg.fedoraproject.org/fedora-project/council/fpgm.html Some pages are still unchanged and need love 18:53:58 #help Policy statements being surfaced out of the wiki should be surfaced; help bexelbie and drop a line if you stumble on these things 18:54:29 #info notice how we converted the tables on the FPL and FCAIC pages into definition lists - good advice 18:56:52 #link https://screenshots.firefox.com/GYT6WlB23xl159OZ/docs.stg.fedoraproject.org 18:59:27 #link https://docs.stg.fedoraproject.org/fedora-project/subprojects/mindshare/docs/contribute/first-steps.html 19:00:43 #info New breadcrumbs: Should be more intuitive and make more sense, thanks to ryanlerch 19:01:27 Oh, zodbot died… 19:01:44 I hope that didn't kill our meeting 19:02:41 Oh, I know how to check 19:02:42 #chair 19:02:42 Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch sassam sumantro x3mboy zoglesby 19:02:50 Sorry for the ping, all is good 19:05:01 #help As part of the docs writing guidelines, anyone writing about proprietary / patented software should include the header / disclaimer about using software in a way that doesn't trigger lawsuits – so always include them when needed 19:07:23 #info CONTEXT: quick-docs were hand-selected wiki pages based off the top search results from various search engines pointing to the Fedora wiki – they were high priority pages to migrate from the wiki into documentation 19:08:06 #info x3mboy: Worked on "Installing Spotify" article in quick-docs 19:08:07 #link https://docs.stg.fedoraproject.org/quick-docs/en-US/installing-spotify.html 19:09:24 #info x3mboy: Also worked on Mindshare page, moving from wiki to docs 19:09:27 .thank x3mboy 19:10:11 #info === langdon === 19:10:16 #info Wrote docs on Modularity 19:10:52 #link https://docs.stg.fedoraproject.org/fedora-project/subprojects/fesco/en-US/index.html 19:11:31 #help Need way to guide people to move their sub-project docs to the docs site now that we have some solid examples here (e.g. "I'm the Ruby SIG and how do I get my docs here?") 19:12:02 #info New AsciiBinder changes by langdon are on GitHub, in progress to get them upstream 19:12:52 and incomplete atm... pushed a commit to make sure I didn't lose anything 19:16:26 #idea Mouseover icon (bug): Button to report bug or make PR; on mouseover, expanding to "report a bug" for an issue or "improve this page" to link to source file 19:17:03 #info === ryanlerch === 19:18:10 #info before: https://docs.fedoraproject.org/f27/release-notes/sysadmin/Installation.html 19:18:16 #info after: https://docs.stg.fedoraproject.org/f27/release-notes/sysadmin/Installation.html 19:18:57 #link https://screenshots.firefox.com/jiSpNGi3NQWj8imQ/docs.fedoraproject.org 19:19:03 #link https://screenshots.firefox.com/qLXBbv26GMbqaMYo/docs.stg.fedoraproject.org 19:19:05 .thank ryanlerch 19:19:09 .ping 19:19:11 zodbot?? 19:20:38 #info === mayorga === 19:20:53 #info Modernization of GPG quick-doc, but not yet merged (needs review) 19:20:56 jwf thinks x3mboy is awesome and is happy they are helping! (Please don't forget to x3mboy++ also) 19:21:21 #link https://pagure.io/fedora-docs/quick-docs/pull-request/34 19:21:51 #link http://fedora-docs-quick-docs-pr34-fedora-docs.apps.ci.centos.org/quick-docs/en-US/create-gpg-keys.html 19:21:57 .thank mayorga 19:21:58 Nice work! 19:22:40 #info Also worked on packaging the vale linter that came up earlier at the start of the FAD; some dependencies, but hope to have done and ready soon 19:23:06 #info GPG document was a modular workflow; mayorga thought it made a lot of sense because you could modify a small section and not interfere with the whole document 19:23:10 #idea More organized way to work 19:24:34 jwf thinks ryanlerch is awesome and is happy they are helping! (Please don't forget to ryanlerch++ also) 19:24:37 pong 19:24:39 Wow, these are nifty, I didn't realize this was how this PR was reviewed 19:25:15 jwf thinks mayorga is awesome and is happy they are helping! (Please don't forget to mayorga++ also) 19:27:11 <> 19:28:17 #info Shout-out to sassam++ for modernizing docs by testing the instructions / commands as he went and wrote docs! 19:28:17 jwf: Karma for sassam changed to 1 (for the f27 release cycle): https://badges.fedoraproject.org/tags/cookie/any 19:28:59 #info === asamalik === 19:29:14 #info Lot of work to pair the updated modularity docs with the Modularity web experience 19:30:26 #link https://asamalik.fedorapeople.org/mod/ 19:30:34 #info Will be live on Modularity website in a few days 19:32:29 #info === jwf === 19:32:50 #info jwf works on the CommOps documentation 19:35:09 langdon++ 19:35:09 tuesday: Karma for langdon changed to 5 (for the f27 release cycle): https://badges.fedoraproject.org/tags/cookie/any 19:36:31 #topic In conclusion 19:36:41 #info Thanks everyone for coming out to the Docs Fad 2018! Let's keep the momentum rolling past the FAD. 19:36:43 #endmeeting