hi, does anyone know whether it is possible to use DocFX to document entity framework C# models? I have managed to get the fields I want, but I cant seem to find a way to extract the annotations for the field type. I have tried to create a simple plugin, but all I get is System.Composition.Hosting.CompositionFailedException: No export was found for the contract
Really scratching my head here, the documentation ironically for a documentator isn't very complete
<summary>adds a paragraph of text under the field name.
<remarks>adds a "Remarks" section. There are no XML tags in the official spec for C# that I can find.
<description>does not work. There is nothing in the Docfx documentation either, but I see it here as proof that it can be done. I'm about to DotPeek the assembly to figure it out, but I shouldn't have to go this route. Terrible.
Has anyone built a Docker image for DocFX 2.x that supports metadata creation for .NET Core applications? I've created my own image using knsit/docfx:latest as a base and then adding the .NET Core SDK over top of it. The problem I'm running into is that DocFX is using mono as the inner compiler:
[21-03-19 01:53:58.802]Info:[ExtractMetadata]Using mono /usr/lib/mono/msbuild/15.0/bin/MSBuild.dll as inner compiler.
This gives me the following error:
[21-03-19 01:53:58.942]Error:System.IO.DirectoryNotFoundException: Could not find a part of the path '/proc/self/task/8/fd/4'
Build succeeded with warning. [21-05-25 07:17:45.785]Warning:[MetadataCommand.ExtractMetadata]No metadata is generated for Minecraftchest1-utils. 1 Warning(s) 0 Error(s)
faviconacross many browsers. These 10 files have to be installed into the root of the documentation site. To keep the source repository cleanly organized, I'd like to store these 10 files in <reporoot>/assets/siteroot. Can DocFx copy the contents of <reporoot>/assets/siteroot into <reporoot>/_site during document generation? and if so, could someone share the .docfx snippet(s) necessary to accomplish it? Thanks!