Описание параметра оформить в виде таблицы

[sergey-s-betke]

Сейчас описание параметра выглядит следующим образом:

• TranslateRules <Array>
  Правила для обработки readme регулярными выражениями

  Требуется? false
  Позиция? named
  Значение по умолчанию
  Принимать входные данные конвейера?false
  Принимать подстановочные знаки?
  

Целесообразно оформить следующим образом:

• TranslateRules <Array>
  Правила для обработки readme регулярными выражениями

  Требуется?	false
  Позиция?	named
  Значение по умолчанию
  Принимать входные данные конвейера?	false
  Принимать подстановочные знаки?

[sergey-s-betke]

Однако, "читабельность" текстового файла при этом существенно страдает. Возможно, подобное оформление имеет смысл использовать только по соответствующему флагу.

[sergey-s-betke]

Для этого до описания параметров добраться можно так:

( $FunctionInfo ).Parameters.Values

[sergey-s-betke]

Потребуется чтение локализованных ресурсов сборок PowerShell:

$asm = [System.Reflection.Assembly]::Load('System.Management.Automation')
$rm = New-Object -Type 'System.Resources.ResourceManager' -ArgumentList 'HelpDisplayStrings', $asm
$rm.GetString('AcceptsPipelineInput')

чтобы получить все ресурсы сборки:

$rs = $rm.GetResourceSet( ( Get-UICulture ) , $true, $true )
$rs

[sergey-s-betke]

В принципе, задача решена именно так, как и поставлена - таблицу сформировал (комит выше). Однако - в таблицах не раскрываются концевые сноски! Да и оформление таблиц слишком громоздко выглядит как в текстовом файле, так и после конвертации в html в дизайне github. Посему имеет смысл подумать о вложенных списках, а не о таблицах...

[sergey-s-betke]

Остановился на варианте со списком. Такой вариант выглядит куда более читабельно как в случае простого txt файла, так и в случае html, полученного по .md файлу.

Данный вопрос на этом закрываю. Выбирать прочие форматы для генерации описаний можно через реализацию и использование собственных форматов (#68).