PageGranularity Enum

Namespace
Kampute.DocToolkit
Assembly
  • Kampute.DocToolkit.dll

Definition

Specifies how documentation content is organized into addressable pages, affecting URLs and navigation structure.
[Flags]
public enum PageGranularity
Attributes
Inheritance

Fields

NameValueDescription
None0No page granularity, resulting in all content being documented within the same page.
Namespace1Indicates that namespaces have their own documentation pages.
Type2Indicates that types have their own documentation pages.
Member4Indicates that type members have their own documentation pages.
NamespaceType3Indicates that namespaces and types have their own documentation pages, but type members are documented within their containing type pages.
NamespaceTypeMember7Indicates that namespaces, types, and type members all have their own documentation pages.

Remarks

The page granularity is a key architectural decision that impacts the entire documentation structure. The chosen granularity affects navigation patterns, URL structure, search engine optimization, and overall user experience. Different granularity levels offer trade-offs between content density and navigational complexity.