Docs Community Call #9 - near/dev/hub

Captions as YouTube publishes them, usually machine-generated, so product and people names can be misheard.

1. 0:05

   so welcome to another dogs community group call I think we're going to start as usual in which like I should share my screen and we go through what has been done since the last meeting uh so let me here share uh my entire screen I have no secrets for the L community group uh and we are in what day is today I guess this will show me yeah here today perfect uh I something I like about this meeting is that whenever I read what was the last time we did what was the last

2. 0:41

   thing we did and then like I read the new thing I'm like oh okay yeah okay actually did something like we actually did some progress so last time we were talking about like a huge reorganization of docks uh which basically went from like uh making sure that whenever you enter in build and I don't know China abstraction meta like three layers suddenly you have like Bill chain abstraction meta transactions and and like all of the URLs go with like uh the the topic that

3. 1:12

   you're browsing uh this is good for like different reasons and after that that that actually I think that work end up like spanding spanding for like a week more and the newest thing that we did into dogs and this is very nice like I really like it is the introduction of uh this code explainer I think we call it uh which basically like a new way that or or a new tool that we that we created here in House of course like based on like everyone will make everyone that knows is like we knows that this is

4. 1:47

   basically very hardly inspired on Stripes dogs but the whole idea is that we have a new tool um in order to we explain code uh so basically ah we also implemented this high button here so you have more space so the whole idea is that now uh we will have uh the concepts here and we can go explaining them and as we go scrolling it will show you like which parts of the code are actually related to this New Concept uh do I have a lot of background noise by the way I don't know

5. 2:20

   if it's okay it's not that bad let me know if if it gets annoying I can maybe close the door or something no it's like autoc cancelling it out you're good okay perfect so as you can see like this can basically take a concept and explain like okay like so you define the state on a smart contract and it's here and here and then you have to initialize the state and for that you have

6. 2:43

   initialization functions and then you have like a default state that you can also use and then for example if we go to functions uh it will say like okay this is the interface all of these functions are part of the interface and the initial you have initialization function you have state changing functions and you have read only functions and you have private functions and you have payable functions and you have internal

7. 3:08

   functions and this works for both languages like um crust and and and and JavaScript and across different files and someone already like we already pushed the fix for this like that you cannot change files like right now it forces you to look at the file that you are looking so we we have changed this I I I heard someone maybe ra would that be no that was just yeah okay no wor so this was like one of the of

8. 3:41

   the main changes that we did another change that we did that um so I always say right like it's not we we work not like this is Doc groups but it's like for do when we talk about documentation we also generally talk about um resources and examples and tutorials uh so another thing that is that that we recently pushed and actually that was yesterday is a new version of create new app uh so I guess that this is just easier if I just show

9. 4:12

   uh sorry I was working on multi-chain stuff and I have everything here uh TMP create MPX create near app at latest always at the at latest remember and the main thing that would change is that uh when you choose to create a web application now you can choose to if you want to use uh onchain components which some people refer to them as boss components the the blockchain operating

10. 4:42

    system components and now you can choose if you want them or not and if you choose know what is going to happen is that uh let me see I will not install it enter hello near and code here what is going to happen is that you're going to have like a very simple page that does not include any sort of uh most components let me just quickly install it anywh what does it say next command not found ah sorry e

11. 5:13

    install first uh so we like this before used to be like a couple of pages the package.json used to include like using the components has a lot of Boer plate like that's the that's what I was trying to say like using the the the the the components has a lot of buet break you can see that this installed like super fast now and for the people that was just trying to create an application and and and you know like interact with a smart contract without having to use

12. 5:43

    both components uh most of them like were telling me like hey you know like getting rid of all of the part of the components is very annoying so now we did that for for for them uh and this is now available in the newest version of create your app uh so people can choose what to do and this has two good things uh one is like for the users it's going to be better because now they can

13. 6:08

    create applications that they can choose if they want the components or not but also this is very good for us because now we can actually keep track of how important are components for for users um this is a conversation that actually started uh after um the you like you know the people at De have made the the interview with Eugene and he was saying like yeah you know if I have to do this again maybe I will do it in a different way um so yeah we want to track you know like

14. 6:43

    did people actually you know ever catch on like actually using components for their projects or not you know outside of like play playing around uh yeah besides that uh there were as usual like a couple of uh of of improvements to to to to examples all around uh we finished migrating I think almost all of the examples to to the nearest dek 5.1 but by far this was the main like the main thing that we were working for like of this month this mon probably have

15. 7:18

    been like two weeks full time of of of what I was doing like whenever I was you know like working on dogs specifically uh I'm very happy how it ended up uh it's also so it also works on mobile like it will change it structure in order to be uh like the code will be on top and this will be on bottom I think I also already push already like a fix for this like that this is transparent someone else told me and I was like ah yeah yeah I didn't realize that this was

16. 7:51

    just like transparent color because that doesn't allow you to read very well but the thing is that we are 99% there with the small fixes that we just push uh this will be 100% done and we hope it's useful for for people and we will we will wait like because something that you know like the first impulse that one will have is like okay perfect like put it everywhere but actually I want to see what what feedback do we get from the

17. 8:18

    community like was it useful maybe it's not you know many times like it's cool yes but I wanted to be educational you know if it is not cool and educational is way better than being cool and not educational uh so yeah and with that been given we can switch to like a more General discussion if anyone has any questions or anything to say Yes um yeah uh one of the things like one of the poor requests that we had this an effort from one of the

18. 8:55

    contributors under near Dev Hub under your fellowship and this is the regarding the update of the Zero to Hero tutorial uh to what state this is done yeah the the nft Z to Hero tutorial is fully migrated and besides you know like any minor mistake that we might find it should be it should be finish yeah huge kudos to Garrick for like taking full ownership on doing this and like it's honestly incred able like how well

19. 9:31

    things went um very very like well he's not here but you know like I'm um I I already told him like in person and also I think at some point I put it in the chat very happy how did that go because one does not realize like how hard the tutorial is because you have so many steps like let me just share my screen so we are all in the same right like so we know what what we are talking about like so sorry um the reason that I'm asking this is that I think that this would be a

20. 10:02

    very good opportunities for people who are new to the doct or haven't tried uh to run out to this example to actually go through it provide some feedback and let's make it um even better so that's the reason that I asked for yeah I think that that's more that the part of getting feedback generally happens organically uh whenever this is something that that I always I like that the the feedback the the the things that you need to fix

21. 10:32

    they will generally arrive organically because someone will you know try it and find a mistake and then like uh give us feedback or start asking questions through Discord or something like that um so yeah I mean we can always like you know I think when we finish migrating it I made a call saying like hey please everyone try it no one does and I would not want us to end up in a system where we pay people to try our dogs or something like that you know like or like we can encourage them right now

22. 11:07

    we don't have any sort of system to just give them you know like um how do you say like not rewarding points but you know like some sort of reward points that is just like ah you're an amazing Community member that's something that we should work on maybe yeah but anyway like before Contin with that like yeah uh this is fully migrated and this is a lot of work like you just have like one two three four five six seven eight nine pages like a whole Marketplace royalty and and the the

23. 11:42

    smart contract let me see if I find any piece of code because then the code will take us directly to the smart contract mean for example yeah like and this is a huge repository to take into account like a huge one and everything is tested everything was migrated everything was improved we even like change how the marketplace Works uh uh and and like we we had like a few tweaks um this was

24. 12:14

    impressive honestly very very happy with that yeah sorry so uh the question that I had also is like related to because we see that we have an open p for the funable token Z to her as well to do are you familiar to what state this is being migrated as well naturally we completely migrated uh we need someone to review it like so if it is me it's going to take some time for me to sit down and review because I don't know if you saw the P request but

25. 12:48

    it's like it's huge yeah it's pretty big and and the problem is that is like this was also Garrick doing it um the problem is that this is not something that you can migrate you know step by step you need to migrate it all together uh and then someone has to sit down and this takes like the review of the NF tutorial took me two full days almost because it's not just about if you're doing the

26. 13:11

    the the actual review if you're doing a real review you go you look through the code you make sure that the logic is safe it's not just you know seeing that the the the translation from SDK 5 to 5.1 matches I remember that what we will do in the migration of definite 2 tutorial actually we were like we need to change the marketplace because this and that like like this just doesn't work um the thing is that such like you

27. 13:35

    know it's so big that yeah it takes time so in my list of priorities right now it's not super uh what are the current efforts in place in in terms of like reviewing it zero right now uh ah or you mean like what are low hanging fruits or contribution opportunities to docks uh I think that always is always the same like low hanging fruits is following the basic tutorials and make contributions if that doesn't work

28. 14:09

    uh then the next step for docks yeah I can tell you the next step for docks so what we're going to be working on most probably like next month uh we receive like multi chain is going to be released soon I think uh I'm not sure when but I'm quite sure that it's going to be soon and we had reports of like some some minor you know errors in some of the examples that we had and like uh also opinions on how like we could improve the documentation so that's for sure

29. 14:42

    going to be uh one of the main focus points that we have another one and again since docs is not just docs it's also tools we are uh collaborating with frol uh and actually G is sticking on this we're collaborating with frol in order to um bring the two clis together so basically Garrick is taking time to take the the interface of the near CLI and implement it completely in the near

30. 15:13

    CLI RS so the whole idea is that at some point we say near CLI doesn't go anymore like the current one just update to near C RS and every single command works and I was thinking that one way that we can approach this is as saying like Okay the ne CRI are s has like uh like a veros interface an interactive interface right like you can go and be interactive you can put like the whole command in case you are very verbos and you want to be you know very exact on when you want on when you want what you

31. 15:44

    want to run and then you can have like you know the brief version where you just do near call something near view something near at Key something um and at least we will keep it for a time like this uh just because you know like uh you don't want to tell the whole ecosystem to migrate tools that's that's just not a good idea uh besides that Maas is going to be working on updating again the fr the all the front end of the samples right now this is very technical but right now we are

32. 16:16

    sharing uh States across components with something that is called suant and you don't need that to be honest you can just do that out of like a react context uh if anyone has the question of like well why didn't you start with react context from the beginning it's because like the boilet the the template that we use first time somebody had build it and has sstan and then you replicate it everywhere and then at some

33. 16:41

    point you're like why are we using suan if we could just do this and then you know like you take the effort to to to migrate it and yeah that's gonna be Garrick that's gonna be Matias doing all the front end migration and me I just finished with the near CLI so now I have to fix everything from multichain and after that well I have to see how much it takes me the thing of multichain but after that we have to

34. 17:11

    finish migrating all of the pages from the nearest Decay so we consolidate them in one place so hopefully next time we meet I will have the news that both new are now one CLI the three pages for the SDK are now one page and and all of uh and yeah and all of our examples have like a proper frontend yeah that would be amazing um I'm actually working on consolidating or at least suggesting a consolidation of

35. 17:42

    the sdks with the yeah the eror SDK pages so we don't have them in three times and like even to me where I well I pretend well I don't know I say that I'm more or less familiar with the dog sometimes it's very confusing of like searching and what is migr and what's not so I'm quite sure that at the end when we end up with one Consolidated place for like source for dos this would be pretty helpful and like easy for

36. 18:07

    developers in general yeah uh a general idea that I would like to achieve by the end of the year because it's long term is that most of the places are in one like most like there are no there are no pages that how how do you say this in English there are no unnecessary pages in docs because the problem is that every single page also adds noise to the search bar right like when you search it will search by words and therefore like

37. 18:39

    if you happen to you know like put near CLI and you end up in a random page that just talks about new CI but does not show about newor CI that's a problem so there are two ways to reduce that one is about like implementing a new search engine which is also uh something else that uh we're going to be cting with the data team from from Pagoda and the other one is like you remove as many pages as you can because then you know like your your your search space is way reduced

38. 19:09

    yeah and since I said that like maybe something else interesting that we're going to be working on docs is like an AI assistant for docks uh where I don't want it to to I don't want an AI system that tells you how to do things I want an AI system that guides you through dos it's like ah you're search in about um this like you know it understands your your intention you're trying to deploy a smart contract using me or CLI then go to this page uh you're trying to build a smart contract

39. 19:40

    using you know the JavaScript SDK go to this page uh you're actually trying to use near apjs in order to deploy an account go to this other page you see so it doesn't try to guess how to do things so there's no risk of hallucinating worst case scenario you're going to end up in the wrong documentation page which is already like you know 70% better than copy and pasting code that will never

40. 20:05

    work yeah so that's another but this is not going to be the next month is going to be that's a very interesting concept we recently had a proposal for something similar into the proposals of near def Hub and uh one of the questions that uh this proposal raised is like if we are to train such kind of model be it even for providing docs how uh how this would be and like how easy would be

41. 20:30

    to retrain it because docks are changing links are changing and so the general apis are changing so how do we ensure that such kind of effort is up to date well in this case the Cod like like the docks could be changing but what is going to change mostly is the content and not the intent right so that's also why like everything is related this is also why we went through last month this reorganization of Dos

42. 21:01

    because like from now on if you are trying to build a smart contract with rust you know you should always go to build smart contract rust right like or you know it's not like that right now but you know like that that's kind of like the the idea if you're trying to deploy something you know it's like build smart contract deploy um so I would not expect this to change that much and actually in the history of

43. 21:25

    docks the the the the content of the page might change but the intent of that page will not change we will we can update how the SDK you know like how you should actually write the CC but you're still trying to deploy smart content like and and this has not changed since you know like since forever so that's not such a problem and then the model you know you don't need to to train and retrain and retrain and

44. 21:49

    retrain like I I I'm quite confident that I don't I don't know if there will be any new products but you know right if you if you just build a model for all the products that we have now and by products I mean you know like all the all all the features that you can use like multichain smart contracts front ends components um data infrastructure this is query API Etc ft nft Etc this is not going to change that much you know worst case scenario we're

45. 22:20

    going to have one Unix here I I assume except if something is coming that I'm not aware of but mhm yeah thanks GMO thank you everyone for joining us on the docs Community code today if you want to get in touch with us join the docs telegram group a link for for it will be down in the description below once again all contributions are welcomed so make sure that check that you check the doc

46. 22:46

    repository as well these goals are scheduled for every second Wednesday of the month but if you don't want to miss them or any other devhub events make sure that you follow the devhub community cander once again link is below thank you very much and see you on the next one