​
Definition

Assembly: CloudNimble.DotNetDocs.Core.dll Namespace: CloudNimble.DotNetDocs.Core Inheritance: System.Object

​
Syntax

CloudNimble.DotNetDocs.Core.DocumentationManager

​
Summary

Orchestrates the documentation pipeline for one or more assemblies.

​
Remarks

This class manages the complete documentation lifecycle including enrichment, transformation, and rendering. It handles AssemblyManager creation, usage, and disposal for processing assemblies.

​
Constructors

​
.ctor

Initializes a new instance of the DocumentationManager class.

​
Syntax

public DocumentationManager(CloudNimble.DotNetDocs.Core.ProjectContext projectContext, System.Collections.Generic.IEnumerable<CloudNimble.DotNetDocs.Core.IDocEnricher> enrichers = null, System.Collections.Generic.IEnumerable<CloudNimble.DotNetDocs.Core.IDocTransformer> transformers = null, System.Collections.Generic.IEnumerable<CloudNimble.DotNetDocs.Core.IDocRenderer> renderers = null)

​
Parameters

NameTypeDescription
projectContextCloudNimble.DotNetDocs.Core.ProjectContextThe project context containing configuration settings.
enrichersSystem.Collections.Generic.IEnumerable<CloudNimble.DotNetDocs.Core.IDocEnricher>?The enrichers to apply to documentation entities.
transformersSystem.Collections.Generic.IEnumerable<CloudNimble.DotNetDocs.Core.IDocTransformer>?The transformers to apply to the documentation model.
renderersSystem.Collections.Generic.IEnumerable<CloudNimble.DotNetDocs.Core.IDocRenderer>?The renderers to generate output formats.

​
Remarks

This constructor is designed to work with dependency injection containers. All parameters accept IEnumerable collections that are typically injected by the DI container.

​
Methods

​
CreateConceptualFilesAsync

Creates placeholder conceptual documentation files for a single assembly.

​
Syntax

public System.Threading.Tasks.Task CreateConceptualFilesAsync(string assemblyPath, string xmlPath)

​
Parameters

NameTypeDescription
assemblyPathstringThe path to the assembly file.
xmlPathstringThe path to the XML documentation file.

​
Returns

Type: System.Threading.Tasks.Task A task representing the asynchronous operation.

​
CreateConceptualFilesAsync

Creates placeholder conceptual documentation files for multiple assemblies.

​
Syntax

public System.Threading.Tasks.Task CreateConceptualFilesAsync(System.Collections.Generic.IEnumerable<(string, string)> assemblies)

​
Parameters

NameTypeDescription
assembliesSystem.Collections.Generic.IEnumerable<(string, string)>The collection of assembly and XML path pairs.

​
Returns

Type: System.Threading.Tasks.Task A task representing the asynchronous operation.

​
Dispose

Disposes of all cached AssemblyManager instances.

​
Syntax

public void Dispose()

​
ProcessAsync

Processes a single assembly through the documentation pipeline.

​
Syntax

public System.Threading.Tasks.Task ProcessAsync(string assemblyPath, string xmlPath)

​
Parameters

NameTypeDescription
assemblyPathstringThe path to the assembly file.
xmlPathstringThe path to the XML documentation file.

​
Returns

Type: System.Threading.Tasks.Task A task representing the asynchronous processing operation.

​
ProcessAsync

Processes multiple assemblies through the documentation pipeline.

​
Syntax

public System.Threading.Tasks.Task ProcessAsync(System.Collections.Generic.IEnumerable<(string, string)> assemblies)

​
Parameters

NameTypeDescription
assembliesSystem.Collections.Generic.IEnumerable<(string, string)>The collection of assembly and XML path pairs.

​
Returns

Type: System.Threading.Tasks.Task A task representing the asynchronous processing operation.
  • System.IDisposable