IPFS Documentation and Developer UX Task Force, 24 Feb 2020

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: IPFS Docs & Developer UX Weekly Sync 2020-02-24

Description

Learn more about the work of the IPFS Docs & Developer UX Working Group and how to join our weekly syncs: https://github.com/ipfs/docs

For more information on IPFS
- visit the project website: https://ipfs.io
- or follow IPFS on Twitter: https://twitter.com/IPFS

Sign up to get IPFS news, including releases, ecosystem updates, and community announcements in your inbox, each Tuesday: http://eepurl.com/gL2Pi5

A

Are you a consent message?

A

I'm gonna, try, alright, hello, everybody and welcome to this week's IP fest documentation and develop your user experience weekly meeting I am your unofficial host for the week standing in for Johnny who has just joined us. You can find out more about anything that we are doing in the docs working group at IP, good hub, comm, /, IP, fest Doc's, including notes on how to read the meeting notes for this call, and how do you find future calls today?

A

We are welcoming Eric's case to discuss what you're working on so Johnny just to catch you up, Eric's working on gateway, sock eta for the first draft sometime this week, I had suggested just because we have the it's a little hard with how we have the repo set up just a push it as a net new PR, with a prefix of like WIP, so that we can review what he's got later on this, because he can't he can't push against the existing document as it is, which I can't.

B

Make a branch on your repo that has my work in progress and that's.

C

Fine yeah, that makes more sense than just to do at the office and.

A

Then we can discuss the PR probably want to have some folks review. It we're a little bit closer to the gateways just for details, mm-hmm anning.

B

It's issue: 93 was.

A

Yeah one other thing that we might want to add later. There was some talk in sync meeting last week, just about gateways and scale and using the public gateway and discouraging folks from using the public gateway. It past a certain point of scale because like make your own gateway right, so that might be something that we want and we might want to end up adding some content on. But let's defer that until all right we see your first batch.

A

B

And if there's other stuff that you come across feel free to shove, me a pointer and I'll figure out how best to fold it in.

A

Any other questions you have that good.

B

A

Let's see just trying to find issue I.

A

B

It up in the first line, uh yeah.

A

Johnny, are you in the notes, as well I'll come to you just in case yeah.

C

Could you put them in the chat I'm on a new laptop today? So that's why I see ah hey I like zoom wasn't installed, slack wasn't installed. It takes like.

A

Today is this finale just to get your moment like I knew it dude who, who had I, don't know the details of how he set this up, but he'd he'd hosted somewhere all of the artifacts that he need and like a disk image that he could just basically install his dem environment from scratch on any laptop which he was using cuz. He kept going.

A

He was looking for a job and he was going into all of these like technical interviews, where they give him a laptop he'd, never seen before and asked him to code, something and like he would just get so flummoxed by not being admired that he was used to mm-hmm.

B

A

You rolled this thing and that ended up like getting it before the coding exercise. That's.

C

A

C

Mean one day's time I like Bashaw, see on some server, so I can just W get it down and everything I'm on book, yeah running Windows at the moment. It's it's an absolute mat like we're.

A

You, and why are you in Windows, because.

C

My other loves I'll tell you later.

A

B

Know a guy who did something very similar to that and all this stuff for his environment. He kept him on an encrypted live strike because he traveled to China all the time and every time he went to China, he started with a virgin machine.

A

B

Until he got into the border put up the environment that he needed wiped the machine before he left no.

A

That's a very real thing: I am like just running through the agenda here, so we've also got a few outstanding. Prs I know Johnny. These are probably on your radar, but we should get back to their respective contributors.

A

Asap on these yeah.

C

So let me just pull up the.

A

Three PR right now.

C

Okay cool, so the there's an update from the bit swap here and the chap who's doing that is currently away. Yeah.

A

Yeah he said he would look at stuff, but he might not do a whole bunch. Yeah.

C

Exactly but just as long as that gets done, probably like in the next couple of weeks, you'll be fine. There's a few more things. I wanted to add into that PR I'm gonna speed, probably just make comments within the PR itself, so it's a bit more visible, yeah.

C

Well, as far as the best hope on is going. That looks good to me.

A

Okay yeah, so there's two there's two outstanding PRS from angle: a about one's on bit, swap the other yeah.

C

A

Also Leon's got there's some outstanding, so family owns IP, LD yeah.

C

That should be ready to merge and I had a chat with pizza or patter figure on how he pronounces his name. Last week, just regarding the IP LD stuff, he was like I guess the the eye peeled the expert, and you just had some changes so I've spoken to Leon, send him a quick email of all those change to going again, but they should be good to go I believe just because the issue with it wasn't the patent changes like the work that you've done was bother.

C

Anything it's just that there was a lot of stuff that he's gathered from the documentation from other places. It isn't strictly true, because I feel the like. It's still very much in like the early stages, so things like it was mentioned in modes of different videos and stuff, like that, the linking between, like the hash of a Bitcoin transaction and then the hash of like a get Camillo, something like that could be possible throughout the early. Yes, that is possible, but like right now, it's not just because the observer isn't there and I build these.

C

So we discussed the idea of having it. Instead of like an example, this is what you can do with I. Peeled is gonna, be more of like this is what you will be able to do with I think if that makes sense,.

A

Okay, so the aim is to get that merge sometime this week.

C

Yeah and that's couple of days, I would imagine yeah.

A

Looks like and then notes here, I wasn't really prepared to leave this meeting things that are new since last week, your home page refactoring, you were talk through that a little bit yeah.

C

This was a I guess. This was an issue that got raised back in December and I finally got around to actually doing something about it. Just made a home page, more friendly and just make it like a lot more call to actions and getting users and readers to be able to jump into stuff as soon as they hit the home page. Obviously, you've gone through so you've you've reviewed that VI, which is great thanks a lot for you.

C

You helped their own your copy, editing and things in your design chops me changing the the fun way from 100 to 200 I, think that was I.

A

Didn't look at that in a and.

C

A

Was just in like every face, I, don't know what 200 looks like in your in your dev environment. It's a yeah.

C

I mean I, don't really have designed bones in my body, but it looked. It looks like to me, but again we can. We can change you to other okay.

A

Yeah I mean once once you've got that in somewhere. That's got a preview when we've got the circle, see I previewed. Let me know, I'll take a look at a couple of different browsers. Yeah sounds like there's still like, like two bits of conversation that we need things that we need to discuss in there maybe should table experts closer to this conversation. Yeah.

C

A

How contributor recruitment are there any updates on that? No.

C

Major updates right now is pretty was just me: pinging people being like hey, we've got this work coming up, are you available and just essentially going through that she gave me? Some people are just like not really responding of the people are like I'm not available right now, I've sent our bar like he must about 10 of people. Now, there's a couple of writers in Toronto I met this weekend on chat, so they're really enthusiastic about jumping on board once they finish their current project.

C

They both work at the same place and that's gonna, be ending sort of midway through March, so that'd be great to get them on board and yeah pretty much. That's how that's going okay.

A

I'm, looking at Liz on her board, it looks like.

A

There aren't any new.

A

Aren't any new issues that have been raised from the community automate, spelling and grammar checking I'm gonna, throw that in the icebox since yeah.

C

That's probably fun, that's gonna get.

A

C

Yeah, that's gonna be so we talked about doing automation and things like that in probably q2 of this year. So that would didn't that whole task would involve API automation and things like that, which then involves the JSI button. Yeah.

A

C

They've been all being bundled into one quarter, but yeah so throw them in there and.

A

Then contributor guidelines and reference materials- these are not, except for the co persona right, yeah.

C

And the reason the coke son is not done is because I'm still reaching out to Mary so on the go ipfs team JSF the first team to get their ideas of what they think a large project should be like what what it should be based around like kind of features. They want to kind of show off with ipfs and very stiff things like that. So that's like a Bevin description there right now, I was actually considering using the new discussion beta the github released.

C

Recently it's what you can just have like Stack Overflow like discussions, I kind of bring another, because it's not necessarily an issue on its own. This is just I kind of want to flow ideas around and find out what the best code example project would be.

A

C

Exactly because yeah, like a couple of weeks ago, I was thinking- maybe I, open post on our forum and do through that. But since it's already now built into like hope of them, I'll just keep everything self-contained in that and.

A

Also, it's a good at it's.

C

Like test out this beta, you know useful, it is.

A

What else is new I.

C

Don't think so: I've got a new computer and it's on Windows and it's really awful to work with, but yeah by.

A

C

So I was getting aggravated lis annoyed with my macbook, so I got the MacBook Air.

A

C

Model- and it was just it did the job, but when it came to do anything remotely difficult so like spinning I like having to sort of web servers running on your laptop at once, I'm trying to spin up of the just it just couldn't hack it like it runs like an i5 dual core, so it's just is really not powerful enough. So I got this new laptop, which is really good. Well, I've, no, like I, got it yesterday and I'm out time to put a Linux honey or anything like that.

C

Yeah, so that'll be that'll, be a task for this evening. I think.

A

All right, I mean take the time you need, if that's something you need to do today, to get up running it up and running in your own speed. You know by all means, get yourself settled it and that's not something it to do outside of working time.

A

um Do and Eric you're free to leave at any point unless you had any other questions. I appreciate you hanging on this call now.

B

Those I'm always happy to get inside as to what else is happening in the environment. So my hanging around I.

A

Might share my screen real, quick Ron? Yes, you just want to like talk through the rest of the homepage. Read chapter notes, yeah.

C

Yeah show noise.

A

All right, can you see me I, can't.

C

A

Right, it looks like it looks like there were only like two things that didn't get resolved. I wish you could do. This is like not as individual commits cuz I like I got like I got up, I got out of the shower and it was like. Why do I 37 emails.

C

Just like I saw that I was like yeah, that's good.

A

I know it does, it is a separate which is such a pain in the butt which you know is fine. It sounds like the only two things that are outstanding were actually and then this one.

C

Yeah that should be motioning, I, just yeah so mark says resolved, but then I can't I can't now push that Commission like this is a would kill, feature I, don't really know. What's going on really.

A

C

There was the I mean the big one, that kind of stood out like oh you're, committing like really good. Apart from the the use of the word centralized yeah I mean to me, it has like blockchain and crypto conversations, and it's not really a word that regular people really use when.

A

C

I didn't like blockchain world. It was like what you mean, centralized I've ever heard of this before right.

A

What about like, let's see, cuz we're, also saying break free from centralization and I think that's.

C

A

No, this is not. This is different.

A

C

I don't really mind using the word centralization I. Guess it's not too terrible as long as we very strictly defined what we mean by it. So like the idea of having like a central server that controls everything or a central company that controls everything but I feel that there's a easier way to say that it's just I'm, not sure.

A

C

Since I don't really have any other ideas, we can. We can merge this in for now and then maybe over the next week or so I'll get like a spark of inspiration and be like.

A

C

Call it something else so.

A

Are you just thinking? Are you just thinking break free from centralization? Is that what is that the phrase that you're not yeah, yeah.

C

Essentially, like everything up to that point, so Paul the movements agree, the next generation of the Internet. Definitely fine, that's great, but it's just a break. Free from centralization also reminds me that Freddie Mercury song.

A

I mean why don't we just say: I mean why don't why don't we just say the next generation of the Internet I mean I'd, be totally happy getting rid of the centralization language entirely. I! Think that's from like a first second paragraph perspective. I think, that's really all you need to know. Yeah.

C

Cool I mean talking about centralizing, there's, definitely something we need to address within somewhere within the docs. It's like a it's, a major part of what ipfs is fixing but yeah. Maybe it just doesn't need to be like right at the top, because it's just that to me it's another. It's another buzzword. The the crypto community, really loves to jump on top of it's already too many, too many buzzwords and watching all.

A

Right should I just merge that in yeah.

C

Yeah good lobby, brilliant.

A

It's gotta make a whole other.

A

C

You go to the bottom. Is that like another thing, oh they so change is approved. So I guess it's all going through enough. Yeah.

A

I think that is.

C

A

For this Oh host a static website on our qfs can I just say: host your website and IP us, because yeah yeah.

C

That's fine: why did I not see that one see it hi, some of them I, don't know what 43.

A

Individual commits comments, because that's how code reviews work and github and then you end up with like 50 little windows yeah. This.

C

Was like one of the we had a chat with some people at love week and people were so upset about just like code reviews and how get love does it so much bad, but I'm not gonna, get into no.

A

It's all good, all right, so I'm just gonna see let me I'm gonna watch the circle, see I, build this thing and let's see how the font way it looks but talk to Chris because he will bust your chops for inline styles, I.

C

Talked about a couple of things, I guess he's got his head into the other right.

A

Now I think it'll work for now, but I think there may just be I think if we're gonna we're gonna, throw like a subhead style anywhere else like like. If we like that style looks like actually turn it into like an actual, but.

C

I can just that's.

A

Like something yeah.

C

I completely agree because the yeah just something I kind of want to throw until, like the I guess, the top level index page of each section just be like hey. This is what this urchins about the top bits of bold, oh yeah,.

C

Cool but yeah like yeah, inline style, there's a the seventh circle of hell is reserved for.

A

People who just display:none stuff.

C

Use implosion plugs at the end of other code, yeah.

A

Really yeah yeah I've done that before yeah all righty. um Eventually, this will run incest, I'm gonna go ahead and stop the recording of this meeting. Since now, we're just watching some bread get baked cool and thank you. Everybody who has joined us I'm gonna, try to stop recording cuz a tryna, stop recording what the what.

A

C

See the little recording.

A

Let's try those now since we're all since we're all here. What does it look like.

C

Yes, sometimes the baby.

B

Screen sharing is preventing.

C

A

Know wait: we've not yeah.

C

It's not showing the IPF first bill.

A

I'm going to stop sharing my screen controller.

A

This is sad you're watching me in a video flail over how to use the zoom okay I'll trouble this bed up.

C

A

Go alright, I'm gonna. Stop the video. Thank you all for joining. We shall see you next week same bat-time same bat-channel under johnny's direction, we'll go from there. Alright. Thank you very much. Alright, video has stopped cool.

C

I can still see your screen, it says, recording her. That's all life, maybe.