Build your technical documentation site with docfx. Converts .NET assembly, XML code comment, REST API Swagger files and markdown into rendered HTML pages, JSON model or PDF files.
In a 14-minute developer-focused demo, Martin Heusser overviews the DocFX tool. He walks viewers through the setup process, explains why the tool is effective, and shows off the static website generated with DocFx. The demo encourages viewers to try DocFx and run the Initialize-AwesomeDocFx.ps1 script which produces a more substantial site. The process involves cloning a repo, creating a project, adding documentation and images to your project, and building your site using DocFx for SharePoint.
The process is recapped as follows:
This demo is part of the Microsoft 365 & Power Platform Development Community call recorded on June 8, 2023. The demo presenter is Martin Heusser from Houlihan Lokey.
Supporting materials for the demo include:
DocFX proves to be a valuable tool for developers, especially those who want a more structured, organized, and functional site. It allows developers to create their sites from scratch with seamless SharePoint integration, gives them the liberty to design it to their taste, and makes uploading files easier. DocFX also supports documentation generation, meaning developers can easily produce standardized documentation for their projects. This demo highlighted these features, further increasing DocFx's value in the developer community.
In this demo, Martin Heusser shows how to build a documentation website using DocFX on SharePoint. He explains why it is an awesome tool, the setup challenges, and where the generated static website can be hosted. He then demonstrates how to clone his repo, create a project, and generate an out-of-box site. He then runs the Initialize-AwesomeDocFx.ps1 script to yield a more robust site. He also shows how to add docs and images. For hosting the site on SPO, he runs the BuildDocFxForSPO.ps1 script, creates a document library, compares and uploads new files. The demo concludes with a recap of the process, which includes defining doc categories, initializing the DocFx project, authoring documentation, previewing the site locally, and publishing it.
DocFX, SharePoint, Microsoft 365, Power Platform, Development Community, Static Website, Document Library