ArgumentsUnion

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

Specification

Kind
Union
Members
54
Examples
0
IsBuildSignature
this.IsBuild
IsBuild_HistorySignature
this.IsBuild_History
IsWatchSignature
this.IsWatch
IsDiscover_ProjectsSignature
this.IsDiscover_Projects
IsWarn_As_ErrorSignature
this.IsWarn_As_Error

Summary

NameSignatureSynopsis
IsBuildthis.IsBuildNo description available.
IsBuild_Historythis.IsBuild_HistoryNo description available.
IsWatchthis.IsWatchNo description available.
IsDiscover_Projectsthis.IsDiscover_ProjectsNo description available.
IsWarn_As_Errorthis.IsWarn_As_ErrorNo description available.
IsTestthis.IsTestNo description available.
IsInteractivethis.IsInteractiveNo description available.
IsGenerate_CIthis.IsGenerate_CINo description available.
IsVersionthis.IsVersionNo description available.
IsSha256this.IsSha256No description available.
IsCapsulethis.IsCapsuleNo description available.
IsUrlthis.IsUrlNo description available.
IsIgnorethis.IsIgnoreNo description available.
IsPortthis.IsPortNo description available.
IsThemethis.IsThemeNo description available.
IsHistory_Addthis.IsHistory_AddNo description available.
IsDry_Runthis.IsDry_RunNo description available.
IsVerbositythis.IsVerbosityNo description available.
IsInspectthis.IsInspectNo description available.
IsGenerate_Teststhis.IsGenerate_TestsNo description available.
IsInitthis.IsInitNo description available.
IsCapturethis.IsCaptureNo description available.
IsHostthis.IsHostNo description available.
IsOutputthis.IsOutputNo description available.
IsAuditthis.IsAuditNo description available.
IsExtractthis.IsExtractNo description available.
IsBannerthis.IsBannerNo 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.

IsBuild

this.IsBuild
Member

Returns

bool

IsBuild_History

this.IsBuild_History
Member

Returns

bool

IsWatch

this.IsWatch
Member

Returns

bool

IsDiscover_Projects

this.IsDiscover_Projects
Member

Returns

bool

IsWarn_As_Error

this.IsWarn_As_Error
Member

Returns

bool

IsTest

this.IsTest
Member

Returns

bool

IsInteractive

this.IsInteractive
Member

Returns

bool

IsGenerate_CI

this.IsGenerate_CI
Member

Returns

bool

IsVersion

this.IsVersion
Member

Returns

bool

IsSha256

this.IsSha256
Member

Returns

bool

IsCapsule

this.IsCapsule
Member

Returns

bool

IsUrl

this.IsUrl
Member

Returns

bool

IsIgnore

this.IsIgnore
Member

Returns

bool

IsPort

this.IsPort
Member

Returns

bool

IsTheme

this.IsTheme
Member

Returns

bool

IsHistory_Add

this.IsHistory_Add
Member

Returns

bool

IsDry_Run

this.IsDry_Run
Member

Returns

bool

IsVerbosity

this.IsVerbosity
Member

Returns

bool

IsInspect

this.IsInspect
Member

Returns

bool

IsGenerate_Tests

this.IsGenerate_Tests
Member

Returns

bool

IsInit

this.IsInit
Member

Returns

bool

IsCapture

this.IsCapture
Member

Returns

bool

IsHost

this.IsHost
Member

Returns

bool

IsOutput

this.IsOutput
Member

Returns

bool

IsAudit

this.IsAudit
Member

Returns

bool

IsExtract

this.IsExtract
Member

Returns

bool

IsBanner

this.IsBanner
Member

Returns

bool

Init

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

Returns

unit

Generate_CI

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

Returns

unit

Generate_Tests

Generate_Tests projectPaths
Member
Generates a test project for documentation examples.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Extract

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

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Capture

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

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Inspect

Inspect capsulePath
Member
Verifies and describes a release capsule.

Parameters

NameTypeDescription
capsulePathstring

Returns

unit

History_Add

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

Parameters

NameTypeDescription
versionstring

Returns

unit

Test

Test projectPaths
Member
Runs verified code examples found in docstrings.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Audit

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

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Build

Build projectPaths
Member
Builds the full static documentation site.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Build_History

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

Parameters

NameTypeDescription
manifestPathstring

Returns

unit

Watch

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

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Theme

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Version

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Output

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Capsule

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Url

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Sha256

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Host

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Port

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

Parameters

NameTypeDescription
Itemint

Returns

unit

Ignore

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Warn_As_Error

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

Returns

unit

Verbosity

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

Parameters

NameTypeDescription
Itemstring

Returns

unit

Interactive

Interactive bool
Member
Enables or disables interactive terminal rendering.

Parameters

NameTypeDescription
Itembool

Returns

unit

Banner

Banner bool
Member
Enables or disables the LiveDocs banner.

Parameters

NameTypeDescription
Itembool

Returns

unit

Discover_Projects

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

Returns

unit

Dry_Run

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

Returns

unit