>> 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]
