Loading…
This event has ended. Visit the official site or create your own event on Sched.
We urge you to download the event brochure, which is full of useful information and details!

PowerShell + DevOps Global Summit is the gathering of PowerShell + DevOps professionals and enthusiasts. More than just a conference, it’s a true in-person gathering of a vibrant commuity - we learn from each other, we develop practices and standards, we share challenges and solutions, and we drive our industry forward. If you’re working with PowerShell, Desired State Configuration, and related technologies, and especially if you’re moving your organization toward a DevOps footing, then this is the 400+ level event you’ve been looking for. Be sure to grab our event app for your iOS or Android device!

Once you’re registered (use the Tickets tab, below), you’ll be authorized to this site, and be able to build and maintain your personal agenda for the event. Check back often as the event draws near, as this is where we’ll publish any last-minute session changes or other agenda updates. If you already registered and didn’t receive your invite email to Sched.com, just go here and use your registered email address and EventBrite order number to gain access.

DOWNLOADS: Event brochure | Sponsorship information
Back To Schedule
Wednesday, April 11 • 9:00am - 10:45am
PlatyPS: PowerShell Help meets Markdown

Log in to save this to your schedule, view media, leave feedback and see who's attending!

Feedback form is now closed.
  PlatyPS solves a long standing pain of writing PowerShell external help xmls. Now you can write help in markdown and verify that it reflects the code. PlatyPS brings modern markdown-based workflows to the PowerShell help authoring. We will take a deep dive in the PowerShell help engine and platyPS.
  PlatyPS solves a long standing pain of writing PowerShell external help xmls.It provides a way to
* Write PowerShell External Help in Markdown
* Generate markdown help for your existing modules
* Keep markdown help up-to-date with your code
* Generate help artifacts (maml xmls and online help archives) from markdown and ship them with your modules
  Traditionally PowerShell external help files have been authored by hand or using complex tool chains and rendered as MAML XML for use as console help.
  MAML is cumbersome to edit by hand, and common tools and editors don't provide good support for working with it.
Markdown is a very easy markup language which became a standard for writing documentation.
  We will take a look at existing big projects that are using it (like Azure and PowerShell-Docs) and some smaller projects (like PSReadLine). We will go through a (very easy!) bootstrap process for using platyPS in an existing project. We will also cover how to make sure that documentation is up to date and even add tests to your CI pipeline to make sure that documentation is always updated.
  In the second part of the talk, we will take a deep dive into platyPS internals. We will talk about markdown schema, quirks of PowerShell help engine and tool limitations. We will also cover advanced topics, like combining few different versions of your module help into a single markdown document.
  Every part of the talk will be accompanied by hands on live demos.

Speakers

platyPS pptx

Wednesday April 11, 2018 9:00am - 10:45am PDT
404 - Meydenbauer Center