Announcing <IP_ADDRESS> the fastest privacy first consumer DNS service privacy first well let's explain that a little bit so DNS is privacy problem DNS is a old protocol and like most of the internet in general it was not designed with your privacy in mind first it just wasn't a thought it wasn't a feature it's not that it was designed to spy on you it is easily used to spy on you because it just was not designed with privacy in mind good distinction there it's not like it was designed as a spying device but it turns out it's a really easy one to use as a spying device DNS censorship definitely a real problem but that being said one of the problems is it passes in the clear so your ISP can choose to block this so they bring up Turkey which Turkey had blocked famously just DNS in their country via their providers so people would spray paint the 8.8 which is the Google's DNS provider so you could get to services that were blocked for such as Twitter but this is 2018 that was 2014 in 2018 Turkey has already blocked Cloudflare's DNS so so much for that they already are pretty much going to block it out of the box that's any of these countries that really support censorship they're going to block things that being said it's novel I get what they're doing but yeah they're going to get blocked building a consumer DNS service now they were talking about different performances they have some of their performance we're going to do our own performance test I love that they're using <IP_ADDRESS>.1 it's easy to remember and they also have <IP_ADDRESS> so those are both addresses that they have they did release in April 1st but it's not a joke but it is a public DNS now something kind of cool and this is more future stuff they do support DNS sec as does quad 9 which is my preferred DNS provider they do have a very robust reliable network because if you're not familiar with Cloudflare they're a massive content delivery network and they have presence everywhere so their their servers and delivery farm is all over the place so definitely solid performance you're gonna get out of them based on the infrastructure provided they run it right and these guys are smart so I have a feeling they're gonna run it right nice thing is they're also working towards DNS over HTTPS now that is available in limited I know Google's doing some experimenting with it I think you can get some plugins for Android for it once DNS starts moving there and goes over encrypting connections that'd be great for now DNS does not pass encrypted over so I'll leave this article so you can read all this and all those details but let's actually go in here and run the test benchmark so while we're running a benchmark to go over which ones we have my local DNS which is 192 with 6168 3.1 does use quad 9 then we have 1.1.1 which is our Cloudflare DNS then we have 8.8.8 which is our Google and then we have 9.9.9 which is the quad 9 which like I said I did review of before I'm happy with quad 9 because they do some filtering in terms of malicious websites that I didn't notice anything Cloudflare mentioned about malicious website filtering that being said here are the results so obviously local DNS is always going to be really really fast but Cloudflare comes out on top for speed they are they aren't lying about the speed here so their average of 0.01 millisecond for a cash name 0.045 and 0.025 on lookups pretty impressive now this is going to be subjective and this is going to vary from where you're at I'm here on Comcast in the Detroit area the difference in speed you're going to see based on different areas that's going to happen now just so you know they're using point-to-presence so point-to-presence means 1.1.1 isn't a geographically pinned IP address so it's not like that server is located in one place that server because of their content delivery network is so big they're able to give points of presence wherever is geographically close and they have all that listed on there if you want to find out where the closest server to you is so you're actually able to use this DNS resolver not just here in Detroit for good speed but if you're in California if you're in Europe if you're in Germany if you're anywhere that this isn't blocked they have a point of presence closer to you than one single server so it doesn't have to traverse as much and this is the same server the same methodologies used by the other companies but we can see when we're looking at the numbers it is fast but it's not substantially faster so quad 9 being coming out on the slowest I actually ran this twice the first time it came out on above Google now it came up below Google you're gonna get some of that you're gonna get some speed variations from time to time a matter of fact last time Google I've resolved all at 100 apparently a couple resolutions got dropped now a lot of people go what about filtering I have to trust these companies not to filter it so far and I know some people said but that there's government money that went into the quad 9 so far I haven't found any website that I went to that didn't resolve and if you ever did it's easy enough to go look up with a resolver against other DNS's and see what the variations are in the site resolving no site I've ever tried to go to has not resolved so that I know of or that I could speak to I have not seen any sites censored I haven't had any that failed to resolve we also don't go to a lot of scam sites and things like that at work so take that for what it's worth I don't have the best testing methodology they don't have a list of questionable domains to see if they filter each one feel free to do that on your own time I just haven't really put any time into that but this at least gives you an idea yes it's faster it's good they claim to keep logs a very brief amount of time which is great but like I said it doesn't necessarily dramatically increase your security or invisibility on the internet but it is still going to be better than using your ISPs internet I'm still gonna stick with using DNS from quad 9 because they make me happy and they at least seem to have some research into malicious websites so any extra layer of protection there is a great thing but you do have some options out there you can give them a try seems pretty fast and if they are at least working towards this whole DNS over HAPS I know there's some availability with some plugins for that right now that's great because that would actually hide some of your DNS but the reality is for now most of the devices on my network don't have that don't support that they at least do support DNS sec and by the way Cloudflare and quad 9 both support DNS sec I think Google does as well so feel it's content here like and subscribe those are my thoughts on the 1.1.1 I don't know I guess people are more excited than me about it but it works I tested it I benchmarked it go ahead and download Steve Gibson's DNS benchmark tool benchmark yourself see if it's faster than what you're currently using and if it is switch to it you might you might like the faster resolve times you get on there all right thanks if you like to content here like and subscribe


This is one of the very few technology names that are above supply. That was the whole point. Remember, seven out of the hundred companies are above supply, and this is definitely one of them. So, Apple. Welcome to Access a Trader, the number one community for those who are committed to taking control of their trading in order to achieve success, profitability, and longevity. Thank you for joining us. Here's Dan Shapiro to help you find your edge, master your process, and own your future. Hey guys, good evening everybody. Welcome to another edition of the AccessaTrader.com nightly wrap up show. Hope everybody's doing well. Quick update, then I gotta go to a basketball game. Again, basketball games coming out of my ears. My daughter, my son, my poodle, I think is on three teams. I don't know, but it is what it is. Anyway, so let's talk about the market really, really quick. You got the Dow, putting up a big number today. You have the NASDAQ, putting up a big number, but the only problem is again, we're still in this range, right? This is a nice range that continues to stay in that range and continues to go up and down, up and down, up and down. The only good thing that I definitely like what we saw today versus how we saw the last several days of being in this range is number one, they continue to fight. Every single time there was a headline where there was Biden, whatever the case may be, they continue to fight and ultimately reclaim the five day moving average. Again, we're not out of the woods by no stretch of the imagination. The big number here is still, right? There's still this 200 day moving average above 366, but this is at least the first time in the last four sessions, you could see it rejected off the five, defended the 10. This is the first time in the last four sessions that this is the highest close in this whole formation. You see this guys? This is the highest close. 359, reclaim the five day moving average the first time in the last three days versus the last three days is basically getting rejected, right? Getting rejected and moving towards the bottom of the race. That's a good thing, right? That's a good thing. The broad news is still we have to reclaim the 366, but again, nothing gets reclaimed at higher levels before we could reclaim lower levels and that's kind of where it is. And the majority of the day you saw really muted action like nothing really went on.  You know, there was a nice pivot at the open on Tesla not a big move at all, not a big move at all. And again, we weren't looking for anything big, but here's the pivot right here. It took out the low of the range, went back down to the bottom, you know, a little bit of flow here and there, nothing crazy. Facebook tried to go green again today only to get stuffed again. After hours, you got Chipotle with a pretty good, you know, with a pretty good earnings they're up about 7%, 8% after the close. Lyft on the other hand had a really nice chart going into earnings, guided lower, right? Guided lower on their conference call, but again, not that bad of a earnings call. Excuse me, not that bad of a move reaction to lower guidance, but nevertheless, it's still down. So it's gonna be very, very interesting to see tomorrow if the bulls can build on today's moves. And the one thing we kept on reiterating in the webinar, and I'm kind of reiterating now, this is not a market that you buy and hold right now, right? And again, I don't wanna have the whole conversation. Well, if you buy right now, it'll be okay in five years. Yeah, maybe you will, maybe you won't. So conversation for another time, you know, again, everybody understands the ramifications why the 200-day moving average is very, very important. You could take my word for it or not, but the point is if your stock will never go higher, if it can't reclaim the 200-day moving average, and if you look at history past, not every stock ever does. So it's very, very important to understand that fact.  You could feel free to buy stocks wherever you want. I'm just giving you my humble opinion, but at least for tomorrow, when you look at the leaders, right? When you look at the technology leaders to see where exactly they close, they can give us a move, right? Not, you know, maybe not a 20, 30, 50, 80-point move. Like we see really, you know, very aggressive bull markets. But if you look at charts, how they set up towards the end of the day, you can see kind of where I'm at least optimistic if the market confirms tomorrow we can have moves and check this out. So you got in the video, right? You got in the video here. This is the highest close in this whole formation at the last three, four days, right? And the video could confirm, again, we saw 257.50 calls for the last couple of days coming in, if they could confirm, hey, this is, well, this is where they're getting the 257.50 level. It's an area back at the supply. So we got to keep an eye on the video. A name like Andy is, you know, looking really, really good. It's a stone throws away from its earnings highs. If they could confirm its earnings highs, maybe this thing goes, right? Look at Apple. You're starting to see a little bit of blue skies. It's a lot better looking than a lot of the technology names. Because again, this is one of the very few technology names that are above supply. That was the whole point. Remember, seven out of the hundred companies are above supply. And this is definitely one of them. So if Apple could confirm this whole channel here, hey, maybe it starts moving higher. We saw a bunch of 75, 80 weeklies coming in. Maybe if the market has a day to run, the money flow could extend into Apple. Amazon, even though it had this impressive, you know, 500 point reversal a couple of days ago into earnings, keep this in mind, they got rejected off the 50 day moving average. But if they reclaimed the 50 day moving average tomorrow, again, do I think it's going to be another 200 point run? No, but I think there's a good chance that we could get a pretty decent vibe, right? A pretty decent wave for the next supply zone. Maybe going all the way up to the earnings highs of 3,300, right? Very, very possible as well. So there's a lot of names like that. Even Qualcomm, even Qualcomm to kind of stick to the semiconductor theme is, you know, maybe one day away from getting above this whole channel here to kind of reclaim supply, that would be good as well. The one thing that we don't want to do, okay, is get lazy and get complacent and start making predictions. This one's going to go there, that one's going to go here. Again, it's the easiest way to kind of get yourself, define yourself, not trading, okay? Predictions, and this is what's going to happen five years from now. We don't know what's going to happen 30 seconds from now, let alone five years from now. So the idea that you're making these, you can make this arrogant, well, you know, Tesla's going to be at 5,000 next week. Okay, maybe it will, maybe it won't. But again, we don't know, right? So it's all speculation. So here's again, we don't trade on speculation. We don't trade on guessing. We trade on facts. And speaking of Tesla, although it's not out of the water, right? Not even close to green, you know, green pastures, at least we could see a channel brewing, right? Look at the 60 minute view here. At least we could see a channel brewing here. And maybe it doesn't go back to 1,000. But the point is there is a channel here. And if it could confirm and take out this whole channel here, maybe this thing wakes up as well. The one thing that we did not see today, as good as the market closed in, this is the highest close in the queues, like I said in the last three, four days, the one thing that I really did not see today is big option, big option flow, right? Big aggressive call buying, as impressive as it was, especially after Biden's speech, that the bulls kind of reclaimed back the five day moving average. It was very suspicious that we did not see a lot of call buying, a lot of near term expiration, a lot of out of the money expiration. So it does really feel like, I think the majority of traders, and again, I speak to a lot of traders every single day. I mean, I grew up in this business with a lot of really good guys. And everybody's still waiting for that big green light to kind of get out of this whole channel here, back to the upside, or get out of it below. So this area here of 362 continues to be kind of the green light for the bulls.  Maybe tomorrow's finally the day they go through. We don't know, we can't speculate, but at least we have a course of action that we know how important that 362 level. We also know how important this 352 level is that the bulls defended now three, four days in a row. And now it's time to see what individual stocks could actually wake up, right? Confirm their channels. Remember, we're not looking for massive, massive moves because again, we don't have enough daylight. We don't have enough clear views without supply. Most stocks are still sitting way below their supply, but you can definitely get trades, right? You could definitely, there's a 20 point channel in Tesla. There's a six point channel in the video. There's a five point channel in Qualcomm. Obviously AMD has a big channel as well, if it expands. So there's definitely room to get the job done, but the most important part is they have to confirm. Guys, have a great night everybody. God bless and I will see you all tomorrow. Take care.


Two of you Freedom Family are getting this set behind me sent to you by email because you won! Do you want to get this set to make your videos in live streams? Simply click the link down there in the description below to apply for this contest. 3D sets are a cool new way to create videos to make your channel stand out among the crowd and this 3D set is built in the Unreal Game Engine. To see all of the sets that we've made, click that i up there. We've made many! This is called the ESPN set because it looks like the ESPN set on TV. You can do many cool things like zoom in or control the camera with different camera angles or a freeform camera. If you want to learn more, click the link down there for how this set works in detail. Before announcing today's winners, let's read some of your deserving comments Freedom Family starting with Predators. Who wrote 26 minutes ago? I know Freedom is a very good network but why wasn't I paid? Well, I checked your account Predators and in case this happened to you, here's the answer. You joined Freedom on May 10th, 2017, which means you will get paid at the end of June if you enable advanced payments in your profile page. Click that i to learn all about advanced payments and why you should or shouldn't enable them. Or, Predators, you will get paid at the end of July for your May earnings if you don't enable advanced payments. How many of you are using advanced payments? Tell me down there in the comments below. Master Audit wrote, menu? What's that spelling error? And did anyone notice the virtual camera spear in the air? I saw it in every George show and I replied, yes, you saw the spelling mistake. Sorry about that. And we have a few bugs like the sphere in the air to fix. That's partly why we're running contests for these 3D studios because, well, they're not ready but they do work. There are a few small bugs like spelling mistakes and spheres in the air. Since many of you expressed passion to try these sets, I am running this contest to pick those of you who make the most passionate pitch so you can get a sneak peek early access to these 3D sets. Now, tech support wrote, hey George, what are my chances to win? Please don't ignore me. Please reply and please review my contest. Well, tech support, I'm happy to tell you you are one of today's winners. Today's second winner is the author of this comment behind me, King of YouTube Tall. Who wrote? Okay, George, I think something is broken. I do not think I got the link to the 3D set and what is going on with my videos. Hey, did you guys email me the link to the 3D set? I do not know if I got it. Well, we didn't email it to you yesterday but I just emailed it to you right now. So please check your email and reply. That's where you'll get the download link to the 3D set as well as instructions on how to use it. I also asked me to tell everyone that you and your friend do a very good job on making videos. Can I also suggest a spell checker so you can also write very good English? I'm teasing, but please do try to spell a little more correctly. And tech support asked me to say I make tech videos regarding any new tech reviewing unboxing tips and tricks and I'm going to start a new shout out series to help channels with less than 100 subscribers because I know how it feels to be stuck at below 100 subscribers. And he's also doing a giveaway. The links to both channels are down there in the description below so you can check out their videos and their channels. Here is that 3D virtual set that I've been talking about and if you want to get access to this but don't want to apply, don't worry. We will release this to everybody in the freedom family when version one is ready. Until then, we're running these contests and maybe other interesting ways to pick people to get early access to these sets. So you can do things like move around with a free form camera and try camera one or camera two or camera three or start the show by just zooming in from powered by freedom into your character. And you can see the ball right there. See, oh, I kind of missed it there. What is that ball? Let me show you. The ball is the free form camera. So if I just put the ball somewhere easy to see like here and then I choose camera one, see, there's the ball. And look, I can move the ball. I can play with the ball. I can move it up and down. It's a game. Actually, this ball is a game. It's your character.  That's actually the ball right there. All right, it's a bouncy ball on the desk. I hope you enjoy these sets. Tell me down there in the comments below what you think of this project. And who am I? I am Papa George, that guy. George Sunpai and many other names. You, the beautiful freedom family has given me. I am George CEO and controller of this of this ball. See you and founder of freedom for freedom. Oh, I think I just lost my booster seat. Sorry about that. Let's try to get up a little bit. Oh, it's hard to stand. Okay, little squat for freedom and the freedom family. And for the awesome video factory, click that. I, in case you don't know about the video factory, it's getting painful to sit in this spot. And for the amazing Ben, who's running music factory and all the composers who are contributing to it, like Mike Mack. Thank you, Mike. For the music factory, click that I to learn all about that. All right, now I'm really getting tired. Who, uh, how's it go again? Oh yes, I am George and you've been watching. Click that I to partner with freedom and join the freedom family so we can all grow together. You get many perks like position music. You also get epidemic sound, a lot of other access to royalty free videos, sponsorships and many things to help you grow. Just click the links down there in the description below to get involved in our community, our forums, our discord chat servers, meet our graphics team, meet our community team, all of that on discord and the forums. What are you waiting for? Get started. And we will grow together as a family because this is the freedom family. You are part of it. We are all part of it. And we're all growing together. See what YouTube recommends you watch next.


Hello everyone, my name is Celeste Horgan. I'm a senior technical writer at the CNCF And this is writing for developers. Take your project docs to the next level So let's start with a fun fact. About 50% of responses to the query how to choose a development framework on Stack Overflow mentioned documentation in the response Full disclosure, this is a pretty rough estimate done by me. I Spent some time googling how to choose a dev framework how to choose a dev ops tech stack, etc I'm combed through the responses by hand But the vast majority of them do mention speed of learning availability of documentation And how many responses something receives on Stack Overflow? So this is a bit of a call to arms for you This talk is really aimed at documentation maintainers as well as new contributors. So CNCF is a community of open-source projects and it's really really great that it's here But as far as an open-source project goes there is no dedicated support team There is no sales team and there are no dedicated technical writers unlike in a private company This is not to call out any of the partner organizations that we work with because what those partner organizations do stuff is amazing And we thank them for it It's more to say that the work that gets done is what the community chooses to contribute to And if we don't choose docs, the docs don't get done and there are consequences for that as we saw previously People look for projects that are well documented Especially in open-source because they don't have a company to fall back on so it's really important that those docs are well maintained So this is a talk not necessary about documentation maintenance though it's about how to become a really great documentation writer and I think we can borrow some ideas from English literature in our Journey to become a great writer. So this is the hero's journey. It represents an archetypal story In English literature, we think of the idea that most stories tend to follow a few different archetypes with a few different Variations the hero's journey is a really common one. Your hero is given a call to adventure They need a mentor. They go through some trials and tribulations and through those they gain the skills to return to their homeland And and vanquish and evil that they were maybe unable to conquer before their journey So they return triumphant but invariably changed by their experience And here's journey really applies to our user's journey as they go through the documentation Um So we'll be using this as a bit of a framing device to talk about how to write good docs from your user's perspective So let's start at the beginning the call to adventure Little Red Riding Hood is a great example of What your user is thinking as they approach your documentation so famous story Little Red Riding Hood is a very beautiful young woman. She's going to bring her grandma some food And she has to be able to walk through the forest to get there um, I Think this is I don't think this is a story that people are unfamiliar with When we think about this in terms of documentation then we can take away exactly one thing which is Your user always has a goal and your first task is to understand what that user goal is Um If your user were perfectly clever and smart and wonderful They would have no reason for coming to the documentation Invariably though they're here and now we need to understand why so that we understand what we need to write There's a few different ways that you can go about learning what your user's goals are the first is obviously talking to your users If you have community managers or dev rails or product managers or program managers These are great people to start identifying that user need But not every project has those So another way to go about this is to keep track of questions that have been asked repeatedly or keep track of Bugs that seem to come up time and time again in the slack channel What this usually indicates is a need that a lot of people are facing and if you write that down You're going to have pretty effective documentation for some subset of your users The final thing you can do is as you're planning your development story ask yourself what the documentation is going to look like One of the hardest parts about writing documentation is that as you develop something you become such an expert in the thing That you're creating that it's hard to zoom back out and think about what it would be like for a beginner So if you can bring that part forward that zooming out forward to before it you start your development You'll have a much a better picture of what somebody needs to know than you will at the end So this is what I want to talk and I really want to talk about new contributors as well though Which is you are invaluable to the development process for documentation for people here Because you have the beginner's eyes where as we just mentioned It's really easy to lose those as somebody who's working on a project So there's a number of different things that you can do that are really really helpful to project maintainers The first is to submit github issues and to open documentation PRs I've not met a project to date which is unhappy to receive a documentation PR Provided that the content is well-rounded and focused The next thing that you can do is to start talking to the project team and say hey Well, I was trying to execute on this use case or this scenario Would this be a good tutorial? Would this be a good blog post and maybe start working with them? And the third thing is to cherish your beginner's mindset I think that people are often a little bit afraid to approach open source maintainers with questions and to be perfectly clear The maintainers don't owe you an answer However You only get to be a beginner once and sometimes those questions are invaluable and super useful to those maintainers and creating good content so don't be afraid of Asking that question and don't assume that you're the only person who's having that problem because in most cases There's somebody else as well So let's talk about some common user goals for documentation In general These are ones that I've seen come up in my career over and over and over again So I think I'm pretty confident in saying that they're they're in play here for cloud native So some common user goals when somebody's looking at the docs Evaluating new text sacks to implement at their company. This is surprisingly common And a super underserved need in most documentation sets um Most companies don't have great feature lists For their projects and most open source projects don't have great feature lists either People look at your documentation to evaluate whether this is something they want to use or not Another thing that's really common is sort of learning just generally speaking like they're they've started to use your project at work and Now they need to be an expert in it overnight passing certification exams is another big one Supporting an existing system. We are super lucky here at the CNCF and that cloud native is becoming super ubiquitous And that means there are a lot of people looking at your documentation supporting your thing in production and finally somebody's developing a new feature for their own company and They were looking at your documentation to solve a specific problem that they are currently facing So the great thing is that documentation can meet all of these needs and more When we talk about evaluating text sacks concept docs are invaluable in that regards In regards to general learning to supporting existing system API references are super useful Once again on sort of passing certain exams tasks and tutorials and cookbooks are a huge reference for that particular audience and For the person who really just needs the answer to something specific Generally being well organized in your documentation or having good information architecture as well as making your docs really searchable Is super helpful to the person who wants to do that So we've been talking at a high level now, and so let's let's dive a little bit deeper Our hero has heard the call to adventure. They are in your docs. They want to find the solution to their problem Or the end means to their goal And now they enter this middle stage of the hero's journey. They're facing trials and failure So this is a Greek vase depicting Hercules slaying the Hydra Hercules is his story is famous for the many trials that he had to go through to regain his godliness But in each of those trials he had to acquire new skills and gain new Compensities in order to accomplish his goals and your user is exactly the same We need to give them the skills of documentation because as I mentioned For an open-source project. There is no support team for that. There is no sales team There is no marketing team. It has to come from the docs So luckily as a technical writer I Can tell you how to explain anything you ever want to ever And how to do it really really well all it takes are three simple parts First you have to explain the concept of something to people at a very high level. What is this thing? What does it do and why do I your user care? The next is a task. So, okay, I understand your thing now. Now, how do I use it? I have a goal. I want to accomplish my goal How do I use it and can you tell me about any pitfalls I might run into along the way? Finally I'm a user. I think I know how to accomplish my goal after all those tasks But Michael might be slightly different than the one that you mentioned the task So you need to give me some reference documentation show me all the things that your thing can do and then I'll decide Which of those functionalities I need to use to solve my problem And between these three styles of writing you can explain anything So let's dive into this in a bit more detail So concepts concept topics explain a feature at a high level. You can always tell a concept topic Because they tend to use a very standard sentence construction, which is blank isn't blank, which does blank It's almost always the first sentence in the concept topic and that's how you know you're there In general concept topics briefly describe or link to other topics related to the feature at hand And they describe why a user might care about a feature or what the common use cases for using something are Once again, I'm a user and I have a goal and I only care about that goal So tell me whether this thing you're describing it's gonna meet that goal or not So to give an example These are from the Vitesse documentation and they're describing a cell and you can see that sentence in the very first sentence A cell is a group of servers and network infrastructure and dot-dot-dot Which typically does dot-dot-dot um in the second and third paragraphs we start describing the linking to other concepts that somebody might need to know And further on it's a bit cut off in the screenshot. We start talking about what the common use cases might be The second component of really great documentation or tasks and in many ways, this is kind of the meat of the sandwich Test describe what a user can do with a feature You can always tell you're in a task topic when you start seeing things listed out step by step by step They'll often use numbers or bulleted lists Another sort of good flag for knowing you're in a task topic is you see a lot of code samples So anything that has like crud functionality create read update delete Will typically end up being in a task topic And you can also sort of tell you're in a task topic if the top the the title of the page has a verb in it or starts with the verb Because these are about doing There are lots of different style of task topics a numbered list is just one of them Tutorials are another type of task topic Cookbooks are a very very focused sort of task, which is this is the specific use case and the specific code You need to do it And similarly sort of example apps broadly speaking fall under the idea of a task because you are trying to help somebody accomplish something one thing to caution Particularly around kind of fully featured sample code like sample apps and cookbooks is As much as you think or want to feel That the code to speak for itself and it's standalone. I promise you it isn't I promise you it isn't and a Minimum you need to describe to people how they can take the code from github put it on their computer and make it work But in general at the very least commenting your way through a sample app is a really really great way to help your users out So batches of a test stocks for an example Insoles and quick starts are almost always task topics And once again the Vita stocks Do a really great job of showing that Kind of third paragraph and we've got a code sample and the rest of the page continues in this fashion So the very last type of topic that you need to describe anything Often seems like the least glamorous and often ends up being the most important particularly if you're you're in a pinch And this is reference so references provide lists of all options for a feature The one you might be most familiar with our API references which describe all endpoints and accepted data for a feature another one our java doc style Documentation descriptions of command line interface flags and what each one of them do Often these are honor generated from code though not always And the thing to keep in mind when creating reference topics is that completeness and accuracy is the most important thing to a good reference topic Which is why they're often out of dimmer into code People are surprisingly forgiving a task topic that maybe has one step, which is inaccurate But reference documentation is where you often go when something is not working the way it should And you need to sort of troubleshoot your way through it Which means if the reference is not accurate It's very very frustrating to your most frustrated users and you will hear about it. So a great example of how to manage a complex reference topics via auto generation was executed by our One of our Google season of docs interns last year. So shout out to Philippe for doing amazing work on this Because now the Kubernetes docs are auto generated directly into our hubos So We have our concepts which explain things at a high level. We have references which explain things in Quite a bit of detail and you have tasks which explain specific tasks something somebody wants to do Great documentation almost always has all three types You rarely see any of them alone. So to give an example of what that might look like Let's take another look at Prometheus's documentation and we're going to zoom in on this querying section so This first topic under querying basics, that's the concept topic. This is where they're describing What is querying? How does it work? Etc. Etc.  So that's the reference part and Similarly, they explain what functions are and what functions are available Next they have examples which when you click into this specific page Is really a bunch of very short tasks and finally they have an HTTP API reference All three types of documentation Complement each other and they really shouldn't exist in isolation. So this is a great execution of that idea So let's let's head back to our hero's journey for a second We've got our users gone on an adventure and we've given them new skills And if we've done our jobs well now they can go back to the thing that they're working on and they can achieve their goal They can solve their problem So they're in this part of the hero's journey. They have had a change. They've received a gift and they are returning so Much like Jack here. So this is an image from Jack and Beanstalk, by the way Which if you don't remember the plot a lot a giant has been stealing things from Jack's family for quite some time So he is given some magical beans He he plants them and grows large beanstalk and then he takes his stuff back from the sleeping giant And he sneaks off And that's what your users doing at this point in the journey as well. They have what they need But it's not the whole story because again if you've read Jack and the Beanstalk any time recently the story doesn't end with Jack sneaking off Great documentation shows its users where to go next and It does this at a number of different scales So you can organize the entire doc set along a user flow, which is what is the beginning for your user? The middle and the end But it also does it at a much smaller scale, which is in an individual piece of writing. So within that document The beginning is usually the concept and then the middle is some task topics and then the end is a reference But what comes after the reference when you've imparted all the knowledge that you need Some well curated learn more links never go out of style asking for feedback is We found it marginally slowly Cooper 90s community, but I I wouldn't re-implement this on a new site But never assume that your user's journey is done just because they've reached the end of the page By way of wrapping things up and to bring this back kind of for the new contributors Documentation is a team sport new contributors and end users are kind of key to great documentation And to kind of bring it back to Hercules in this boss You'll notice on the left-hand side Hercules actually has a friend here So while Hercules out front fighting the hydra his friend is helping at the back And that's what you can do for project maintainers as a new contributor As I mentioned before it's really easy to get super deep into something and super technical and suddenly lose site of what it's like to be a new user So a great way to start contributing to open source and to start contributing to cloud native communities Is to start opening documentation tickets because they don't assume they'll know and Your contribution could be really valuable in that regards So thank you very much for your time everybody has been lovely to chat docs with you I will be around at the end of this presentation to ask some questions live um Here's where you can find me um if you want to get involved with CNCF project looking for docs help join us at the CNCF tech docs office hours If you're a maintainer look out for the emails telling you where these are going to be I and the other technical writers here at the CNCF hold monthly meetings where you can ask us any question about Documentation you want and we'll try and help you out as best as you can Um, if you are a new writer and you're looking to help out I encourage you to drop into a project's community meetings and See whether it's to see If you're looking for something a little more structured kubernetes sick docs is our biggest documentation community And they're the most well-equipped to help new Contributors and if you want to talk more at me I'm gonna be hanging around in the CNCF slack for another little while After this talk and you can find me on Twitter at sloth sorghum. Thank you so much for your time


Well thanks for staying with us. A bit of drama took place in the house of representatives when the minority leader, Ndudi El-Lumil, etched the house to demand resignation or sack of the Minister of Communications and Digital Economy, Issa Apantemi, for want backing activities of jihadist leaders and deadly Islamic sect. The speaker, Femi Bajabiamila however, overruled the minority leader, noting that the matter being raised had nothing to do with his privilege as a lawmaker. Joining us to discuss this is a political analyst, Achike Chouday. Many thanks for staying with us, Mr. Chouday. Yeah, thank you. It's a pleasure. All right, let's get your candid opinion concerning this particular issue. It had the media, of course, the media space has been a gurg with calls for the Minister of Communications and Digital Economy's resignation. With what happened at the Senate yesterday, what exactly are your thoughts? I'm sorry, the House of Reps rather. Well, I think that we are used to seeing situations where it would appear that the representatives of the people do not give matters of fundamental interest to the people, where it appears they do not give the kind of attention that it needs. Obviously, what is going on today in the country is something that has called the imagination of a lot of Nigerians. And you see activities on social media, you see Nigerians waning on it. And you would think that when the matter gets to this level where a large majority of the population feels strongly about a particular issue, such as what we have on ground, that kind of sentiment, general sentiment across the world would persuade our political leadership to move in a particular direction. But it appears that that is not the case. And that's why we saw what happened at the House of Representatives where the speaker tried to, I mean, everything in his power to ensure that the matter that was brought up by Lumenlu was not given the kind of attention by the national, by the House of Representatives that I believe matters really as this should have gotten. So it's unfortunate, like you have said, everybody, this is something everybody's talking about. This is something that is on the minds of everybody. A lot of, I mean, so what Plasti is doing right now focusing on it is something that a lot of other media houses too have also been doing, pointing attention to something that the media believes is of importance to the people. And the people themselves have shown it in so many ways that this matter is important and should not be swept under the carpet. All right. We'll get back to you now, Mr. Archudelets bringing our other panelists into this conversation. Good evening. Many thanks for joining us, Dr. Sheto Lu. Does it really bother you that there was a federal executive council meeting yesterday and, of course, Nigerians have been talking about this particular issue for a while right now that is the call for the resignation of the minister. And when the minister of information was asked about the discussion, if it was discussed, in fact, he just said it was not discussed. What does all of this pretend? Well, I'm not, I'm not bothered. Why should I be bothered? Why should I be bothered to the government that has shown incompetence, has shown insensitivity to the grievances and the grievances of Nigerian people? Why should I be bothered by government that's shown to be nonchalant and lackadaisical, you know, through the agitation of Nigerian people? You know, it's obvious that the government has its preferences, you know, and it has chosen its preference. It's rare to find a state official resigning government. Why are we asking for a rarity in Nigeria, except that the new folks pull out there? I do not expect it in these of them. All right, thank you for your thoughts. Let's continue with this particular conversation right now. A lot of Nigerians have been talking about the screening process of ministers and, of course, other appointees in Nigeria. What does this really tell of our security apparatus that the DSS that should have done for a screening, as much as we had that this screening was done and it was overlooked, and of course, the Senate, what does it really tell about appointment into, you know, political offices in Nigeria? You know, we cannot conclude that the state security service is not due diligence. What if the state security apparatus had information about him, about its means to terrorist organizations, etc., which probably could have been submitted to the state? What if the state and many exemptee workmen did not act about it? What if the state didn't consider it sufficient enough to drop him for a particular appointment? So it is neither here nor there. We're not sure if the state security service did due diligence or not. It's not impossible state security service did due diligence. It's not impossible that state officials chose to neglect those findings. It's not impossible. We've been speculating too. But concerning the National Assembly, the process of ratifying appointees from the president has become a charm, and it's a charade of thoughts. It's become a comedy in Nigeria. When you compare it to the American experience, it's not a serious business. The process should sure we go and there should be free interview, investigation, kind of profiling on the candidates, about their backgrounds, about their demeanor and misdemeanor, about the family background, the role politically, and security reports about such individuals, etc. We work with witnesses in several screenings, a child's place. They're not so serious. And the National Assembly, the Senate and National Assembly do not give the impression that we're serious about a country. The legislature is not shown to be pro-people. It's not shown to be pro-Nigerians. And the National Assembly is not shown to be committed to protecting the integrity of the Nigerian state. The process, if you ask me, has been a charm. All right. Thank you, Dr. Chetou Lou. Back to you, our analyst, Ajike Chude. Let's talk about the moral thing to do here. Inasmuch as there's been so much shout about this on social media, and of course almost every discourse around Nigerians, another school of thought believes that it is irrational to be calling for his resignation. But looking at it, what's the moral thing to really do in the sense that he holds such a critical and sensitive position in Nigeria, where anyone could actually be at risk right now? What is the moral thing for the minister to do in the wake of all of these calls? Yes, thank you. If you allow me, I will just briefly touch on the last question you asked, which of my good friends there Dr. Chetou Lou has adequately also talked about, and that is the issue of nomination and the screening of candidates for appointments to the government. The reality is that in Nigeria, politics trumps common sense, politics trumps reason. Parochialism drives a lot of things within the polity. And so that is why we see the kind of result that we're seeing today. And you know, Dr. Patami is not the only one. There are so many other things that have been swept under the carpet on the basis of screening of some of these people. Of course, we have known also that when it comes to the issue of screening, when in the past we have seen that the pecuniary interest motivations also drive some of these screening processes, corruption. It's also driving some of the screening and the results of the screenings that we have seen. And so this is also a symptom of the disease that we have also been facing in the country. So that is at that level. Just like Dr. Chetou Lou said, there is every indication or a possibility that the DSS has done its job. But we know how these things go. Ultimately, it is the political decisions, not common sense, not the need for service that determines whether this will scale through the national assembly or not. Now talking about the moral, you know, possibly the moral disposition of Patami, I think the issues are very clear. First of all, when this matter broke, he denied it strenuously. He said it on the line. It was only on the strength of parts that emerged, the video evidence and audio evidence that emerged, or what he had already denied, that he reluctantly accepted what he had done and not gave reasons why he did it, that he was a very young person. The four-year-old person is not a young person who was holding court, you know, and then spewing fundamental or extremist views, religious views. It's not, I mean, from the amount of it that four-year-old person. It's an adult. You become an adult when you attend the age of 18 years. And then it's almost his age. There was almost double that of 18 years. So he knew exactly what he was doing. But the reality or the situation really is this. He says he's sorry and that he has, you know, stepped aside or stepped back from the disposition that he had when he was much younger. But the reality is that repentance is not something that, I mean, a man thinks he repents of something and you're not exactly sure whether he has actually repented. He's holding a very key position in this country, a very sensitive position in Nigeria. And then we have hard instances where it has been indicated that people who are not of Nigerian births, who are not Nigerian citizens have obtained national identity cards of, you know, the federal republic of Nigeria. So, and then in the midst of this insurgency, to which he has at a younger age, according to him, shown some kind of loyalty to, you know, you cannot accept, you know, you cannot. I think it will be full hard for Nigerians to accept the statements of regret with regards to maybe his repentance. The position is too sensitive. And so I think that the honorable thing for him to do is to resign that position. I believe very strongly. But then the issue, just like Dr. Shetaylou has said, is who are the people driving the country?  The fact that we are where we are is really, I mean, as a result of the failure of governance and governance, you know, as a result of the disposition of the activities of the political elites in this country who have shown in so many ways that they are not exactly interested in the welfare and interest of Nigerians. So, I would have expected that at this particular point in time, a lot of politicians, especially those in government, this president most especially would have done everything to distance himself from somebody like, you know, Dr. Patamin. This is what is expected of the president. And because mainly, lastly, as a result of all the speculations and the suspicions surrounding even the disposition of the president, you know, with regards to either the headsmen, a lot of Nigerians have often accused him of being sympathetic to them. Even the Sogyansi, if you remember at the particular point in time, Boko Haram had some years back, you know, touted the president to be their representative in the possible, whenever, you know, a dialogue there, because who are muting the possibility of negotiation between, you know, Boko Haram and the Nigerian state at a particular point in time. And the president was touted then to be the representative of Boko Haram at that particular point in time. It was about a week later that the president dissociated himself with the group. So the pressure people have about the president is not good. It gives the, but this situation gives the president an opportunity to dissociate himself from Patamin by making sure that Patamin, the guest, Patamin to resign, and if he refuses to resign, to kick him out of office. This is what is expected of the president at this point in time. All right. Thank you so much. I'm Adyke Trude for your thoughts. We do appreciate it. Let's get our final words now from Dr. Sheto Luazui, a round of this particular discourse. With all of this now, what is the way forward? And what does it really tell on the fight against insurgency and terrorism in Nigeria? Well, if you ask me, I do not expect Dr. Patamin to resign. He's not been the patent. It's rare that state officials, and they are record that the former secretary was accused of power practices, you know, resign, but it's still rare. Well, the fight against terrorism, insurgency, et cetera, has been uncoordinated, has been unscientific. And if you ask me, what made his failure in this respect? Also, when the utterances of the sitting cabinet minister is suggesting that there are the individuals in the cabinet who are impotent to insurgents and terrorist organizations, and we suppose that the terrorist organizations or the terrorist groups and insurgents groups may actually be penetrating, you know, the state authority, which is unfortunate, or which will be unfortunate if this happens? Well, you did the moral. You had that question earlier about the morality, you know, of the issue. Well, you recall that politics in Nigeria is really based on morality. That's really a moral question about political actions, about political decisions or indecisions in Nigeria, you know, and the state officials are really pushing, you know, the moral or ethical question, you know, it's the question about morality rather utopia in Nigeria. We're not there yet. Okay. I wish that the minister, in the light of the evidences, you know, and the mountain agitations and pressures to quit the office. All right, thank you. One, to dust political pressure and two, you know, to show that it's so pretty about this authoritarian state. When you continue to stay in office, it will be a security threat. It will be a security threat. And most of the evidences are huge, you know. I'll complete on this note. The state action against insurgency, kidnapping, bad duty, et cetera, you know, has been lopsided. And it's not shown that state officials are well informed about how to do about, you know, proceeding, within the struggle, and how to contain the insurgents. We'll be asking the state officials appear to be short of ideas. All right. They appear to be short of ideas. And Nigeria is at the crossroads. All right, thank you so much for your thought. I'm afraid that Nigeria is defragmented. And Nigeria is on the verge of assuming a collapsing state. All right, thank you, Dr. Sheto. Look for your thoughts. We do appreciate it. Indeed, we've been talking about the fight against insurgency and terrorism, vis-à-vis the wake, the call for the resignation of the Minister of Digital Economy and of course, Communications, Issa Pandemi, and I guess they've been Dr. Sheto, Lou, and of course, Achiké Chouday. Thank you so much, gentlemen, once again. Thank you. Good evening. All right, we'll take a short break and when we return, I'll be giving my take. On the extent of borrowing, the government should focus on providing social services such as education, healthcare, security among others with the resources at its disposal while creating the right environment for the private sector to engage in businesses such as agriculture, industries, and transportation. And the extent of borrowing, social services such as education, healthcare, security among others with the resources at its disposal. Those are my thoughts for today. I am Justin Aka, the New Plus Politics Returns Again tomorrow.