Ceph Docubetter, 13 Nov 2019

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: 2019-11-13:: Ceph DocUBetter Meeting

Description

.

A

B

Hey, can you hear me.

A

C

B

Yeah: hey: how many people are we gonna buy? How many people do you guys think we're gonna have I, don't.

D

B

Says all right: well, I, guess I'll give everybody like two more minutes and then we'll go. That's.

D

B

They can watch the video yeah if, if I'm gonna be running the meetings, I will keep the formal talking or the formal part of the meeting as short as possible. For, however long I'm running the meetings, I.

B

Can't send any email to this stuff dev list as it turns out I, don't know who to talk to you about that. But okay, yeah I sent an email and it just it awaited moderation. But I did the agenda is on the on the ether pad.

A

B

I, that's a good question. Maybe maybe not I've heard a lot of stuff. So all right, let me write this down.

B

In 30 seconds, I'm going.

B

All right, I'm gonna go, my name is Zach. Dover I have been hired as the staff Docs writer I've been I, guess we first talked in early September, I, suppose and then maybe mid-september, and the contract says like last day of October or first day of November. So that's how long I've been I've been working on stuff, I I'm, originally from the US I've lived in Australia for the last eight years, I read a lot I cook a lot right now.

B

I'm reading, Doctor Faustus by Tomas maan I, also read a lot of Ben 20th century science fiction. Originally I was looking for misogyny in mid twentieth century science fiction. That turns out that it was different than I thought. It was a lot of chauvinism and not so much straight up like hatred of women as like, like women, would always come into these sci-fi stories with like cigarettes and tea, and then they would leave and.

B

Although the best science fiction story, I know of enter season, is a story from 1946 written by Christine Moore. So that's where my hobbies is reading science fiction, I read a lot I mess around with computer networking stuff and I write stuff. That's my introduction to me, and there are three items on the agenda that I want to discuss. One is rst.

B

The next is what I'm doing right now, which is the getting started guide. The crisp getting started, guide phrase that page used back in September and they I use it again. So I think crisp is crisp. Getting started guide is good and then just the open discussion. So in the meeting that we had yesterday, we were discussing we wanted to continue using rst and what do you guys think.

C

That's really reason to change I.

B

Don't think so I and that so this might seem sort of ridiculous for me to bring something up and then say now, but we discussed. Maybe somebody has some objection and this would be a good time to voice it since there's a change but I have I think it would be a lot of work to refactor it in something else, but we thought we would. You know, ask if anybody had any preferences all.

A

Right I'm gonna have to file ways forward small complaints.

B

About idle for.

A

Mostly it's you know, I think it's just a little hard difficult to get started with it and watch.

D

A

Options are supported is a little confusing and we've got some especially recently. We've had to make some interesting hacks to get it to do what we want. For example, one of the things I asked one of my developers to do was find a way to remove a redundant table contents on the surface s index page.

D

A

Was two basically two table of contents on the same page, there's one on the Left, which is standard for all the pages and then there's one on the bottom of the index, where you had to explicitly list out everything you wanted to link to in order for it to show up on the left side, the left side table of contents, but we ended up doing.

A

Was we had a out of an HTML comment in the index page so that the table of contents is not listed at the bottom, but it still shows up on the left, because the rsd.

A

Document processing program still sees the the links and then adds to the left side table of contents, two cute hack, but you know that I think that's fairly typical for the types of things we have to do to get it to work with. That said, I'm not tongue, all about us changing it I'm, just you know, I just thought: I'd bring it up as something we could potentially which prom to some newer technology. Although I had no suggestions in that regard,.

B

C

Have a list of.

B

Things like that yeah, that's what I would think you have a list of these table of content like anything like that, as long as we have a list of like pitfalls, I think that's, probably lower cost and better than changing to another other language.

A

Nothing else, I.

B

Don't like the way that the yeah okay I've got that down in.

D

General I I, don't really have an opinion, but I don't think that's the most pressing thing for us to fix right now, I do understand what, where you're, coming from that? If we have to make a change, we rather make it early, but I think that's not the biggest problem for us right now. So maybe we should not invest so much effort into that. As Patrick pointed out. If there are things that do not work, fine, let's just list those and see what alternatives we have. There.

B

D

This might be the last.

B

Time yeah, we probably won't talk about it again, okay, so the the main thing is: I am working on the getting started guide and since I am I have slept recently and I have a clearer mind. I'm gonna spend the next, however long I'm awake installing a cluster and then getting the getting started guide as user-friendly as I. Possibly can right.

B

Now the this is the the installation, the stuff daemon installation procedure, that's Doc's, F comm, Doc's master bootstrap and the very first thing that I'm gonna do with it is a Tim prompt information to make it clear which context man's are sent from I still have set up a cluster myself, though I still have all the ignorance necessary to be critical of the of the guide as it stands, but my hope is that I will no longer have that ignorant in ten hours, I talked to Brad Brad and I Brad, Hubbard and I had lunch yesterday, and it turns out that we know a bunch of the same people which small world we worked with the same people for years so and he lives like in a neighborhood right down the street from Jamie Bainbridge.

B

So how about that? um But uh Brad has told me if I run into any problem at any time. I can call him so I expect the getting started guide to go as smoothly as it possibly can.

B

So that's what I'm doing I'm hoping to have it finished by a week from 12 hours ago, though, by my Wednesday morning, I'm hoping to be able to say like there, it is there's the getting started guide that can be handed to like a furious 16 year old in a basement somewhere in Ohio and then, if they want to get stuff, it's a fluster up and running. All they have to know is how to get to a command line and how to type- and so my hope is Wednesday.

B

And then it's ready for you guys to vet. And then it's ready to go out into the world and.

B

Then the only the fourth item so we're that's three or four things on the agenda or the fourth item is open discussion. So what do you guys think we should like I should be working on what sort of doc stuff do we need to address I.

D

Don't know what others think that is another thing. The hardware recommendations page that came up earlier as well needs updates.

D

Once we have the installation sorted out, maybe okay, so I have another person from my team will be working on the OS recommendations, page as well so mmm I'll, let you know who that person is and then you can sync up with her. But then these are the two immediate things that I'm thinking I can be locked out. Next.

B

Ok, I'm sorry, you're you're cutting out a lot and they have so one is hardware recommendations and what's the second one, the.

D

Other one is soft: the OS recommendations I'll be.

B

Ok sure and do we have updated hardware and software recommendations yet, or is this just a proposal? This is just something to be aware of. Okay,.

C

D

Yeah, we need to update this, so that's yeah.

C

I have a feeling we need to like revisit what we want the scope of these recommendations to be to because they're, really old and like the things that we're talking about, may or may not be wrong.

C

But it's like a lot of many many pages of information here that talk about like gigabit networks and, oh, my god, yeah it's so out of date. So.

B

The way that I'm approaching it is I bought three of these things. I can't even see myself because I have to chat up about three of these knocks and they're getting as well. Two of em are sitting in a stack next to my TV over there and the door of 30 is going on them and then I'm going to set up a basic cluster. Three things so I assume it will work with the like. With the cheapest nuts you can buy.

B

Yeah I mean there's nothing fancy here, it's it's 8 gigs in each of them and 120 gigs of hard drive, but I I, don't know. My suggestion is that we like I'll, write I'll go through this I'll, get the procedure working and then I'll just make a list of like here's, how I built a very basic one, and then we can do more enterprise-e lists as well. That would be my suggestion, or at least that's what's useful to me.

B

I, don't know if I don't know sage if you're courting like Lichtenstein or something, maybe they don't want to run their deaf cluster on Knox.

B

But you'll have to tell me yeah, okay,.

C

Yeah, okay, yeah I mean just skimming these documents. There's like us, there's a ton of just out of date, information but also like when we should just have a discussion on each one when we get to that point and talk about what we should, what the scope of recommendation should be I think.

C

C

B

So that's all I've got for right now. Oh I do remember, there's also this flagging old docks with this. With this update, that's been pushed by the guy with the really name anything to his name. You.

D

B

Talking about um I will we will discuss that next week when I have some idea of what I'm talking about.

D

Yeah I mean that's, got to do with the labeling of the right versions and outdated versions and navigation stuff. So yeah, that's the other thing. I wanted to bring up yeah.

B

Okay, so we're sixteen minutes into a thirty minute slot. The agenda is my agendas complete I'll summarize what I've got here.

C

I mean: are we still talking about other gaps and wishes that a couple items to you? Yes,.

B

C

Absolutely sage Gary, so the other is um you're working on the getting started guide right now, but I think also just the landing page might be a good place. Also, where are we just taking a fresh look at like the first page you land at when you go to the docks like? What do we want to see there? What should be the top level items like Quick Start? How it work?

C

I, don't know what it whatever it is, but I think that's, that's probably worth revisiting the thing that Sarah's pretty old um and then the other thing is the template that we are using right now.

C

My recollection is that this was one of the generics things templates that TV fiddled with like eight years ago, and he just picked one that looked okay and then he went and changed the CSS so that it used the stuff colors, but otherwise it's like yeah generic thing, but it and it sucks, like I'd I, noticed that periodically all the headings are like just really awkward and hard to figure out. What's a low-level heading, what's the high level heading and so on.

C

So like a pull request, I entered that has like two or three and different levels for and a couple charts like a super simple page comes out just looking really weird, like here's. The sample render I.

B

Find it hard to navigate when, when we added the community calendar to the to the page, I could find it. You know on the command line, no problem using, find and then votes, but like they, they command-line utility, find, but then I thought.

C

It was intensive under.

B

The oh yeah yeah a little contents and it took me a guy I had to calm myself down and like, like okay item one. No, it's not here item two. No, it's not gonna just like go down.

C

B

It yeah that that sucked yeah.

C

All right so there's organization, but also just the template headings like on this one top heading. You don't see it, but the second level heading is super bright and that's. Your little heading is like really subtle and like a small font, it's just like weird but I.

C

If you're looking for a distraction or bored or something I wonder if it would make sense just to like browse some of the Sphinx templates that are out there and just pick one that like looks okay and then we can sure and a half hour changing the colors so that it looks stuffy and then just plop it in and it'll probably Annette Annette improvement.

B

Okay, I'll do that, if you, you know I'm going to tell you what to do is you're. It's it's your your project, but if you see something that you particularly like, let me know I'm not looking in the wrong in the wrong direction: okay, alright! So Sphynx template updating! That's added to my my agenda. I'll, send out an email saying what we talked about or I'll add it to the I'll added to etherpad, and nobody wants an email that they're not nervous anything else. I.

C

Think those are the main.

C

D

Mr. Lee was about the story: Patrick I want to talk about the website, go.

A

D

So we we talked about this earlier as well: the calendar in the website, the community calendar, adding the community area in the website and also the landing page of the website. Like that's another thing that needs to be looked at, what what are the five things that should be there or like one of the most important things that should be there and for that you'll just need I. Think Greg told me about it. Some access to WordPress I think about press account.

D

C

Calendar is on the website already help image. The website is just oh yeah, we're gonna hard to find anything, mm-hmm I, wonder if we should separate out the website into a separate discussion because there's a separate mmm thread where there's a couple of people from sue.

C

So if we want to work on the website and okay, just general is just to just update it and that the thinking is to get away from what WordPress and move to a static site generator thing so that the site will actually just be in github and people can submit requests and so on so I think. The hope is to find a contractor. Just go. Go to that initial conversion and then it'll be a lot easier to maintain.

A

I just thought: I'd bring up since we're talking about adjusting the documentation for the main pages that the user sees when they look at the Seb Doc's. Are we happy with the current landing page for the documentation? That is a chat. The welcome to draft page I'm, not I, think.

C

B

A

We already talked about like.

B

That that's one of the yeah like three, it's decision, I'm, the I hope this doesn't seem like I'm being mean, but yeah yeah like this. This is the the third mention of it in this. In this meeting and like almost every meeting that I've attended in the two weeks, I've been with it, the landing pages come up study.

A

B

I would I would describe the response.

B

Well, I've got landing page written down here. Twice it yeah, but okay.

A

B

One right, the the one here that, where it just says, uniquely, delivers object, block and file storage in one unified system and then there's nothing. You can click on, except for redirects to explaining what object, block and file is yeah that that should be different. Yeah.

C

A

Maybe do that after.

C

As soon as you're done with it getting started, that's probably the top priority I would say is probably doing this yep nice link. Is it getting started.

B

A

B

A

Would like to bring up there's something to be said about pictures and I think that would be a great thing to put on the landing page, a picture of not a cephalopod, but um some new modern picture of the cluster that adequately communicates what stuff does.

A

So that's something we should start thinking about.

D

There are a bunch of good pictures in the intro to chef doctor that you would done sage the slide deck that you have created.

B

I've got that written down. Patrick is keen to have a picture on the landing page.

B

Alright and that's it for me guys, I'm I got what I needed out of the meeting.

B

We got. Six minutes left anything else. Oh.

B

Okay, I'm seeing I'm seeing now shaking head so I'm going to assume that's it. Oh yeah meeting over thanks everybody for showing up Thanks yeah. All right. You guys.