>> Did you know the Azure Docs are not only open source?
But it's currently the fastest growing project on GitHub.
Dan is here to show us some cool features,
a few tips and tricks,
how you can contribute,
and maybe a few hidden features,
today on Azure Friday.
[MUSIC]
>> Hey everyone, Donovan Brown here
with another episode of Azure Friday.
I'm here with Dan, he's going to teach us all about Azure Docs.
So, I'm on the team that contributes to the Docs.
>> Yes.
>> But a lot of people don't realize that they can also
contribute to the Docs
because they're completely open source, right?
>> Yeah, that's absolutely right.
So, if you go to our GitHub repo,
Azure Docs, and really all of our Docs,
including our open-source SDKs
are all available for an open contribution.
>> Delightful.
>> In fact, the GitHub universe,
they announced we are the number one growing repo
and the number five overall.
So, there were two from Microsoft;
Visual Studio Code and Azure Docs.
>> That's awesome. So, we book in that,
because of Visual Studio Code is number
one and Azure Docs is number five.
>> Yes.
>> That's amazing.
>> Absolutely.
>> Cool, and also not only can you get started here,
you mentioned that you can go to the GitHub repo,
but you actually don't even have to go to
the repo to start helping edit Docs, right?
>> Yeah, absolutely. So we're going to show that.
>> Perfect.
>> First give just a quick tour
of all the stuff that we have available,
including our Azure Architecture Center Guidance
and some of the different features you may not know about.
>> Perfect.
>> All the hidden tips and tricks.
>> Great, let's go.
>> All right. So, first thing we're seeing is
docs.microsoft.com/azure.
This is our homepage if you will.
You can search by "Products",
"SDKs", or "Architecture" or specific services.
If you know what you want to do, hey,
I'm trying to deploy a specific architecture
built for a certain app or certain app models.
So, what I'm going to do is just show
one of our articles which is Blob Storage,
a common service that allows you to store data.
So, this gives me the high level overview of
how to get started with the service
and you see these quick starts,
this is the how do I make you
successful in the first five minutes?
Let's go ahead and just select and we'll use,
why do we use this when "Creating a Storage Account".
So, within here and now we're in an article.
A couple of things just to
start mentioning here is one of the key things we're going to do,
make it easy to find other content.
So, in here, you see this "Filter by Title",
and if I just start typing here SEC,
I'll see things that are related to security.
If I started typing Java,
what is the Java content that we have in here?
So, makes it really easy for you to
find and let's just type something you had no idea,
in case we don't find it, you can search all Azure Documentation,
so in case it's not there.
>> Interesting.
>> So couple other things here.
We have our prerequisites in different ways to create
the same thing in Azure CLI, within articles.
One of the things, especially for those of you
who remember MSN and TechNet,
our page is 300-700 percent faster.
>> Oh, great.
>> We worked great in mobile.
So, let's actually just change this and you see ooh.
>> Nice.
>> It's so exciting.
>> I also like the fact that there's actually
Docs for the Portal, PowerShell, and CLI.
>> Exactly. We don't want,
it's what way do you want to learn?
>> Exactly, that's really cool.
I also like the fact that I can just type docs.com.
>> Yes, exactly.
>> They did a little tip and trick there.
>> It gets a little easier.
So, a couple of other things,
light and dark theme.
So ooh, I know many of you love your dark theme and so do we.
>> I'm too old for the dark theme.
>> Oh, yes. Then the last thing is downloading a PDF.
So, what this does is downloads
every documentation page of storage in that TOC.
So, you were just talking about using this on a flight.
>> Absolutely. I boarded a flight and it was,
I think I was coming from somewhere over
Europe and I asked the flight attendant and said,
"Do you have WiFi?"
She says, "No", and I started to panic.
Because there was an article I needed to read.
I clicked on the "Download PDF" I thought, okay,
I'm going to get this one page,
it'll get me through the first five minutes.
Next thing I know, it's
the entire document from
beginning to end and I didn't even finish it on the flight,
but it was nice not to have to rely
on the Internet for me to be able to read the Docs.
I had everything I needed it the PDF and I was able to
get be very productive
on a flight even when I didn't have Internet.
So, it was interesting because I tweeted that and people like,
"You get the entire that," I get, I've got everything.
I got all the information I needed,
so I could go in and enjoy my flight, which is fantastic.
>> That's awesome. So, just a couple other things.
Remember, we have 17 different languages for Azure,
so you get that automatically.
Another thing that's always been a pain,
the PDFs get added date.
Azure is moving so fast, communities can't contributing.
We built the system so on Azure DevOps change from
a customer goes into our build
and it dynamically regenerates the PDF.
So, when you download it, you know you're
getting the latest and greatest data.
>> Awesome.
>> So, let's go into this
and create a storage account and one of the things that you'll see
here is a couple of commands
and you'll see this green try it button and what this
allows me to do is actually use
my Azure subscription directly in the Docs.
So, this is going to give me a second to
login and I'm going to choose which Azure account to do.
This works for both Azure CLI Commands and for PowerShell.
In this case, I'm using CloudShell here.
>> Yes, CLI.
>> I'm going to copy and paste this command.
By the way, this is a full shell,
this isn't like some emulator if I do
"Echo Hello World, I'll see that.
Great. So, or "Echo hello world" and I don't know,
let's just pipe it to foo1.txt.
Let's try an actual.
>> Yeah, redirect.
>> Greater than.
>> There you go.
>> Now, let's just cat foo1.txt and we see our values.
So, this this is real.
So, couple of things.
Everyone loves to copy paste,
so let's just do a couple of quick commands
here and see if this will work.
Okay. So, I succeeded,
let's try AZ group list,
and I see my information there.
So, I'm not going to spend too much time on this.
The point is everything is interactive,
so rather than you having to download some tool or an SDK,
you get this live experience directly in a browser.
>> Got it.
>> So, couple other things.
Let's enter the "Focus Mode" and go back to this tutorial.
This allows you to jump between different parts feedback.
So, what happens when you get stuck in the tutorial?
We've integrated GitHub Issues directly here.
So, you can actually give feedback directly here,
logging into GitHub, you track your issue.
So, once that's actually resolved,
let's say there's a broken link,
you can say, "Hey, there's a broken link here."
It opens an issue against the person and you'll get
notified when that pull request comes back in and actually fix it.
So, how do we have that continuous virtual cycle
of people sending us feedback and us acting on it?
You can even see things like, "Hey,
there's six comments from customers asking what
the difference between this is
people uploading and so on and so forth.".
>> Awesome.
>> So, really deep integration with GitHub,
and just the last part,
let's say we do find a broken link, we click "Edit".
So, what this is going to do is
open up the Microsoft Docs Azure Docs.
I'm going to click "Edit" directly here which
will fork automatically for me.
>> Okay. So, this is interesting,
so this is what we we're talking about a moment ago.
Generally, if I wanted to make a contribution,
I'd have to find the repo in GitHub,
I'd have to fork it into my account,
I would then create a branch,
I would then go make the change,
I would then commit my changes,
and then I would request a pull request.
So, those are a lot of steps involved.
What you're telling me now is instead of doing all that,
you can find the Doc that you're reading.
If you need to make a change, you just click on
"Edit" and the forking,
the pull requests, and the
commit all that's going to happen automatically for me.
>> Correct.
>> Awesome.
>> Absolutely right.
>> Awesome.
>> Yes, it's that easy.
I don't know, let's make a real simple change
just so we can preview it here.
Let's say we're going to create a free Azure account,
and remember, because this is
Markdown and we have support for Markdown.
We can actually see here,
this gives you the yellow highlight and I can see the word there.
So, before you submit,
and I'm not going to actually submit
this file change because I don't like it.
But you see the proposed file change and
be able to send and of course be able to track that.
So, we have hundreds of customers
every month improving our documentation,
and that's awesome just in terms of
having that great Azure ecosystem.
>> Yeah, and it's amazing again to be able to use the community
to help make sure our Docs are as good as they can possibly be.
Typos can be corrected very simply,
broken links can be identified,
and I wish all repos are this easy to
contribute to because I'm constantly
forking repos or creating branches,
setting up the pull request.
We've made it really easy for anyone to go back in and contribute.
>> Yeah, absolutely.
>> Awesome. Very cool. We're learning all about
Azure Docs here on Azure Friday.
[MUSIC]