Lightnews — Scholar-powered news

Sean D Wheeler @sdwheeler.bsky.social · Aug 12

Day 1 of #TechMentor is done. We had a great time and a great audience.

1 1 6

Sean D Wheeler @sdwheeler.bsky.social · Aug 4

I am happy to announce that PlatyPS v1.0 has reached GA and we have updated our publishing pipelines to use the new tool.

To celebrate, I created this: sdwheeler.github.io/seanonit/blo...

The Legend of PlatyPS and Content Wrangler

Telling the story of PlatyPS using Microsoft Copilot.

sdwheeler.github.io

5 7

Reposted by Sean D Wheeler

TechMentor @techmentorevents.bsky.social · Jul 30

(1/4) Meet @sdwheeler.bsky.social, Principal Content Developer for PowerShell at @Microsoft.com, the person who’s been leading PowerShell documentation since 2017, and VSLive @ Microsoft HQ speaker.

2 2 2

Sean D Wheeler @sdwheeler.bsky.social · Jun 12

I am speaking at TechMentor @ Microsoft HQ in August.
PROMO CODE: Wheeler
HOMEPAGE LINK: techmentorevents.com/events/micro...
REGISTRATION LINK – WITH PROMO CODE: bit.ly/3ZpZYWN

1 2

Reposted by Sean D Wheeler

TechMentor @techmentorevents.bsky.social · Jun 12

Tired of rewriting your #PowerShell profile for every #OS?

@sdwheeler.bsky.social‬ will tackle that topic in his session at #TechMentor @ Microsoft HQ.

Find out more about PowerShell and the session in his Q&A with @redmondit.bsky.social‬! redmondmag.com/articles/202...

3 4

Sean D Wheeler @sdwheeler.bsky.social · Apr 6

Makes me nostalgic for my Windows Phone

1 13

Sean D Wheeler @sdwheeler.bsky.social · Mar 12

Check out the 3 new blog posts:
- devblogs.microsoft.com/powershell/a...
- devblogs.microsoft.com/powershell/g...
- devblogs.microsoft.com/powershell/e...

1 1

Sean D Wheeler @sdwheeler.bsky.social · Mar 5

Here is the definition for PowerShell - github.com/toptal/gitig...

1

Sean D Wheeler @sdwheeler.bsky.social · Feb 14

Yes, I would accept a PR for this. We still maintain the 5.1 docs. We don't need repro steps, just a NOTE added to the parameter similar to what we have for `-Include`.

1 1

Reposted by Sean D Wheeler

steve--lee.bsky.social @steve--lee.bsky.social · Jan 16

Thanks to the PSCommunity, I've decided to finally join Bluesky. Will use this to post any updates to our projects: PS7, OpenSSH (Windows), DSC, PSGallery/PSResourceGet, etc...

10 17 69

Sean D Wheeler @sdwheeler.bsky.social · Jan 9

The sidebar nav was removed from the Learn platform and replaced with the list of suggested articles. I don't like it, but is it a platform design decision that I, as an writer, can't change.

1 1

Sean D Wheeler @sdwheeler.bsky.social · Jan 9

We have a style guide for the docs. There is an unofficial code style guide at: github.com/PoshCode/Pow...

GitHub - PoshCode/PowerShellPracticeAndStyle: The Unofficial PowerShell Best Practices and Style Guide

The Unofficial PowerShell Best Practices and Style Guide - PoshCode/PowerShellPracticeAndStyle

github.com

1

Sean D Wheeler @sdwheeler.bsky.social · Jan 9

How would you organize the documentation? It is not a simple task. There are lots of different kinds of docs. And docs are written for different purposes and audiences. There is a difference between reference docs and teaching docs.

2 1

Sean D Wheeler @sdwheeler.bsky.social · Jan 8

Specifically, the articles in the learn.microsoft.com/en-us/powers... were written by Bruce Payette. It is legacy content that was originally publish as a Word doc. We don't intend to change. It is provided for historical reference. It is was written for v3 and isn't 100% accurate for v7+.

Windows PowerShell Language Specification 3.0 - PowerShell

This Language Specification describe the syntax, semantics, and behavior of the PowerShell language.

learn.microsoft.com

2 2

Sean D Wheeler @sdwheeler.bsky.social · Jan 8

Yes, there is an official style. We try to make all of the documentation adhere to our style. Caveats:
1. We maintain over 9000 documents for PowerShell and the PowerShell SDK.
2. Much of that content was written by others, long before I joined the team.
3. We fix the style as we go.

5

Sean D Wheeler @sdwheeler.bsky.social · Dec 11

learn.microsoft.com/en-us/powers...

Microsoft.PowerShell.PlatyPS Module - PowerShell

This module contains cmdlets to help with the creation help content for PowerShell commands.

learn.microsoft.com

2 1

Sean D Wheeler @sdwheeler.bsky.social · Dec 9

I had a fun time. Check it out.

Dave Carroll @thedavecarroll.com · Dec 9

This week's #PowerShellPodcast, with host @andrewpla.tech and guest @sdwheeler.bsky.social

#PowerShell #Automation #Community #DevOps #SysAdmin

youtu.be/RHPSSKjqZJw

PowerShell Evolution with Sean Wheeler: What's new in PS 7.5, AIShell, & More! The PS Podcast E148

YouTube video by PDQ

youtu.be

3 7 18

Sean D Wheeler @sdwheeler.bsky.social · Dec 7

I am pleased to share that my 90min session about creating PowerShell documentation using the new version of PlatyPS was accepted for #pshsummit. See you there in April!

2 6 20

Sean D Wheeler @sdwheeler.bsky.social · Nov 21

Love the split pane integration!

stevenbucher13.bsky.social @stevenbucher13.bsky.social · Nov 20

Announcing AI Shell, your CLI companion to connect you to advanced AI assistants like #Copilot in #Azure. Learn more at aka.ms/AIShell #MSIgnite #PowerShell #CLI #AI

Announcing the Public Preview of AI Shell - PowerShell Team

We are pleased to announce the public preview of AI Shell.

aka.ms

1

Sean D Wheeler @sdwheeler.bsky.social · Nov 7

This works:

$c.RelatedLinks.Add([Microsoft.PowerShell.PlatyPS.Model.Links]::new('Text','https://url.com/document'))

1 2

Sean D Wheeler @sdwheeler.bsky.social · Nov 7

Check the Diagnostics property of the CommandHelp object.

1

Sean D Wheeler @sdwheeler.bsky.social · Nov 7

The answer is to update the object before exporting to markdown.

1 1

Sean D Wheeler @sdwheeler.bsky.social · Nov 7

The help text for the placeholders has to come from somewhere. It is not embedded in compiled commands.

1

Sean D Wheeler @sdwheeler.bsky.social · Nov 7

No, the older module has the same placeholders. In either version, if you are documenting script-based modules, PlatyPS will include the comment-based help. But there is embedded documentation like that for C#-compiled cmdlets.

1 1

Sean D Wheeler @sdwheeler.bsky.social · Nov 7

New-CommandHelp creates an object instead of a markdown file. You can then populate the properties of the object before exporting it to markdown.

1 2