fedora_docs
LOGS
09:13:53 <jwf> #startmeeting Fedora Documentation FAD 2018 - Day 5
09:13:53 <zodbot> 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 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
09:13:53 <zodbot> The meeting name has been set to 'fedora_documentation_fad_2018_-_day_5'
09:13:58 <jwf> #meetingname fedora_docs
09:13:58 <zodbot> The meeting name has been set to 'fedora_docs'
09:14:01 <jwf> #topic Hack Time!
09:14:47 <jwf> #chair asamalik[m] bexelbie coremodule cverna jsmith langdon mattdm mayorga ryanlerch sumantro zoglesby
09:14:47 <zodbot> Current chairs: asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga ryanlerch sumantro zoglesby
09:15:07 <jwf> 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 <jwf> Southern_Gentlem: We didn't see your question before we broke for lunch.
09:16:11 <jwf> 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 <jwf> 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 <jwf> 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 <mattdm> good morning everyone
09:23:23 * jwf waves to mattdm
09:23:27 <jwf> #chair asamalik
09:23:27 <zodbot> Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga ryanlerch sumantro zoglesby
09:30:57 <jsmith> 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 <cverna> jsmith: so commit will trigger a build to update the production site
09:32:57 <cverna> jsmith: but looking at the log there was an error. also I am not sure we are actually rebuilding production yet
09:33:14 <jsmith> 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 <cverna> 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 <cverna> something went wrong before triggering the build
09:34:28 <cverna> I am looking at it
09:34:54 <jsmith> Thanks...
09:35:24 <jwf> 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 <bexelbie> mattdm, ^^ please review my comment in the file
09:48:14 <jwf> #chair shaunm rkratky
09:48:14 <zodbot> Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch shaunm sumantro zoglesby
09:48:33 <cverna> 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 <jsmith> cverna: Thanks :-)
10:02:43 <jsmith> 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 <jsmith> cverna: (This is after I committed another change to fedora-docs/documentation-guide
10:03:23 <cverna> jsmith: ok let me look :)
10:05:56 <cverna> so we correctly triggered the build
10:06:21 <cverna> the build is using the builder.sh from https://pagure.io/fedora-docs/docs-fp-o
10:06:59 <cverna> .and I think the documentation guide is not included in this script
10:07:31 <cverna> jsmith: ^^
10:08:39 <coremodule> When someone has a chance to review and pull: https://pagure.io/fedora-docs/quick-docs/pull-request/21#
10:16:11 <jsmith> 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 <jsmith> cverna: Or, in other words, the content that you're building seems to be out of date
10:22:28 <cverna> jsmith: Oh ok I got it :)
10:22:51 <cverna> jsmith: we are rebuilding a for of docs-fp-o
10:23:01 <cverna> https://pagure.io/forks/bstinson/fedora-docs/docs-fp-o.git
10:23:18 <cverna> bstinson's fork is probably not up to date
10:27:47 <cverna> jsmith: is that better http://docs-ci-fedora-docs.apps.ci.centos.org/
10:29:04 <jwf> #chair x3mboy
10:29:04 <zodbot> Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch shaunm sumantro x3mboy zoglesby
10:54:15 <jsmith> 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 <cverna> jsmith: we really only run the builder.sh
10:54:54 <cverna> from fp-docs-o
11:01:08 <jsmith> cverna: OK.  I'll follow up with bexelbie after he finishes his other discussions
11:07:12 <cverna> jsmith: no problem thanks
11:10:02 <sassam> 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 <jwf> 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 <jwf> 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 <jwf> #link https://pagure.io/fedora-docs/quick-docs/pull-request/21
11:25:43 <jwf> #link https://pagure.io/fedora-docs/quick-docs/pull-request/28
11:25:47 <jwf> #link https://pagure.io/fedora-docs/quick-docs/pull-request/31
11:25:53 <jwf> #link https://pagure.io/fedora-docs/quick-docs/pull-request/33
11:26:16 <jwf> And then adding the three PRs sassam wanted review on into the minutes
11:26:28 <jwf> sassam: Oops, I was thinking you were shaunm, my mistake!
11:26:34 <jwf> #unchair shaunm
11:26:34 <zodbot> Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch sumantro x3mboy zoglesby
11:26:36 <jwf> #chair sassam
11:26:36 <zodbot> Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch sassam sumantro x3mboy zoglesby
11:52:20 <jsmith> cverna: Is it possible you're not pulling the latest version of builder.sh?
11:52:48 <jsmith> 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 <jsmith> jwf: Looking at it now
11:57:21 <jwf> jsmith: Thanks!
12:02:13 <cverna> jsmith: might be possible
12:05:33 <cverna> jsmith: yes the s2i image is quite old 8days
12:05:43 <cverna> oh 5days :)
12:06:12 <cverna> we need bstinson to rebuilt it and push it to the registry
12:24:35 <bexelbie> cverna, that image needs to be rebuilt every time there is an update to fedora-docs/docs-fp-o
12:24:40 <bexelbie> master branch
12:27:21 <jwf> 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 <cverna> bexelbie: ok I ll discuss with bstinson how we will do that
12:30:58 <jwf> To be discussed soon™
12:31:04 <jwf> #topic Lunch time!
15:01:51 <mayorga> When someone has a chance to review and pull: https://pagure.io/fedora-docs/quick-docs/pull-request/34
15:09:39 <Southern_Gentlem> 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 <Southern_Gentlem> jwf,  and of course with the forward you cannot get into the wiki to see when and whom set the forward
15:13:01 <jwf> Oops, forgot to change the topic
15:13:06 <jwf> #topic Hack Time! (Round 2)
15:14:44 <jwf> 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 <jwf> Southern_Gentlem: I'm sure this was an intentional move to delete information but an oversight for more recent changes
15:15:46 <jwf> 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 <bstinson> 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 <bstinson> this is the latest commit we built: af004193891b5dad8de1334bbf410462f80be09d
15:16:49 <jsmith> bstinson: Weird -- it wasn't using the latest builder.sh earlier, but seems to be working better now
15:17:08 <jsmith> I'll take a closer look after the FESCo meeting.
15:17:10 <cverna> bstinson: so this is the latest commit
15:21:43 <mattdm> Southern_Gentlem: yeah, sorry, that was my mistake.
15:21:56 <mattdm> that said, if you want to migrate this over to an updated adoc, that'd be _awesome_ :)
15:23:04 <coremodule> 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 <Southern_Gentlem> 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 <mattdm> Southern_Gentlem: yeah, that wasn't the intention -- I just mis-matched the titles
15:24:09 <Southern_Gentlem> mattdm,  if someone could just turn off the redirect it would be very helpful
15:24:19 <mattdm> Southern_Gentlem: oh, already done :)
15:24:40 <mattdm> Southern_Gentlem: ftr it can be removed by going to
15:24:44 <mattdm> https://fedoraproject.org/w/index.php?title=Livemedia-creator-_How_to_create_and_use_a_Live_CD&action=edit
15:24:46 <mattdm> or
15:24:48 <mattdm> https://fedoraproject.org/w/index.php?title=Livemedia-creator-_How_to_create_and_use_a_Live_CD&action=history
15:25:02 <mattdm> nothing is deleted
15:27:30 <Southern_Gentlem> mattdm,  i suspect the livemedia and livecd-creator sites got tagged as the same
15:34:24 <mattdm> 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 <sassam> build-custom-kernel.adoc is ready for review/pull at https://pagure.io/fedora-docs/quick-docs/pull-request/35
16:45:29 <bstinson> cverna, bexelbie: the docs pipeline has a new home: https://pagure.io/aquedoc
16:46:02 <cverna> nice, I like the name :)
16:52:19 <mattdm> bstinson++
16:52:19 <zodbot> mattdm: Karma for bstinson changed to 5 (for the f27 release cycle):  https://badges.fedoraproject.org/tags/cookie/any
16:54:56 <mayorga> bstinson++
16:54:56 <zodbot> mayorga: Karma for bstinson changed to 6 (for the f27 release cycle):  https://badges.fedoraproject.org/tags/cookie/any
16:56:05 <sumantro_> bstinson++
16:56:50 <sumantrom> bstinson++
16:56:50 <zodbot> sumantrom: Karma for bstinson changed to 7 (for the f27 release cycle):  https://badges.fedoraproject.org/tags/cookie/any
17:17:58 <rkratky> https://fedoraproject.org/wiki/How_to_reset_a_root_password
17:49:08 <sassam> coremodule: https://access.redhat.com/solutions/43133
17:57:20 <zoglesby> 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 <zoglesby> I am not saying that it needs done during the FAD, but I wanted to get it on other peoples radar.
18:12:09 <jwf> bstinson++ Thanks for all your help on the CI!
18:12:09 <zodbot> jwf: Karma for bstinson changed to 8 (for the f27 release cycle):  https://badges.fedoraproject.org/tags/cookie/any
18:12:29 <jwf> zoglesby: I'm interested in helping with that
18:12:40 <jwf> zoglesby: Could you file an issue on the Badges repository? https://pagure.io/fedora-badges
18:12:52 <jwf> I think the badges are a good motivator for getting more people on-board with docs
18:12:59 <jwf> So I think we should def get that on the radar too
18:13:29 <jwf> Sadly, the Pagure badges as a whole are broken, but hopefully we can fix those and then update the docs badges
18:13:34 <zoglesby> Yeah, I will do that in a bit
18:13:38 <jwf> Maybe update the names too, from writing beats to pages
18:13:44 <jwf> zoglesby++ Thank you!
18:37:35 <jwf> #topic Wrapping up
18:37:44 <jwf> mattdm speaking now
18:37:52 <jwf> #info Thanks everyone for coming out and working during this week!
18:38:57 <jwf> #link http://etherpad.osuosl.org/fdocs2018
18:39:23 <jwf> #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 <jwf> #info bexelbie is great, but he is no longer able to contribute significantly to documentation
18:40:32 <jwf> #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 <jwf> #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 <jwf> #info ryanlerch made the front page more simple and cleaned up the design
18:42:14 <jwf> #link https://docs.stg.fedoraproject.org/
18:43:11 <jwf> #info mattdm: Spent a lot of time working on the Council Docs repositories, expanded on leadership for Fedora Project
18:43:16 <jwf> #link https://docs.stg.fedoraproject.org/fedora-project/project/leadership.html
18:43:37 <jwf> #link https://docs.stg.fedoraproject.org/fedora-project/project/objectives.html
18:43:58 <jwf> #info Objectives page is expanded with an overview and how to propose one
18:44:13 <jwf> #info Lists current objectives, but that was mostly wiki copypaste
18:44:28 <jwf> #info Most data is intended to be static in the Council Docs with minor changes each release or year
18:45:19 <jwf> #info langdon: Details for Objectives should be more detailed
18:46:25 <jwf> #info rkratky: Better header rendering between Objectives
18:46:56 <jwf> #info mattdm drew a lovely mindmap of the entire Fedora community!
18:47:04 <jwf> #link https://docs.stg.fedoraproject.org/fedora-project/project/orgchart.html
18:47:34 <jwf> #info By itself, hard to read: But a good representation of how the Fedora community is spread apart
18:47:55 <bexelbie> bexelbie> suggestions: make the objectives page in the council more visually distinctive to keep the objectives from bleeding together
18:47:55 <bexelbie> <bexelbie> suggestion: maybe put objectives on the leadership page or reference them from there
18:47:55 <bexelbie> <bexelbie> #info look at the amazing map on the high-level org page :)
18:47:58 <bexelbie> moving to the right meeting
18:48:31 <bexelbie> #info many pages still need work - there is still room for you to contribute
18:48:34 <jwf> #help Council Docs: "Get help!" and "Get involved!" pages need help
18:50:50 <jwf> #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 <jwf> #link https://docs.stg.fedoraproject.org/fedora-project/council/fpl.html
18:51:53 <jwf> #info Goal is to have this info for all Council members
18:53:11 <jwf> #link https://docs.stg.fedoraproject.org/fedora-project/council/fpgm.html Some pages are still unchanged and need love
18:53:58 <jwf> #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 <bexelbie> #info notice how we converted the tables on the FPL and FCAIC pages into definition lists - good advice
18:56:52 <jwf> #link https://screenshots.firefox.com/GYT6WlB23xl159OZ/docs.stg.fedoraproject.org
18:59:27 <jwf> #link https://docs.stg.fedoraproject.org/fedora-project/subprojects/mindshare/docs/contribute/first-steps.html
19:00:43 <jwf> #info New breadcrumbs: Should be more intuitive and make more sense, thanks to ryanlerch
19:01:27 <jwf> Oh, zodbot died…
19:01:44 <jwf> I hope that didn't kill our meeting
19:02:41 <jwf> Oh, I know how to check
19:02:42 <jwf> #chair
19:02:42 <zodbot> Current chairs: asamalik asamalik[m] bexelbie coremodule cverna jsmith jwf langdon mattdm mayorga rkratky ryanlerch sassam sumantro x3mboy zoglesby
19:02:50 <jwf> Sorry for the ping, all is good
19:05:01 <jwf> #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 <jwf> #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 <jwf> #info x3mboy: Worked on "Installing Spotify" article in quick-docs
19:08:07 <jwf> #link https://docs.stg.fedoraproject.org/quick-docs/en-US/installing-spotify.html
19:09:24 <jwf> #info x3mboy: Also worked on Mindshare page, moving from wiki to docs
19:09:27 <jwf> .thank x3mboy
19:10:11 <jwf> #info === langdon ===
19:10:16 <jwf> #info Wrote docs on Modularity
19:10:52 <jwf> #link https://docs.stg.fedoraproject.org/fedora-project/subprojects/fesco/en-US/index.html
19:11:31 <jwf> #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 <jwf> #info New AsciiBinder changes by langdon are on GitHub, in progress to get them upstream
19:12:52 <langdon> and incomplete atm... pushed a commit to make sure I didn't lose anything
19:16:26 <jwf> #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 <jwf> #info === ryanlerch ===
19:18:10 <bexelbie> #info before: https://docs.fedoraproject.org/f27/release-notes/sysadmin/Installation.html
19:18:16 <bexelbie> #info after: https://docs.stg.fedoraproject.org/f27/release-notes/sysadmin/Installation.html
19:18:57 <jwf> #link https://screenshots.firefox.com/jiSpNGi3NQWj8imQ/docs.fedoraproject.org
19:19:03 <jwf> #link https://screenshots.firefox.com/qLXBbv26GMbqaMYo/docs.stg.fedoraproject.org
19:19:05 <jwf> .thank ryanlerch
19:19:09 <jwf> .ping
19:19:11 <jwf> zodbot??
19:20:38 <jwf> #info === mayorga ===
19:20:53 <jwf> #info Modernization of GPG quick-doc, but not yet merged (needs review)
19:20:56 <zodbot> jwf thinks x3mboy is awesome and is happy they are helping! (Please don't forget to x3mboy++ also)
19:21:21 <jwf> #link https://pagure.io/fedora-docs/quick-docs/pull-request/34
19:21:51 <jwf> #link http://fedora-docs-quick-docs-pr34-fedora-docs.apps.ci.centos.org/quick-docs/en-US/create-gpg-keys.html
19:21:57 <jwf> .thank mayorga
19:21:58 <jwf> Nice work!
19:22:40 <jwf> #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 <jwf> #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 <jwf> #idea More organized way to work
19:24:34 <zodbot> jwf thinks ryanlerch is awesome and is happy they are helping! (Please don't forget to ryanlerch++ also)
19:24:37 <zodbot> pong
19:24:39 <jwf> Wow, these are nifty, I didn't realize this was how this PR was reviewed
19:25:15 <zodbot> jwf thinks mayorga is awesome and is happy they are helping! (Please don't forget to mayorga++ also)
19:27:11 <jwf> <<happening now: overview of modular docs and how they work in technical and non-technical>>
19:28:17 <jwf> #info Shout-out to sassam++ for modernizing docs by testing the instructions / commands as he went and wrote docs!
19:28:17 <zodbot> jwf: Karma for sassam changed to 1 (for the f27 release cycle):  https://badges.fedoraproject.org/tags/cookie/any
19:28:59 <jwf> #info === asamalik ===
19:29:14 <jwf> #info Lot of work to pair the updated modularity docs with the Modularity web experience
19:30:26 <jwf> #link https://asamalik.fedorapeople.org/mod/
19:30:34 <jwf> #info Will be live on Modularity website in a few days
19:32:29 <x3mboy> #info === jwf ===
19:32:50 <x3mboy> #info jwf works on the CommOps documentation
19:35:09 <tuesday> langdon++
19:35:09 <zodbot> tuesday: Karma for langdon changed to 5 (for the f27 release cycle):  https://badges.fedoraproject.org/tags/cookie/any
19:36:31 <jwf> #topic In conclusion
19:36:41 <jwf> #info Thanks everyone for coming out to the Docs Fad 2018! Let's keep the momentum rolling past the FAD.
19:36:43 <jwf> #endmeeting