How To Deploy MkDocs to Azure In 5 Minutes With Azure DevOps
Read full transcript 16 segments
-
hello and welcome back to my channel my hello and welcome back to my channel my name is Misha and I talk about Azure name is Misha and I talk about Azure name is Misha and I talk about Azure devops and infrastructures code and devops and infrastructures code and devops and infrastructures code and today I want to give a bit of a today I want to give a bit of a today I want to give a bit of a demonstration of deploying make docs to demonstration of deploying make docs to demonstration of deploying make docs to azure I started this little project on azure I started this little project on azure I started this little project on my day off because at work we were my day off because at work we were my day off because at work we were discussing or moving away from discussing or moving away from discussing or moving away from SharePoint for our documentation and I SharePoint for our documentation and I SharePoint for our documentation and I was very happy to hear that because I was very happy to hear that because I was very happy to hear that because I love markdown and I think that's a much love markdown and I think that's a much love markdown and I think that's a much better way to have have your content and better way to have have your content and better way to have have your content and make docs has been on my radar for a make docs has been on my radar for a make docs has been on my radar for a while but I haven't played around with while but I haven't played around with while but I haven't played around with it so I had my day off I thought I want it so I had my day off I thought I want it so I had my day off I thought I want to play around with it and then I uh to play around with it and then I uh to play around with it and then I uh discovered how I can deploy it to Azure discovered how I can deploy it to Azure discovered how I can deploy it to Azure and I want to share it with you today so and I want to share it with you today so and I want to share it with you today so what is make docs make docs is a yeah what is make docs make docs is a yeah what is make docs make docs is a yeah it's a static website generator it's a static website generator it's a static website generator basically you create a collection of basically you create a collection of basically you create a collection of markdown files and make Docs markdown files and make Docs markdown files and make Docs generates an HTML static website from generates an HTML static website from generates an HTML static website from that very much like my my own website that very much like my my own website that very much like my my own website this is done with Hugo and it's just a this is done with Hugo and it's just a this is done with Hugo and it's just a GitHub repo with markdown files and Hugo GitHub repo with markdown files and Hugo GitHub repo with markdown files and Hugo generates a website out of this and make generates a website out of this and make generates a website out of this and make docs does the same this website is docs does the same this website is docs does the same this website is actually generated by make Doc so here actually generated by make Doc so here actually generated by make Doc so here you see already how how it's going to you see already how how it's going to you see already how how it's going to look look look one other example is for example the one other example is for example the one other example is for example the Argo CD documentation Argo CD documentation Argo CD documentation this is also this is also generated with make Docs so this is also generated with make Docs so you probably recognize this layout it's you probably recognize this layout it's you probably recognize this layout it's a very a very a very it's used a lot in the in the open
-
it's used a lot in the in the open it's used a lot in the in the open source community and it's just a nice source community and it's just a nice source community and it's just a nice way of generating searchable content so way of generating searchable content so way of generating searchable content so the search works really well so if I go the search works really well so if I go the search works really well so if I go and search for secrets for example here and search for secrets for example here and search for secrets for example here you get as you see the search works you get as you see the search works you get as you see the search works really well and it's just a very nice uh really well and it's just a very nice uh really well and it's just a very nice uh nice looking very smooth looking way of nice looking very smooth looking way of nice looking very smooth looking way of pres organizing and presenting your pres organizing and presenting your pres organizing and presenting your documentation documentation documentation so it's it's very easy to to actually so it's it's very easy to to actually so it's it's very easy to to actually deploy this and um I uh I'm going to deploy this and um I uh I'm going to deploy this and um I uh I'm going to show you that show you that show you that so to start you need to have an Azure so to start you need to have an Azure so to start you need to have an Azure devops organization I'm going to be devops organization I'm going to be devops organization I'm going to be using Azure devops for this example and using Azure devops for this example and using Azure devops for this example and in the organization you create a in the organization you create a in the organization you create a repository so you just go to repos and repository so you just go to repos and repository so you just go to repos and then you to do new repository and then I then you to do new repository and then I then you to do new repository and then I created this make Doc and this is the created this make Doc and this is the created this make Doc and this is the standard repository that you get it's standard repository that you get it's standard repository that you get it's just empty just empty just empty so I'm going to clone this so I'm going to clone this so I'm going to clone this and all right just all right just clone I'll go to my repos and clone I'll go to my repos and clone I'll go to my repos and git clone so now I have my make dock repo on my so now I have my make dock repo on my local computer and I go into it so uh
-
and I go into it so uh let's just take a look at the getting let's just take a look at the getting let's just take a look at the getting started the guide of make docs it's a started the guide of make docs it's a started the guide of make docs it's a very very good guide it it says to very very good guide it it says to very very good guide it it says to install pip install make docs I've install pip install make docs I've install pip install make docs I've already done that but that's if you have already done that but that's if you have already done that but that's if you have python running on your computer python running on your computer python running on your computer then you can install make docs this way then you can install make docs this way then you can install make docs this way and then it says make docs new my and then it says make docs new my and then it says make docs new my project and CD into it well since we project and CD into it well since we project and CD into it well since we have our repo here I'll just go one have our repo here I'll just go one have our repo here I'll just go one layer back so this is the repository so layer back so this is the repository so layer back so this is the repository so I'll do make docs new MK dock and now if we go into the MK doc and now if we go into the MK doc repository again repository again repository again we see that there are a few files in we see that there are a few files in we see that there are a few files in here here here get status get status get status it created a docs folder and a make it created a docs folder and a make it created a docs folder and a make docs.yabel and let's take a look at that docs.yabel and let's take a look at that docs.yabel and let's take a look at that make docs.yaml here it just says the make docs.yaml here it just says the make docs.yaml here it just says the site name and my Docs site name and my Docs site name and my Docs so that that's and if you go into docs so that that's and if you go into docs so that that's and if you go into docs here then there are a few markdown files here then there are a few markdown files here then there are a few markdown files in here already and this is actually the in here already and this is actually the in here already and this is actually the the contents from which it will generate the contents from which it will generate the contents from which it will generate the website the website the website so you gen you have a collection of so you gen you have a collection of so you gen you have a collection of markdown files and now you have to markdown files and now you have to markdown files and now you have to create a website out of it so how does create a website out of it so how does create a website out of it so how does that work that work that work this works by running the this works by running the this works by running the make docs build command from within the make docs build command from within the make docs build command from within the Repository Repository Repository and now you see we have a site directory and now you see we have a site directory and now you see we have a site directory in here in here in here and if I just list that then you see it
-
and if I just list that then you see it and if I just list that then you see it has a index HTML sitemap XML Etc so I has a index HTML sitemap XML Etc so I has a index HTML sitemap XML Etc so I just created a full website out of those just created a full website out of those just created a full website out of those markdown files that we have so that's markdown files that we have so that's markdown files that we have so that's how it works underwater how it works underwater how it works underwater um um um I'm going to delete that directory again sites because sites because we want to deploy this to Azure so how we want to deploy this to Azure so how we want to deploy this to Azure so how do we do that we go I go into my Azure do we do that we go I go into my Azure do we do that we go I go into my Azure subscription here subscription here subscription here and I go and search for static web apps and I go and search for static web apps and I go and search for static web apps and I'm going to create a new one so I'm going to be putting it in a new so I'm going to be putting it in a new Resource Group let me just zoom in here Resource Group let me just zoom in here Resource Group let me just zoom in here for you for you for you here's my subscription and if you enter here's my subscription and if you enter here's my subscription and if you enter the name make Docs the name make Docs the name make Docs Misha Misha Misha then you see it creates a new Resource then you see it creates a new Resource then you see it creates a new Resource Group here for the static web app Group here for the static web app Group here for the static web app so that's what I'll do so that's what I'll do so that's what I'll do I want to put it in West Europe I want to put it in West Europe I want to put it in West Europe and here I click azure devops and here I click azure devops and here I click azure devops my organization is this one my organization is this one my organization is this one this is my project this is my project this is my project and here is this make Doc repository and here is this make Doc repository and here is this make Doc repository that I just created right so you do this and then you and then I so you do this and then you and then I pick the main branch for now and for the build presets as you saw we and for the build presets as you saw we we used as you saw the make docs created
-
we used as you saw the make docs created we used as you saw the make docs created a HTML website so that's what we'll use a HTML website so that's what we'll use a HTML website so that's what we'll use here as well here as well here as well now the app location is going to be what now the app location is going to be what now the app location is going to be what we saw here we saw site we saw here we saw site we saw here we saw site so that's why I want to serve the so that's why I want to serve the so that's why I want to serve the content from content from content from so we enter site here so we enter site here so we enter site here and the rest we leave as default and the rest we leave as default and the rest we leave as default and we can review and create this and we can review and create this and we can review and create this so just going to create a free static so just going to create a free static so just going to create a free static web app for us it takes a few seconds and here we go it takes a few seconds and here we go our static web app is completed um it is not like if I go to the URL now um it is not like if I go to the URL now here here here it is still live and waiting for the it is still live and waiting for the it is still live and waiting for the content content content but if I go to my Azure devops but if I go to my Azure devops but if I go to my Azure devops organization you see that there's a organization you see that there's a organization you see that there's a pipeline running here now pipeline running here now pipeline running here now so this pipeline is now taking the so this pipeline is now taking the so this pipeline is now taking the contents of the GitHub repo and serving contents of the GitHub repo and serving contents of the GitHub repo and serving that as a web app that as a web app that as a web app but there is something missing here but there is something missing here but there is something missing here we are not actually generating the we are not actually generating the we are not actually generating the website yet right website yet right website yet right as you see here it will fail and let's as you see here it will fail and let's as you see here it will fail and let's see what it says yeah the directory site is invalid so we yeah the directory site is invalid so we have to make a few adjustments on the have to make a few adjustments on the have to make a few adjustments on the pipeline pipeline pipeline so if we go back to our repository we'll
-
so if we go back to our repository we'll so if we go back to our repository we'll see that the the make docs repository see that the the make docs repository see that the the make docs repository now has a pipeline in it see now has a pipeline in it see now has a pipeline in it see so this is you create the web app you so this is you create the web app you so this is you create the web app you point it to the repository and then point it to the repository and then point it to the repository and then Azure generates this pipeline for you Azure generates this pipeline for you Azure generates this pipeline for you so if I go to my repo again and I do a so if I go to my repo again and I do a so if I go to my repo again and I do a git pull we'll see that we have the pipeline here we'll see that we have the pipeline here so let's take a look at the pipeline so let's take a look at the pipeline so let's take a look at the pipeline so this pipeline so this pipeline so this pipeline it includes the main branch and is it includes the main branch and is it includes the main branch and is triggered by the main branch so if I triggered by the main branch so if I triggered by the main branch so if I make commits to the main branch now then make commits to the main branch now then make commits to the main branch now then it will run this pipeline it will run this pipeline it will run this pipeline it will use an Ubuntu latest image and it will use an Ubuntu latest image and it will use an Ubuntu latest image and it will it will it will check out the repository and then it check out the repository and then it check out the repository and then it will take the site location and it will will take the site location and it will will take the site location and it will create it will build the web app out of create it will build the web app out of create it will build the web app out of it and you see here that it has created it and you see here that it has created it and you see here that it has created an Azure static web apps API token this an Azure static web apps API token this an Azure static web apps API token this is done by Azure and you can find this is done by Azure and you can find this is done by Azure and you can find this in your Azure devops organization in your Azure devops organization in your Azure devops organization if you go to your if you go to your if you go to your environment no if you go to your library environment no if you go to your library environment no if you go to your library you will see here that two minutes ago a you will see here that two minutes ago a you will see here that two minutes ago a variable group a variable group for the variable group a variable group for the variable group a variable group for the static web app was created by azure static web app was created by azure static web app was created by azure so that's what this means so that's what this means so that's what this means now in this pipeline we have to still do now in this pipeline we have to still do now in this pipeline we have to still do a couple of things because as we saw in a couple of things because as we saw in a couple of things because as we saw in the make docs guide in order to generate
-
the make docs guide in order to generate the make docs guide in order to generate the website you have to run the make the website you have to run the make the website you have to run the make docs build command docs build command docs build command right so right so right so let's do that we have to let's do that we have to let's do that we have to include a step here where it will include a step here where it will include a step here where it will actually build the the the make docs website from it and then serve make docs website from it and then serve the contents of the site directory as the contents of the site directory as the contents of the site directory as the web app the web app the web app so how do we do it we go to the steps so how do we do it we go to the steps so how do we do it we go to the steps and we add add a new step and we add add a new step and we add add a new step it's very simple it's very simple it's very simple we just run a bash command and we're going to run a few commands and we're going to run a few commands but for now we'll just do it like this but for now we'll just do it like this but for now we'll just do it like this pip install make Docs pip install make Docs pip install make Docs and then we do make docs build so when we do this that then in this so when we do this that then in this environment so when we run the pipeline environment so when we run the pipeline environment so when we run the pipeline a container is spun up it will check out a container is spun up it will check out a container is spun up it will check out the repo and it will run these commands the repo and it will run these commands the repo and it will run these commands and then actually the site directory and then actually the site directory and then actually the site directory will be there will be there will be there so I'm going to so I'm going to so I'm going to save this and then I'm going to commit save this and then I'm going to commit save this and then I'm going to commit this commit and commit and adjust pipeline push it to my repo push it to my repo and now because it's triggered on the and now because it's triggered on the and now because it's triggered on the main branch we should see that the main branch we should see that the main branch we should see that the pipeline is running
-
pipeline is running pipeline is running so let's take a look so let's take a look so let's take a look Pipelines Pipelines Pipelines and here we go it is running we can take a look at what it's actually we can take a look at what it's actually doing doing doing it has installed the it has installed the it has installed the make Docs make Docs make Docs and it did the make docs build as you and it did the make docs build as you and it did the make docs build as you see here see here see here so now there was actually a site so now there was actually a site so now there was actually a site directory and now the Azure static web directory and now the Azure static web directory and now the Azure static web app app app step is going to take the contents of step is going to take the contents of step is going to take the contents of the site directory build a web app out the site directory build a web app out the site directory build a web app out of it and make it available for of it and make it available for of it and make it available for connection and here we go the pipeline is finished and here we go the pipeline is finished so if I go back to my web app now and if so if I go back to my web app now and if so if I go back to my web app now and if I refresh I refresh I refresh here we go we have our make docs website here we go we have our make docs website here we go we have our make docs website doesn't that look nice doesn't that look nice doesn't that look nice here it says my docs it has everything here it says my docs it has everything here it says my docs it has everything okay so let's give this a little bit okay so let's give this a little bit okay so let's give this a little bit more of content now more of content now more of content now so so so we have our we have our we have our this is the structure of the repository this is the structure of the repository this is the structure of the repository now you have the pipeline file now you have the pipeline file now you have the pipeline file you have the docs directory and the make you have the docs directory and the make you have the docs directory and the make docs.yaml for the docs.yaml for the docs.yaml for the for the for the contents now for the for the for the contents now for the for the for the contents now for the configuration of mcdocs excuse me configuration of mcdocs excuse me configuration of mcdocs excuse me so let's start with changing the site so let's start with changing the site so let's start with changing the site name so Misha's name so Misha's name so Misha's awesome awesome awesome Docs and then we are going to add some
-
and then we are going to add some content so let's go to the docs content so let's go to the docs content so let's go to the docs directory directory directory and I want to create a and I want to create a and I want to create a a document about running so let's do a document about running so let's do a document about running so let's do running.md and it's all markdown so running I and it's all markdown so running I really love running really love running really love running it is very healthy it is important it is important to start slowly to start slowly to start slowly and build up and build up and build up from there from there from there okay now we have a running document and okay now we have a running document and okay now we have a running document and let's say we have another category and let's say we have another category and let's say we have another category and we call that diet we call that diet we call that diet then we actually want to create a then we actually want to create a then we actually want to create a directory called diet directory called diet directory called diet and then in diet we have for example and then in diet we have for example and then in diet we have for example calories calories calories dot MD and we'll call this and we'll call this counting calories counting calories counting calories and I'm just going to add some Lauren ipsum here Lauren ipsum here so we have some text and in diet we can so we have some text and in diet we can so we have some text and in diet we can also add say vegan.md also add say vegan.md also add say vegan.md vegan vegan diet and then again we'll do vegan vegan diet and then again we'll do vegan vegan diet and then again we'll do some lorem ipsum and let's say in diet we also have
-
and let's say in diet we also have vegetables lorem ipsum okay lorem ipsum okay so let's so let's so let's now we have some more documentation we now we have some more documentation we now we have some more documentation we added a running document and we had a added a running document and we had a added a running document and we had a subcategory so let's push that to our subcategory so let's push that to our subcategory so let's push that to our repo I open lazygit add all of them repo I open lazygit add all of them repo I open lazygit add all of them commit and then add diets and running commit and then add diets and running commit and then add diets and running and shift B and it will push it to my and shift B and it will push it to my and shift B and it will push it to my repo and the pipeline should run again and the pipeline should run again pipeline is running so it's going to run now I'll just fast so it's going to run now I'll just fast forward to when it's finished and here we go the pipeline has finished and here we go the pipeline has finished and I go back to my make docs website and I go back to my make docs website and I go back to my make docs website refresh and here it says Misha's awesome refresh and here it says Misha's awesome refresh and here it says Misha's awesome docs and here we have our running docs and here we have our running docs and here we have our running document document document I really love running it is very healthy I really love running it is very healthy I really love running it is very healthy and here we also have a diet subcategory and here we also have a diet subcategory and here we also have a diet subcategory with our counting calories with our counting calories with our counting calories and vegan diets and vegan diets and vegan diets sub-documents sub-documents sub-documents so this is the standard theme of make so this is the standard theme of make so this is the standard theme of make docs but one very popular theme for for docs but one very popular theme for for docs but one very popular theme for for it is material it is material it is material and I really like this one I think this
-
and I really like this one I think this and I really like this one I think this is also the one that is being used by is also the one that is being used by is also the one that is being used by Argo CD Argo CD Argo CD so let's set that up and it's also very so let's set that up and it's also very so let's set that up and it's also very easy easy easy as you see here all we have to do is do as you see here all we have to do is do as you see here all we have to do is do another pip install make docs material another pip install make docs material another pip install make docs material and then we have to add the theme and then we have to add the theme and then we have to add the theme material to it material to it material to it so let's just adjust our Pipeline with so let's just adjust our Pipeline with so let's just adjust our Pipeline with that we open our pipeline we open our pipeline and and and it said we have to pip install make docs it said we have to pip install make docs it said we have to pip install make docs material material material let's just double check that let's just double check that let's just double check that make docs material here we go so we add make docs material here we go so we add make docs material here we go so we add that to the list of packages that we that to the list of packages that we that to the list of packages that we want to install want to install want to install and then in our and then in our and then in our make docs.yaml we have to add theme we have to add theme and and and name material name material name material that's it that's it that's it that should be everything this should that should be everything this should that should be everything this should regenerate the website with a new theme regenerate the website with a new theme regenerate the website with a new theme so so so then when we load the website here we then when we load the website here we then when we load the website here we should have a bit of a different theme should have a bit of a different theme should have a bit of a different theme okay so let's try it out okay so let's try it out okay so let's try it out I'll go back I open lazygit I'll go back I open lazygit I'll go back I open lazygit I add my changes I commit add theme I add my changes I commit add theme I add my changes I commit add theme and with shift p I push it
-
and with shift p I push it and with shift p I push it and the pipeline should run now and the pipeline should run now and the pipeline should run now let's take a look pipelines here we go it's running and pipelines here we go it's running and I'll be right back I'll be right back I'll be right back and okay our pipeline is finished and okay our pipeline is finished and okay our pipeline is finished so now when I refresh this page it so now when I refresh this page it so now when I refresh this page it should have a completely new theme Here should have a completely new theme Here should have a completely new theme Here refresh yes and it worked refresh yes and it worked refresh yes and it worked so now you see that the running page is so now you see that the running page is so now you see that the running page is located over here located over here located over here and when I go to diet here and when I go to diet here and when I go to diet here it has this counting calories and vegan it has this counting calories and vegan it has this counting calories and vegan diet and so forth diet and so forth diet and so forth so you see how powerful this is it's so you see how powerful this is it's so you see how powerful this is it's very easy to get going all you need is a very easy to get going all you need is a very easy to get going all you need is a few markdown files and the search few markdown files and the search few markdown files and the search functionality is also very good so if I functionality is also very good so if I functionality is also very good so if I search for calorie here it will go here search for calorie here it will go here search for calorie here it will go here if I go to health it says running is if I go to health it says running is if I go to health it says running is very healthy so it works really well very healthy so it works really well very healthy so it works really well now lastly now I've just been pushing now lastly now I've just been pushing now lastly now I've just been pushing directly to the main branch so let's try directly to the main branch so let's try directly to the main branch so let's try and do this using a pull request so okay and do this using a pull request so okay and do this using a pull request so okay we have created our make docs repository we have created our make docs repository we have created our make docs repository our team is adding all of the our team is adding all of the our team is adding all of the documentation to it and you cannot just documentation to it and you cannot just documentation to it and you cannot just push to the main branch anymore now you push to the main branch anymore now you push to the main branch anymore now you have to add a pull request have to add a pull request have to add a pull request so I have a team member and he started so I have a team member and he started so I have a team member and he started a different diet recently for example a different diet recently for example a different diet recently for example and uh or no no let's do something else
-
and uh or no no let's do something else and uh or no no let's do something else let's add I added one running maybe let's add I added one running maybe let's add I added one running maybe someone likes climbing so I'll do a someone likes climbing so I'll do a someone likes climbing so I'll do a climbing climbing climbing dot MD dot MD dot MD and I'll name this the great climbing and I'll name this the great climbing and I'll name this the great climbing collection collection collection here we can collect links and resources here we can collect links and resources here we can collect links and resources for climbing for climbing for climbing and let's add a and let's add a and let's add a search search search Google link just Google link just Google link just improvising something just adding a link here okay just adding a link here okay now I've now I've now I've added this document and now I want to added this document and now I want to added this document and now I want to create a pull request so I've been using create a pull request so I've been using create a pull request so I've been using lazy git up until now but let's do it lazy git up until now but let's do it lazy git up until now but let's do it the the fat the old-fashioned way so I the the fat the old-fashioned way so I the the fat the old-fashioned way so I do git add Dot get checkout Branch get checkout Branch add climbing git commit git commit um um um climbing and git push and git push and then you have to do the setup stream okay so it added a new branch okay so it added a new branch and now we should be able to create a
-
and now we should be able to create a and now we should be able to create a pull request pull request pull request so we go back to Azure devops we go to so we go back to Azure devops we go to so we go back to Azure devops we go to our repo and here you see you updated ad our repo and here you see you updated ad our repo and here you see you updated ad climbing just now climbing just now climbing just now so let's create a pull request add so let's create a pull request add so let's create a pull request add climbing we can see our changes and here it is here is our pull request and here it is here is our pull request so so so then someone from our team would come then someone from our team would come then someone from our team would come along and he would take a look and yeah along and he would take a look and yeah along and he would take a look and yeah okay this document looks great we want okay this document looks great we want okay this document looks great we want to add this so just to demonstrate the to add this so just to demonstrate the to add this so just to demonstrate the pipeline is not running yet because we pipeline is not running yet because we pipeline is not running yet because we haven't committed to the main branch haven't committed to the main branch haven't committed to the main branch there's just a pull request here there's just a pull request here there's just a pull request here okay so we create we go to the pull okay so we create we go to the pull okay so we create we go to the pull request request request our team has reviewed it let's complete our team has reviewed it let's complete our team has reviewed it let's complete it it it complete the merge and now after merging it and now after merging it the pipeline will run the pipeline will run the pipeline will run and after this is finished we should and after this is finished we should and after this is finished we should have a climbing document to our awesome have a climbing document to our awesome have a climbing document to our awesome website okay the pipeline is finished let's take okay the pipeline is finished let's take a look at our awesome website here a look at our awesome website here a look at our awesome website here we have welcome running and diet and now we have welcome running and diet and now we have welcome running and diet and now we should when I refresh here there we should when I refresh here there we should when I refresh here there should be a climbing document added should be a climbing document added should be a climbing document added and here we go the great climbing and here we go the great climbing and here we go the great climbing collection collection collection and here we can collect links and and here we can collect links and and here we can collect links and resources for climbing resources for climbing resources for climbing and the google.com did not work because
-
and the google.com did not work because and the google.com did not work because oh yeah I didn't add HTTP so it's not oh yeah I didn't add HTTP so it's not oh yeah I didn't add HTTP so it's not actually going to navigate to Google but actually going to navigate to Google but actually going to navigate to Google but anyway anyway anyway our document is added it all works so our document is added it all works so our document is added it all works so this here you see how easy how quickly this here you see how easy how quickly this here you see how easy how quickly it is to get going with make docs on it is to get going with make docs on it is to get going with make docs on azure you just need a repository you azure you just need a repository you azure you just need a repository you just need just need just need to set up a web app and to set up a web app and to set up a web app and I mean this is all the configuration I mean this is all the configuration I mean this is all the configuration that was needed for make docs in order that was needed for make docs in order that was needed for make docs in order to create a full website with a nice to create a full website with a nice to create a full website with a nice theme theme theme it's so easy it's so easy it's so easy and I highly recommend it I think it's a and I highly recommend it I think it's a and I highly recommend it I think it's a great thing to do it takes maybe 10 great thing to do it takes maybe 10 great thing to do it takes maybe 10 minutes to set up and then your team can minutes to set up and then your team can minutes to set up and then your team can start collecting documentation and start collecting documentation and start collecting documentation and uh we can review each other and deploy uh we can review each other and deploy uh we can review each other and deploy it automatically it's a just a great it automatically it's a just a great it automatically it's a just a great process and I highly recommend it to process and I highly recommend it to process and I highly recommend it to everybody and the great thing is is like everybody and the great thing is is like everybody and the great thing is is like now this is just out on the internet of now this is just out on the internet of now this is just out on the internet of course course course but when you go to your web app you can but when you go to your web app you can but when you go to your web app you can also configure it that you have Azure ID also configure it that you have Azure ID also configure it that you have Azure ID authentication towards it authentication towards it authentication towards it so you actually don't so you actually don't so you actually don't um you can't just access it directly um you can't just access it directly um you can't just access it directly from the internet you actually have to from the internet you actually have to from the internet you actually have to log in with your Azure ID and you have log in with your Azure ID and you have log in with your Azure ID and you have access control on that you can decide access control on that you can decide access control on that you can decide who and who can view the documents and who and who can view the documents and who and who can view the documents and who cannot and that's just a very nice who cannot and that's just a very nice who cannot and that's just a very nice way of shielding your documentation from way of shielding your documentation from way of shielding your documentation from the public if that's a requirement that the public if that's a requirement that the public if that's a requirement that you have you have you have so hopefully this has been useful to you
-
so hopefully this has been useful to you so hopefully this has been useful to you try it out I'll be putting this sample try it out I'll be putting this sample try it out I'll be putting this sample code in my repo and I'll link it down code in my repo and I'll link it down code in my repo and I'll link it down below let me know if this was useful to below let me know if this was useful to below let me know if this was useful to you and if you would like to see me you and if you would like to see me you and if you would like to see me trying something else trying something else trying something else thank you so much for watching and I'll thank you so much for watching and I'll thank you so much for watching and I'll see you in the next one bye bye
Summary
This transcript is a demonstration of deploying make docs, a static website generator, to Azure DevOps. The presenter highlights make docs' effectiveness for organizing and presenting documentation with excellent search functionality, referencing its use in projects like Argo CD. The practical takeaway is that make docs is easy to deploy and can be an excellent alternative to platforms like SharePoint for managing content.