ArgumentsUnion

PackageFsLiveDocs
Defines the supported command-line arguments for the livedocs tool.

Specification

Kind
Union
Members
54
Examples
0
IsOutputSignature
this.IsOutput
IsDry_RunSignature
this.IsDry_Run
IsUrlSignature
this.IsUrl
IsHistory_AddSignature
this.IsHistory_Add
IsDiscover_ProjectsSignature
this.IsDiscover_Projects

Summary

NameSignatureSynopsis
Union cases
IsOutputthis.IsOutputNo description available.
IsDry_Runthis.IsDry_RunNo description available.
IsUrlthis.IsUrlNo description available.
IsHistory_Addthis.IsHistory_AddNo description available.
IsDiscover_Projectsthis.IsDiscover_ProjectsNo description available.
IsCapturethis.IsCaptureNo description available.
IsSha256this.IsSha256No description available.
IsThemethis.IsThemeNo description available.
IsPortthis.IsPortNo description available.
IsVerbositythis.IsVerbosityNo description available.
IsTestthis.IsTestNo description available.
IsBannerthis.IsBannerNo description available.
IsExtractthis.IsExtractNo description available.
IsAuditthis.IsAuditNo description available.
IsInitthis.IsInitNo description available.
IsInteractivethis.IsInteractiveNo description available.
IsVersionthis.IsVersionNo description available.
IsInspectthis.IsInspectNo description available.
IsBuildthis.IsBuildNo description available.
IsGenerate_Teststhis.IsGenerate_TestsNo description available.
IsWatchthis.IsWatchNo description available.
IsCapsulethis.IsCapsuleNo description available.
IsGenerate_CIthis.IsGenerate_CINo description available.
IsIgnorethis.IsIgnoreNo description available.
IsHostthis.IsHostNo description available.
IsWarn_As_Errorthis.IsWarn_As_ErrorNo description available.
IsBuild_Historythis.IsBuild_HistoryNo description available.
InitInitAdds FsLiveDocs configuration and starter documentation to a repository.
Generate_CIGenerate_CIGenerates a GitHub Actions workflow for documentation verification and releases.
Generate_TestsGenerate_Tests projectPathsGenerates a test project for documentation examples.
ExtractExtract projectPathsExtracts symbol metadata from projects into JSON snapshots.
CaptureCapture projectPathsCaptures a self-contained, renderer-neutral documentation release.
InspectInspect capsulePathVerifies and describes a release capsule.
History_AddHistory_Add versionAdds an immutable capsule reference to a release history index.
TestTest projectPathsRuns verified code examples found in docstrings.
AuditAudit projectPathsAudits coverage and compiler-checks every expanded F# documentation block.
BuildBuild projectPathsBuilds the full static documentation site.
Build_HistoryBuild_History manifestPathBuilds every version in a verified local history manifest.
WatchWatch projectPathsBuilds, serves, and rebuilds a local documentation preview.
ThemeTheme stringSets the generated site's visual theme.
VersionVersion stringSets the documentation version for build, extraction, or capture.
OutputOutput stringSets the output path for commands that write an artifact or history index.
CapsuleCapsule stringSets a local capsule path for history-add.
UrlUrl stringSets an HTTPS capsule URL for history-add.
Sha256Sha256 stringSets the expected capsule SHA-256 for history-add.
HostHost stringSets the network interface used by the preview server.
PortPort intSets the TCP port used by the preview server.
IgnoreIgnore stringAdds directory names the preview watcher must not watch or rebuild for.
Warn_As_ErrorWarn_As_ErrorFails the run when the documented API produces quality warnings.
VerbosityVerbosity stringSets console verbosity to warnings, info, or debug.
InteractiveInteractive boolEnables or disables interactive terminal rendering.
BannerBanner boolEnables or disables the LiveDocs banner.
Discover_ProjectsDiscover_ProjectsDiscovers documentable projects and records them in .livedocs/config.json during init.
Dry_RunDry_RunValidates capture and reports its expected result without writing a capsule.

Union cases

kind:member

IsOutput

this.IsOutput
Member

Returns

bool
kind:member

IsDry_Run

this.IsDry_Run
Member

Returns

bool
kind:member

IsUrl

this.IsUrl
Member

Returns

bool
kind:member

IsHistory_Add

this.IsHistory_Add
Member

Returns

bool
kind:member

IsDiscover_Projects

this.IsDiscover_Projects
Member

Returns

bool
kind:member

IsCapture

this.IsCapture
Member

Returns

bool
kind:member

IsSha256

this.IsSha256
Member

Returns

bool
kind:member

IsTheme

this.IsTheme
Member

Returns

bool
kind:member

IsPort

this.IsPort
Member

Returns

bool
kind:member

IsVerbosity

this.IsVerbosity
Member

Returns

bool
kind:member

IsTest

this.IsTest
Member

Returns

bool
kind:member

IsBanner

this.IsBanner
Member

Returns

bool
kind:member

IsExtract

this.IsExtract
Member

Returns

bool
kind:member

IsAudit

this.IsAudit
Member

Returns

bool
kind:member

IsInit

this.IsInit
Member

Returns

bool
kind:member

IsInteractive

this.IsInteractive
Member

Returns

bool
kind:member

IsVersion

this.IsVersion
Member

Returns

bool
kind:member

IsInspect

this.IsInspect
Member

Returns

bool
kind:member

IsBuild

this.IsBuild
Member

Returns

bool
kind:member

IsGenerate_Tests

this.IsGenerate_Tests
Member

Returns

bool
kind:member

IsWatch

this.IsWatch
Member

Returns

bool
kind:member

IsCapsule

this.IsCapsule
Member

Returns

bool
kind:member

IsGenerate_CI

this.IsGenerate_CI
Member

Returns

bool
kind:member

IsIgnore

this.IsIgnore
Member

Returns

bool
kind:member

IsHost

this.IsHost
Member

Returns

bool
kind:member

IsWarn_As_Error

this.IsWarn_As_Error
Member

Returns

bool
kind:member

IsBuild_History

this.IsBuild_History
Member

Returns

bool
kind:member

Init

Init
Member
Adds FsLiveDocs configuration and starter documentation to a repository.

Returns

unit
kind:member

Generate_CI

Generate_CI
Member
Generates a GitHub Actions workflow for documentation verification and releases.

Returns

unit
kind:member

Generate_Tests

Generate_Tests projectPaths
Member
Generates a test project for documentation examples.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit
kind:member

Extract

Extract projectPaths
Member
Extracts symbol metadata from projects into JSON snapshots.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit
kind:member

Capture

Capture projectPaths
Member
Captures a self-contained, renderer-neutral documentation release.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit
kind:member

Inspect

Inspect capsulePath
Member
Verifies and describes a release capsule.

Parameters

NameTypeDescription
capsulePathstring

Returns

unit
kind:member

History_Add

History_Add version
Member
Adds an immutable capsule reference to a release history index.

Parameters

NameTypeDescription
versionstring

Returns

unit
kind:member

Test

Test projectPaths
Member
Runs verified code examples found in docstrings.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit
kind:member

Audit

Audit projectPaths
Member
Audits coverage and compiler-checks every expanded F# documentation block.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit
kind:member

Build

Build projectPaths
Member
Builds the full static documentation site.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit
kind:member

Build_History

Build_History manifestPath
Member
Builds every version in a verified local history manifest.

Parameters

NameTypeDescription
manifestPathstring

Returns

unit
kind:member

Watch

Watch projectPaths
Member
Builds, serves, and rebuilds a local documentation preview.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit
kind:member

Theme

Theme string
Member
Sets the generated site's visual theme.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Version

Version string
Member
Sets the documentation version for build, extraction, or capture.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Output

Output string
Member
Sets the output path for commands that write an artifact or history index.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Capsule

Capsule string
Member
Sets a local capsule path for history-add.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Url

Url string
Member
Sets an HTTPS capsule URL for history-add.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Sha256

Sha256 string
Member
Sets the expected capsule SHA-256 for history-add.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Host

Host string
Member
Sets the network interface used by the preview server.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Port

Port int
Member
Sets the TCP port used by the preview server.

Parameters

NameTypeDescription
Itemint

Returns

unit
kind:member

Ignore

Ignore string
Member
Adds directory names the preview watcher must not watch or rebuild for.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Warn_As_Error

Warn_As_Error
Member
Fails the run when the documented API produces quality warnings.

Returns

unit
kind:member

Verbosity

Verbosity string
Member
Sets console verbosity to warnings, info, or debug.

Parameters

NameTypeDescription
Itemstring

Returns

unit
kind:member

Interactive

Interactive bool
Member
Enables or disables interactive terminal rendering.

Parameters

NameTypeDescription
Itembool

Returns

unit
kind:member

Banner

Banner bool
Member
Enables or disables the LiveDocs banner.

Parameters

NameTypeDescription
Itembool

Returns

unit
kind:member

Discover_Projects

Discover_Projects
Member
Discovers documentable projects and records them in .livedocs/config.json during init.

Returns

unit
kind:member

Dry_Run

Dry_Run
Member
Validates capture and reports its expected result without writing a capsule.

Returns

unit