Skip to content
This repository was archived by the owner on Dec 19, 2022. It is now read-only.
This repository was archived by the owner on Dec 19, 2022. It is now read-only.

Documentation in src\DotnetNew\class1.cs is not taken into account #27

@marcselis

Description

@marcselis

After putting some documentation in src\DotnetNew\class1.cs and rerunning docfx, the newly entered information is not found in the generated documentation.

Contents of my Class1.cs file:

using System;

namespace DotnetNew
{
    /// <summary>
    /// This documentation should be available
    /// </summary>
    public class Class1
    {
        /// <summary>
        /// This method does something very interesting
        /// </summary>
        public void DoSomething()
        { }
    }
}

DocFx output:

C:\TFS\Git\docfx-seed>docfx docfx.json --serve
[19-07-10 08:22:22.906]Info:[MetadataCommand.ExtractMetadata]Environment variable VSINSTALLDIR is set to C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\, it is used as the inner compiler.
[19-07-10 08:22:23.233]Info:[MetadataCommand.ExtractMetadata]Loading projects...
[19-07-10 08:22:23.719]Warning:[MetadataCommand.ExtractMetadata](C:/TFS/Git/docfx-seed/src/SampleClass1/SampleClass1.sln)Error opening solution C:/TFS/Git/docfx-seed/src/SampleClass1/SampleClass1.sln: Unable to load one or more of the requested types. Retrieve the LoaderExceptions property for more information.. Ignored.
[19-07-10 08:22:23.758]Info:[MetadataCommand.ExtractMetadata]'C:/TFS/Git/docfx-seed/src/SampleClass1/SampleClass1.sln' keep up-to-date since '10/07/2019 7:55:53', cached result from 'C:/TFS/Git/docfx-seed/obj/api' is used.
[19-07-10 08:22:23.762]Info:[MetadataCommand]Completed Scope:MetadataCommand in 864,6535 milliseconds.
[19-07-10 08:22:23.875]Info:[BuildCommand]6 plug-in(s) loaded.
[19-07-10 08:22:23.880]Info:[BuildCommand]Post processor ExtractSearchIndex loaded.
[19-07-10 08:22:23.917]Info:[BuildCommand]Markdown engine is markdig
[19-07-10 08:22:24.344]Info:[BuildCommand.BuildCore.Build Document]Max parallelism is 8.
[19-07-10 08:22:25.510]Info:[BuildCommand.BuildCore.Build Document.CompilePhaseHandlerWithIncremental.TocDocumentProcessor]Building 4 file(s) in TocDocumentProcessor(BuildTocDocument)...
[19-07-10 08:22:25.511]Info:[BuildCommand.BuildCore.Build Document.CompilePhaseHandlerWithIncremental.ManagedReferenceDocumentProcessor]Building 0 file(s) in ManagedReferenceDocumentProcessor(BuildManagedReferenceDocument=>ValidateManagedReferenceDocumentMetadata=>ApplyOverwriteDocumentForMref=>FillReferenceInformation)...
[19-07-10 08:22:25.513]Info:[BuildCommand.BuildCore.Build Document.CompilePhaseHandlerWithIncremental.ConceptualDocumentProcessor]Building 0 file(s) in ConceptualDocumentProcessor(BuildConceptualDocument=>CountWord=>ValidateConceptualDocumentMetadata)...
[19-07-10 08:22:25.517]Info:[BuildCommand.BuildCore.Build Document.CompilePhaseHandlerWithIncremental.ResourceDocumentProcessor]Building 1 file(s) in ResourceDocumentProcessor(ValidateResourceMetadata)...
[19-07-10 08:22:25.518]Info:[BuildCommand.BuildCore.Build Document.CompilePhaseHandlerWithIncremental.RestApiDocumentProcessor]Building 10 file(s) in RestApiDocumentProcessor(BuildRestApiDocument=>ValidateRestApiDocumentMetadata=>ApplyOverwriteDocumentForRestApi)...
[19-07-10 08:22:26.227]Info:[BuildCommand.BuildCore.Build Document.LinkPhaseHandlerWithIncremental.UpdateContext]0 external references found in 1 xref maps.
[19-07-10 08:22:26.985]Info:[BuildCommand.BuildCore.Build Document.LinkPhaseHandlerWithIncremental.UpdateContext]0 uids found in 1 xrefservice(s).
[19-07-10 08:22:27.116]Info:[BuildCommand.BuildCore.Build Document.LinkPhaseHandlerWithIncremental.Apply Templates]Applying templates to 7 model(s)...
[19-07-10 08:22:27.370]Info:[BuildCommand.BuildCore.Build Document]XRef map exported.
[19-07-10 08:22:27.525]Info:[BuildCommand.Postprocess.HandlePostProcessorsWithIncremental.HandlePostProcessors.Processing ExtractSearchIndex]Extracting index data from 31 html files
[19-07-10 08:22:27.604]Info:[BuildCommand.Postprocess]Manifest file saved to manifest.json.
[19-07-10 08:22:27.636]Info:[BuildCommand]Completed building documents in 3755,983 milliseconds.
Serving "C:\TFS\Git\docfx-seed\_site" on http://localhost:8080

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions