15:33:49 <pbokoc> #startmeeting Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings
15:33:49 <zodbot> Meeting started Wed Jul 25 15:33:49 2018 UTC.
15:33:49 <zodbot> This meeting is logged and archived in a public location.
15:33:49 <zodbot> The chair is pbokoc. Information about MeetBot at http://wiki.debian.org/MeetBot.
15:33:49 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
15:33:49 <zodbot> The meeting name has been set to 'docs_project_meeting_-_agenda:_https://fedoraproject.org/wiki/docs_project_meetings'
15:34:00 <pbokoc> #meetingname Fedora Docs
15:34:00 <zodbot> The meeting name has been set to 'fedora_docs'
15:34:26 <pbokoc> #chair bexelbie asamalik
15:34:26 <zodbot> Current chairs: asamalik bexelbie pbokoc
15:34:31 <pbokoc> #topic Roll Call
15:34:36 <pbokoc> a little bit late, sorry
15:34:41 <asamalik> .hello2
15:34:42 <zodbot> asamalik: asamalik 'Adam Samalik' <asamalik@redhat.com>
15:34:50 * asamalik needs 3 mins, brb
15:36:04 <pbokoc> aaand I started it in the wrong channel, hahahaha
15:37:10 * asamalik is back
15:37:36 <asamalik> pbokoc: wanna move it?
15:37:50 <pbokoc> asamalik, I don't think it matters, let's keep it here
15:37:58 <pbokoc> #topic Antora migration
15:38:27 <pbokoc> any news on that? Did anything explode yet?
15:38:52 <asamalik> pbokoc: sure
15:39:37 <asamalik> I've contacted all groups that contribute to the docs today about the migration that happens this weekend
15:39:46 <asamalik> this is tracked in an epic: https://taiga.fedorainfracloud.org/project/asamalik-antora-for-docs/epic/58
15:40:18 <pbokoc> nice
15:40:20 <asamalik> Haven't received any negative response or concerns
15:40:39 <asamalik> all the repos with sources we use today have an issue opened
15:41:19 <asamalik> I've also emailed those groups on their mailing lists (if any) + also their primary contacts (these are in the cards in that epic above)
15:42:15 <asamalik> We have a freeze starting this Friday
15:42:42 <asamalik> bexelbie and I are planning to do the content conversions for everyone and send them a PR
15:43:51 <pbokoc> ok, that's good. So everyone has been told about the move and there shouldn't be any surprises for anyone involved
15:43:54 <asamalik> and I'm saying conversions... that's probably a bit strong word... it's still asciidoc, only the structure will be slightly different
15:44:03 <asamalik> pbokoc: that's right
15:44:42 <asamalik> also, I've made a template with the structure https://pagure.io/fedora-docs/template/branch/antora
15:44:49 <asamalik> very easy to build for preview, too
15:44:53 <pbokoc> I'm wondering how we want to publish the contributor docs. It doesn't make much sense to put them up before the move. I mean, it does in case anyone wants to read up on it in advance but let's face it, who's going to do that? :)
15:45:33 <asamalik> pbokoc: we could publish that on staging
15:45:44 <asamalik> so anyone could look + it would be ready when we switch
15:45:52 <asamalik> pbokoc: do you have anything already? do you need help?
15:47:29 <pbokoc> asamalik, oh yeah, that sounds good. I don't have anything yet but I'll have at least some very basic overview by Friday
15:47:50 <pbokoc> regarding help, I don't know of anything yet. I'll have to ping you if I run into something I can't figure out
15:48:03 <pbokoc> unfortunately this week has been crazy so I'm behind
15:48:48 <asamalik> pbokoc: cool
15:49:05 <asamalik> pbokoc: feel free to ping me any time.. you can also start with that template so it's easier for you
15:49:21 <pbokoc> yeah, that's the plan
15:49:24 <pbokoc> thanks :)
15:49:44 <asamalik> pbokoc: yw!
15:50:16 <asamalik> also, I'll do my best to be available and responsive during the freeze, so people can ask questions
15:51:58 <pbokoc> yeah, that would be nice
15:52:02 <pbokoc> I can see the questions now
15:52:20 <pbokoc> "what freeze? What did you do to my repo? What's that PR about? What's an antora?" :D
15:52:30 <asamalik> pbokoc: maybe we could do a FAQ?
15:52:59 <asamalik> pbokoc: in the contributor space you're about to start writing
15:53:13 <pbokoc> asamalik, we already have the issue in each repo. It's probably not the 1st place people will look, but neither is the contributor space so I'm not sure that's going to help
15:53:19 <pbokoc> I can throw something together I suppose
15:55:00 <asamalik> pbokoc: I can easily update each issue with a link
15:55:09 <asamalik> so that shouldn't be a problem
15:56:14 <pbokoc> asamalik, well, I'm going to base the FAQ on the issues anyway so it's going to be like a sheet of paper that says "turn over" on both sides :D
15:57:31 <pbokoc> anyway, I have to run soon. Is there anything else we need to cover?
15:58:03 <asamalik> pbokoc: there is also an issue for some time in the builder repo: https://pagure.io/fedora-docs/docs-fp-o/issue/77 —so we could use that as the main one, for all the updates form our side
15:58:33 <asamalik> pbokoc: I also have a quick update about the CI builder image
15:58:52 <pbokoc> asamalik, alright
15:58:55 <pbokoc> go on :)
15:59:08 <asamalik> pbokoc: also, do you wanna #info something about the transition?
15:59:33 <pbokoc> yeah sure
15:59:38 <asamalik> I'll try
16:00:36 <asamalik> proposed #info: The Antora transition is happening this weekend. We have a freeze starting this Friday during which we're going to convert all source repos to a new structure. Every repository has an issue opened, this is tracked in: https://taiga.fedorainfracloud.org/project/asamalik-antora-for-docs/epic/58
16:00:59 <asamalik> ah, I haven't mentioned the PR
16:01:19 <asamalik> proposed #info: The Antora transition is happening this weekend. We have a freeze starting this Friday during which we're going to convert all source repos to a new structure. We will send a PR to every repo. Every repository has an issue opened, this is tracked in: https://taiga.fedorainfracloud.org/project/asamalik-antora-for-docs/epic/58
16:01:41 <pbokoc> asamalik, sounds good, just #info it :)
16:01:45 <asamalik> #info: The Antora transition is happening this weekend. We have a freeze starting this Friday during which we're going to convert all source repos to a new structure. We will send a PR to every repo. Every repository has an issue opened, this is tracked in: https://taiga.fedorainfracloud.org/project/asamalik-antora-for-docs/epic/58
16:02:01 <pbokoc> awesome
16:02:10 <pbokoc> ok, and what did you want to say about the CI builder image?
16:02:28 <asamalik> ah, right
16:03:01 <asamalik> I've finally made an image that can build the whole site. PR functionality still needs to be added. It lives here: https://pagure.io/fork/asamalik/aquedoc
16:03:28 <asamalik> I've run into some issues with the nodejs package which have been resolved yesterday
16:04:24 <asamalik> I don't think I'll have time to add the PR functionality this week, and I'm out almost all next week (will be here for the transition though)
16:04:27 <asamalik> I think that's it
16:04:42 <pbokoc> niiiice! that's really good
16:04:52 <pbokoc> asamalik, info that too :D
16:05:38 <asamalik> #info: We have a functional s2i image for the CI that builds the whole site. PR functionality still needs to be added. It lives here: https://pagure.io/fork/asamalik/aquedoc
16:05:51 <pbokoc> awesome
16:06:01 <asamalik> and I think that's all I have for today
16:06:10 <pbokoc> alright then, thanks for the updates!
16:06:23 <pbokoc> #endmeeting