>> Hi. Welcome to the DevOps Lab.
My name is Abel.
In this episode, we have a very special guest,
Deependra. How's it going?
>> I'm doing great. Thanks.
>> So what are we going to be talking about?
>> We're going to be talking about Azure DevOps Wiki.
It's a documentation solution within Azure DevOps.
>> Awesome. Everybody, tune in.
[MUSIC]
>> How's it going?
>> It's going great. Thank you.
>> Yeah. So what do you do at Microsoft?
>> I'm a UX designer with Azure DevOps Team.
>> Awesome. So I have a problem.
As a Developer, one of the things that I need to
do is be able to collaborate with everybody else on my team.
So I desperately need
a system where I can store all that information.
I need to be able to edit it easily.
I need people to be able to access it easily,
and also to be able to search.
Now, what I heard is, we've got this thing called
Azure DevOps Wiki that can help me solve all of this.
>> That's right.
>> What is Azure DevOps Wiki?
>> Azure DevOps Wiki is
a documentation solution within the Azure DevOps Suite.
It can help you address your documentation needs at
various stages of your product development,
be it creating specs,
and creating meeting reports,
or just any general
information that you'd like to share within the team.
>> Very cool. So basically,
I can create any type of documents that I made.
>> That's right.
>> Can you show us what this looks like?
>> Sure.
>> Okay.
>> So this is what Azure DevOps Wiki looks like.
Since it's part of the Azure DevOps Suite,
it's also well integrated with the rest of
the services in the suite,
be it like Boards, be it Repos.
Also, Wiki is actually powered by underlying Git Repository,
which also enabled some of
these really powerful workflows for Developers.
>> Okay.
>> So let's create a new Wiki.
I'm going to demonstrate how do we create a new Wiki.
>> Perfect.
>> So I'm going to head over to this project.
>> Okay.
>> Under the "Overview" section,
I'm going to click on "Wiki".
>> Okay.
>> As I do that, I land on this page.
We're going to click on "Create Project Wiki" for this demo.
>> Perfect.
>> "Publish Code as Wiki" is where you would go
to if you are looking for some of the advanced Git capabilities,
and we're going to cover that in another video.
>> All right.
>> So I go ahead, click on "Create Project Wiki".
We just created a page.
I'm going to name this "My first page" and I will save it.
>> All right.
>> Now, as I save it and close it,
I land on this page.
So here's what our Wiki looks like.
There's the name of your Wiki,
and here's this hierarchical tree view,
wherein you can see a listing of all your pages,
and there's the page right there.
>> Perfect.
>> So I am going to demonstrate some of
the more capabilities of Wiki.
Let's create a new page.
>> Sure.
>> All right.
>> You just created a new page.
>> I just created a new page by clicking on "+ New Page".
I'm going to name this "Meeting notes".
>> Okay. So this is a Wiki or,
I guess, the Wikis are Markdown, correct?
>> That's right. Wiki is actually powered by the Markdown.
>> So this is a Markdown editor built into Azure DevOps.
>> That's right. Absolutely.
>> All right. Let's see some more cool stuff.
>> So there's a formatting toolbar right there on the top,
and this is for users like me who are
not very great with the modern syntaxes.
>> Perfect. Like me as well.
>> Yeah. There's also
a link out there which is Markdown supported.
>> Okay.
>> So in case, if you're looking for more Markdown syntaxes,
you just click there and then it takes you
to all this list of supported Markdown syntaxes.
That comes in pretty handy.
>> Okay.
>> So let's start typing in.
>> Okay.
>> So since we are taking meeting notes,
let's type in the agenda of the meeting.
So as you can see, as I'm typing in,
there's a real time cyber site preview.
Whatever I type in actually gets rendered on the right,
so that way I get a preview.
In case if I want to one leg,
just a "Preview Only" mode,
you can also do that by toggling it here.
>> Okay.
>> So let's see if we can format this content.
>> Sure.
>> So I just select the string,
and I'm going to make this a "Header 1" style.
Notice what we did here is that we actually added the hash,
which is the Markdown syntax for creating X1 styles.
So there's that. Next step,
I am going to create a table of contents.
>> Okay.
>> So I head over to this ellipsis,
click on "Table of Contents".
As I do that, it just automatically generates a table of contents,
which gets updated with every new heading that I add.
>> Very nice. I like this.
>> That's right. Let's try creating some links.
>> Okay.
>> So I'm going to call this "Link to strategy".
>> Okay.
>> So there are multiple ways through which you can create a link.
The first way is that you select the string,
click on "Link" here.
Now, at this point, I can actually insert
a link which heads over to it,
which is pointing to an external URL,
or perhaps I could even interlink some of the Wiki pages.
>> Nice.
>> So I'm just going to do "Enter" and "Slash".
>> So you can enter in any type of link, external, internal.
It doesn't matter it's just a URL.
>> That's right. Yeah.
>> Nice. So this is just basically a Markdown editor.
It's a sweet Markdown editor.
>> That's right. Yeah.
>> Nice. It should make editing these Wikis much easier.
>> Sure. There's also an option for me to actually
drag and drop these links into the editor.
>> Nice.
>> Perhaps, if I want,
I can just copy the page path and paste the link in there.
So there are multiple ways through which you
can actually paste in the link.
>> Very cool. What else can we do with the editor?
>> Sure. Pasting images in Wiki is fairly straightforward.
>> Okay.
>> I could simply have it on my clipboard and I could paste it in.
So as you can see,
what happened is that it,
as I pasted it in, it start rendering right here.
Pasting images in Markdown can be a complex process.
But then, we've really tried to make it super simple here.
An alternate of pasting images
would be to just click on the "Spin",
and then select the relevant images from your PC and share it.
>> I like that pasting things so
much because that's always
a pain when you're working with Markdown.
>> That's right.
>> Love it. All right.
>> Alternately, you could just drag and drop it in,
which is also pretty handy.
>> Nice, nice, nice. So we're making just the
whole editing the Markdown experience so much nicer and easier.
>> That's right.
>> Cool.
>> Yeah. Next up,
I'm going to demonstrate how you can,
a feature that comes in pretty
handy while collaborating with some of my coworkers.
So you can actually add mention some of your coworkers.
What you need to do is to simply insert an "@",
and you type in their name,
pick it from the list, and simply insert it.
>> Very cool. So they get notified if they're attached to,
or not attached, but linked to a Wiki?
>> That's right. The moment you tag
someone and add mention someone,
they actually get an e-mail notification as well.
>> Nice.
>> So that's how it works.
>> Okay.
>> Azure DevOps Wiki is well
integrated with the rest of the Azure DevOps suite.
Documentation planning goes hand-in-hand.
>> Sure.
>> So you can also
reference work items from Azure Boards into the Azure DevOps Wiki.
>> Okay.
>> Let me demonstrate that.
I select here.
Click on the "#" over here.
Select the relevant work item I want to mention,
and it starts appearing there.
You can also see that there's
actually the status of the work item that gets up here.
As the status updates in Azure Boards,
the same updates are also reflected right here in Wiki,
eliminating the need of you having to manually update.
>> So all this info is live. Live data.
>> That's right.
>> Very, very cool. We can add
work items directly into our Wikis now.
>> That's right.
>> Sweet.
>> There is also some other suite capabilities
like being able to insert
query results and linking this page to another work items,
which we will talk at length in another video,
wherein we will be covering
Azure DevOps Wiki and Azure Boards specific scenarios.
>> Now, so there's deep integration between
our Wikis and the rest of the Azure DevOps.
>> That's right. Yeah.
>> Very nice. Is there anything else you wanted to show us?
>> Sure. So I'm going to save this page and close this.
>> Okay.
>> Let me demonstrate another page,
wherein I have created some sample pages.
So there's also support for each content like being able to create
[inaudible] or embedding videos and mathematical formulas.
>> Yeah.
>> If you want to create like more fancy-looking pages,
there's also support for that.
You can use "Embedded HTML",
and really get a control on the look and feel of the page.
>> Very, very cool. So we've now created
just a very nice Markdown editor
that lets us create these super-rich Wikis super easily.
That's pretty much it, right?
>> Right. Another thing that I'd really like to
talk about here is the Follow Functionality.
>> Okay.
>> So it's really important for you to be able
to track what updates are being made
to certain document which are relevant to you,
and this is where the Follow Functionality comes in.
>> Okay.
>> So there's this "Follow" button right here.
When I click it, I actually subscribe to e-mail notifications.
Any updates that the page receives,
I am going to be notified on e-mail
about the updates that just happened to the page.
>> Right. So you get notifications. Very, very nice.
This is powerful, flexible, awesome stuff.
>> Right.
>> Yeah. All right. So you've shown us
some amazing capabilities where we can create super-rich Wikis,
but one of the things that I need desperately not
only is the ability to create these Wikis,
I need to be able to search them.
So how can we search using Azure DevOps Wiki?
>> That's right. So being able to search and get to
the right information is really important in a team.
>> Sure.
>> That's where the Wiki Search kicks in.
>> Okay.
>> It's powered by Elasticsearch and anything that you type
into the Azure DevOps Wiki gets indexed.
So as soon as I typing a string over here and search it,
I'm able to get right to it.
>> Okay. Very, very cool.
That's also very popular.
All right. This has been some amazing stuff that you've shown us.
Now, not only do we have the capability
of having Wikis inside of Azure DevOps,
but it seems like it's super easy to edit it,
manage it, and search, correct?
>> That's right.
>> All right. So all you Devs out there, go to dev.azure.com.
Create an Azure DevOps account,
and go ahead and start playing with the Wikis.
Tell us what you love about it and what you hate about it,
so we can make Azure DevOps the ultimate DevOps tool.
Everyone out there, thank you so
much for joining us on this episode.
Next time, we will see you as well. Thank you.
[MUSIC]