DYN-4687 - docs browser and docs generator produce .md files with names that are too long. (#13588)

sm6srw · web-flow · commit 83161e3be55c · 2022-12-06T12:26:32.000-05:00
* Initial implementation * Remove files added by mistake. * Revert .gitignore change * Update help text * Add the original base name as a comment in the renamed MD file * Revert "temp fix for builds, remove tsplines nodes docs (#12693)" This reverts commit 9338ca4. * Rename offending files * Add hash test * Add tests for markdown generator tool * Update Readme * Add comments * Revert "Rename offending files" This reverts commit b09be40. * Use SHA256/Base32 instead of SHA1 * Address review comments
diff --git a/doc/distrib/NodeHelpFiles/HNVVP7HSR2IM5H5AFWWLLJBXSX2WTG5FEWESXLGORW2CL2CG7C4Q.md b/doc/distrib/NodeHelpFiles/HNVVP7HSR2IM5H5AFWWLLJBXSX2WTG5FEWESXLGORW2CL2CG7C4Q.md
@@ -0,0 +1,7 @@
+<!--- Autodesk.DesignScript.Geometry.TSpline.TSplineSurface.ByBoxLengths(origin, width, length, height, xSpans, ySpans, zSpans, symmetry, inSmoothMode) --->
+<!--- HNVVP7HSR2IM5H5AFWWLLJBXSX2WTG5FEWESXLGORW2CL2CG7C4Q --->
+## ByBoxLengths(origin, width, length, height, xSpans, ySpans, zSpans, symmetry, inSmoothMode) - Documentation
+This documentation file is auto generated by NodeDocumentationMarkdownGenerator, Version=2.14.0.3986, Culture=neutral, PublicKeyToken=null.
+
+For more information about adding documentation to nodes see https://github.com/DynamoDS/Dynamo/wiki/Create-and-Add-Custom-Documentation-to-Nodes
+
diff --git a/doc/distrib/NodeHelpFiles/VFK33PBU2AHJIHDOMW3NS2YJNGRTQADZ2RUGALOLEWRXK4DM4DTA.md b/doc/distrib/NodeHelpFiles/VFK33PBU2AHJIHDOMW3NS2YJNGRTQADZ2RUGALOLEWRXK4DM4DTA.md
@@ -0,0 +1,7 @@
+<!--- Autodesk.DesignScript.Geometry.TSpline.TSplineSurface.ByBoxLengths(cs, width, length, height, xSpans, ySpans, zSpans, symmetry, inSmoothMode)
+<!--- VFK33PBU2AHJIHDOMW3NS2YJNGRTQADZ2RUGALOLEWRXK4DM4DTA --->
+## ByBoxLengths(cs, width, length, height, xSpans, ySpans, zSpans, symmetry, inSmoothMode) - Documentation
+This documentation file is auto generated by NodeDocumentationMarkdownGenerator, Version=2.14.0.3986, Culture=neutral, PublicKeyToken=null.
+
+For more information about adding documentation to nodes see https://github.com/DynamoDS/Dynamo/wiki/Create-and-Add-Custom-Documentation-to-Nodes
+
diff --git a/doc/distrib/NodeHelpFiles/WN6BWNG6A6KOPFMMRBHLV7XBOOEGXTSO5I5FZXHKKUG5YO6MNNYA.md b/doc/distrib/NodeHelpFiles/WN6BWNG6A6KOPFMMRBHLV7XBOOEGXTSO5I5FZXHKKUG5YO6MNNYA.md
@@ -0,0 +1,7 @@
+<!--- Autodesk.DesignScript.Geometry.TSpline.TSplineSurface.ByBoxLengths(width, length, height, xSpans, ySpans, zSpans, symmetry, inSmoothMode) --->
+<!--- WN6BWNG6A6KOPFMMRBHLV7XBOOEGXTSO5I5FZXHKKUG5YO6MNNYA --->
+## ByBoxLengths(width, length, height, xSpans, ySpans, zSpans, symmetry, inSmoothMode) - Documentation
+This documentation file is auto generated by NodeDocumentationMarkdownGenerator, Version=2.14.0.3986, Culture=neutral, PublicKeyToken=null.
+
+For more information about adding documentation to nodes see https://github.com/DynamoDS/Dynamo/wiki/Create-and-Add-Custom-Documentation-to-Nodes
+
diff --git a/src/DocumentationBrowserViewExtension/DocumentationBrowserViewModel.cs b/src/DocumentationBrowserViewExtension/DocumentationBrowserViewModel.cs
@@ -86,6 +86,7 @@ private set
         private Uri link;
         private string graphPath;
         private string content;
+        private string name;
 
         private MarkdownHandler MarkdownHandlerInstance => markdownHandler ?? (markdownHandler = new MarkdownHandler());
         public bool HasContent => !string.IsNullOrWhiteSpace(this.content);
@@ -184,6 +185,7 @@ private void HandleLocalResource(OpenDocumentationLinkEventArgs e)
             {
                 string targetContent;
                 string graph;
+                string graphName;
                 Uri link;
                 switch (e)
                 {
@@ -195,19 +197,22 @@ private void HandleLocalResource(OpenDocumentationLinkEventArgs e)
                         link = string.IsNullOrEmpty(mdLink) ? new Uri(String.Empty, UriKind.Relative) : new Uri(mdLink);
                         graph = GetGraphLinkFromMDLocation(link);
                         targetContent = CreateNodeAnnotationContent(openNodeAnnotationEventArgs);
+                        graphName = openNodeAnnotationEventArgs.MinimumQualifiedName;
                         break;
 
                     case OpenDocumentationLinkEventArgs openDocumentationLink:
                         link = openDocumentationLink.Link;
                         graph = GetGraphLinkFromMDLocation(link);
                         targetContent = ResourceUtilities.LoadContentFromResources(openDocumentationLink.Link.ToString(), GetType().Assembly);
+                        graphName = null;
                         break;
 
                     default:
                         // Navigate to unsupported 
                         targetContent = null;
                         graph = null;
                         link = null;
+                        graphName = null;
                         break;
                 }
 
@@ -220,6 +225,7 @@ private void HandleLocalResource(OpenDocumentationLinkEventArgs e)
                     this.content = targetContent;
                     this.Link = link;
                     this.graphPath = graph;
+                    this.name = graphName;
                 }
             }
             catch (FileNotFoundException)
@@ -358,7 +364,8 @@ internal void InsertGraph()
             {
                 if (graphPath != null)
                 {
-                    raiseInsertGraph(this, new InsertDocumentationLinkEventArgs(graphPath, Path.GetFileNameWithoutExtension(graphPath)));
+                    var graphName = this.name ?? Path.GetFileNameWithoutExtension(graphPath);
+                    raiseInsertGraph(this, new InsertDocumentationLinkEventArgs(graphPath, graphName));
                 }
                 else
                 {
diff --git a/src/DocumentationBrowserViewExtension/PackageDocumentationManager.cs b/src/DocumentationBrowserViewExtension/PackageDocumentationManager.cs
@@ -5,6 +5,7 @@
 using System.Threading;
 using Dynamo.Interfaces;
 using Dynamo.Logging;
+using Dynamo.Utilities;
 
 namespace Dynamo.DocumentationBrowser
 {
@@ -95,10 +96,13 @@ public string GetAnnotationDoc(string nodeNamespace, string packageName)
                 return output;
             }
 
+            var shortName = Hash.GetHashFilenameFromString(nodeNamespace);
+
             FileInfo matchingDoc = null;
             if (hostDynamoFallbackDocPath != null)
             {
-                matchingDoc = hostDynamoFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();
+                matchingDoc = hostDynamoFallbackDocPath.GetFiles($"{shortName}.md").FirstOrDefault() ??
+                              hostDynamoFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();
                 if (matchingDoc != null)
                 {
                     return matchingDoc.FullName;
@@ -107,7 +111,8 @@ public string GetAnnotationDoc(string nodeNamespace, string packageName)
 
             if (dynamoCoreFallbackDocPath != null)
             {
-                matchingDoc = dynamoCoreFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();
+                matchingDoc = dynamoCoreFallbackDocPath.GetFiles($"{shortName}.md").FirstOrDefault() ??
+                              dynamoCoreFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();
             }
 
             return matchingDoc is null ? string.Empty : matchingDoc.FullName;
diff --git a/src/DynamoUtilities/Hash.cs b/src/DynamoUtilities/Hash.cs
@@ -0,0 +1,97 @@
+using System;
+using System.Linq;
+using System.Security.Cryptography;
+using System.Text;
+
+namespace Dynamo.Utilities
+{
+    internal class Hash
+    {
+        /// <summary>
+        /// Get the hash value
+        /// </summary>
+        /// <param name="bytes">input as a byte array</param>
+        /// <returns>hash as a byte array</returns>
+        internal static byte[] GetHash(byte[] bytes)
+        {
+            using (var hashAlgorithm = SHA256.Create())
+            {
+                return hashAlgorithm.ComputeHash(bytes);
+            }
+        }
+
+        /// <summary>
+        /// Get the hash value
+        /// </summary>
+        /// <param name="str">input as a string</param>
+        /// <returns>hash as a byte array</returns>
+        internal static byte[] GetHashFromString(string str)
+        {
+            var bytes = Encoding.UTF8.GetBytes(str);
+            return GetHash(bytes);
+        }
+
+        /// <summary>
+        /// Get a valid filename for a hash
+        /// </summary>
+        /// <param name="bytes">hash as a byte array</param>
+        /// <returns>hash as a valid filename string</returns>
+        internal static string GetFilenameFromHash(byte[] bytes)
+        {
+            return ToBase32String(bytes);
+        }
+
+        /// <summary>
+        /// Get hash file name
+        /// </summary>
+        /// <param name="str">inout as a string</param>
+        /// <returns>hash as a valid filename</returns>
+        internal static string GetHashFilenameFromString(string str)
+        {
+            var hash = GetHashFromString(str);
+            return GetFilenameFromHash(hash);
+        }
+
+        /// <summary>
+        /// /// The different characters allowed in Base32 encoding.
+        /// </summary>
+        /// <remarks>
+        /// This is a 32-character subset of the twenty-six letters A–Z and six digits 2–7.
+        /// <see cref="https://en.wikipedia.org/wiki/Base32" />
+        /// </remarks>
+        internal static string Base32AllowedCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+
+        /// <summary> /// Converts a byte array into a Base32 string.
+        /// </summary>
+        /// <param name="input">The string to convert to Base32.</param>
+        /// <param name="addPadding">Whether or not to add RFC3548 '='-padding to the string.</param>
+        /// <returns>A Base32 string.</returns>
+        /// <remarks>
+        /// https://tools.ietf.org/html/rfc3548#section-2.2 indicates padding MUST be added unless the reference to the RFC tells us otherswise.
+        /// https://github.com/google/google-authenticator/wiki/Key-Uri-Format indicates that padding SHOULD be omitted.
+        /// To meet both requirements, you can omit padding when required.
+        /// </remarks>
+        internal static string ToBase32String(byte[] input, bool addPadding = false)
+        {
+            if (input == null || input.Length == 0)
+            {
+                return string.Empty;
+            }
+
+            var bits = input.Select(b => Convert.ToString(b, 2).PadLeft(8, '0')).Aggregate((a, b) => a + b)
+                .PadRight((int)(Math.Ceiling((input.Length * 8) / 5d) * 5), '0');
+            var result = Enumerable.Range(0, bits.Length / 5)
+                .Select(i => Base32AllowedCharacters.Substring(Convert.ToInt32(bits.Substring(i * 5, 5), 2), 1))
+                .Aggregate((a, b) => a + b);
+
+            if (addPadding)
+            {
+                result = result.PadRight((int)(Math.Ceiling(result.Length / 8d) * 8), '=');
+            }
+
+            return result;
+        }
+    }
+}
+
+
diff --git a/src/DynamoUtilities/Properties/AssemblyInfo.cs b/src/DynamoUtilities/Properties/AssemblyInfo.cs
@@ -1,4 +1,4 @@
-﻿using System.Reflection;
+using System.Reflection;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 
@@ -20,4 +20,5 @@
 [assembly: InternalsVisibleTo("DocumentationBrowserViewExtension")]
 [assembly: InternalsVisibleTo("DynamoPackages")]
 [assembly: InternalsVisibleTo("ProtoScript")]
-[assembly: InternalsVisibleTo("ProtoCore")]
+[assembly: InternalsVisibleTo("ProtoCore")]
+[assembly: InternalsVisibleTo("NodeDocumentationMarkdownGenerator")]
diff --git a/src/Tools/NodeDocumentationMarkdownGenerator/CommandHandler.cs b/src/Tools/NodeDocumentationMarkdownGenerator/CommandHandler.cs
@@ -1,4 +1,4 @@
-﻿using System;
+using System;
 using System.Text;
 using Dynamo.Logging;
 using NodeDocumentationMarkdownGenerator.Commands;
@@ -36,6 +36,20 @@ internal static string HandleFromDirectory(FromDirectoryOptions opts)
             return "";
         }
 
+        internal static string HandleRename(RenameOptions opts)
+        {
+            try
+            {
+                RenameCommand.HandleRename(opts);
+            }
+            catch (Exception e)
+            {
+                LogExceptionToConsole(e);
+            }
+
+            return "";
+        }
+
         internal static void LogExceptionToConsole(Exception e)
         {
             var strBuilder = new StringBuilder();
@@ -76,4 +90,4 @@ public void LogWarning(string warning, WarningLevel level)
             throw new NotImplementedException();
         }
     }
-}
+}
diff --git a/src/Tools/NodeDocumentationMarkdownGenerator/Commands/RenameCommand.cs b/src/Tools/NodeDocumentationMarkdownGenerator/Commands/RenameCommand.cs
@@ -0,0 +1,90 @@
+using System;
+using System.IO;
+using System.Linq;
+using NodeDocumentationMarkdownGenerator.Verbs;
+
+namespace NodeDocumentationMarkdownGenerator.Commands
+{
+    internal static class RenameCommand
+    {
+        internal static void HandleRename(RenameOptions opts)
+        {
+            if (opts.InputMdFile is null && opts.InputMdDirectory != null)
+            {
+                RenameDirectory(opts.InputMdDirectory, opts.MaxLength);
+            }
+            else if (opts.InputMdFile != null && opts.InputMdDirectory is null)
+            {
+                RenameFile(opts.InputMdFile);
+            }
+            else
+            {
+                Console.WriteLine("Invalid options: You can rename a single file using the file option\nor rename multiple files in a directory (if they are longer than max length)\nusing the directory option");
+            }
+        }
+
+        private static void RenameFile(string file)
+        {
+            var extension = Path.GetExtension(file);
+            if (!extension.Equals(".md", StringComparison.InvariantCultureIgnoreCase))
+            {
+                Console.WriteLine($"Can only rename MD files: {file}");
+                return;
+            }
+
+            if (!File.Exists(file))
+            {
+                Console.WriteLine($"File not found: {file}");
+                return;
+            }
+
+            var baseName = Path.GetFileNameWithoutExtension(file);
+            var shortName = Dynamo.Utilities.Hash.GetHashFilenameFromString(baseName);
+
+            RenameFile(file, baseName, shortName);
+        }
+
+        private static void RenameFile(string file, string baseName, string shortName)
+        {
+            var content = File.ReadAllText(file);
+            content = content.Replace(baseName, shortName);
+            var path = Path.GetDirectoryName(file);
+            var newFile = Path.Combine(path, shortName + ".md");
+            File.WriteAllText(newFile, $"<!--- {baseName} --->\n<!--- {shortName} --->\n" + content);
+            File.Delete(file);
+
+            var allSupportFiles = Directory.GetFiles(path, baseName + ".*", SearchOption.TopDirectoryOnly)
+                .Select(x => new FileInfo(x)).ToList();
+            allSupportFiles.AddRange(Directory.GetFiles(path, baseName + "_img.*", SearchOption.TopDirectoryOnly)
+                .Select(x => new FileInfo(x)).ToList());
+
+            foreach (var supportFile in allSupportFiles)
+            {
+                var newName = Path.Combine(supportFile.DirectoryName,
+                    supportFile.Name.Replace(baseName, shortName));
+                supportFile.MoveTo(newName);
+            }
+        }
+
+        private static void RenameDirectory(string directory, int maxLength)
+        {
+            if (!Directory.Exists(directory))
+            {
+                Console.WriteLine($"Directory not found: {directory}");
+                return;
+            }
+
+            var allMdFiles = Directory.GetFiles(directory, "*.md", SearchOption.TopDirectoryOnly).Select(x => new FileInfo(x)).ToList();
+
+            foreach (var mdFile in allMdFiles)
+            {
+                if (mdFile.Name.Length > maxLength)
+                {
+                    var baseName = Path.GetFileNameWithoutExtension(mdFile.Name);
+                    var shortName = Dynamo.Utilities.Hash.GetHashFilenameFromString(baseName);
+                    RenameFile(mdFile.FullName, baseName, shortName);
+                }
+            }
+        }
+    }
+}
diff --git a/src/Tools/NodeDocumentationMarkdownGenerator/Program.cs b/src/Tools/NodeDocumentationMarkdownGenerator/Program.cs
@@ -1,4 +1,4 @@
-﻿using System;
+using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
@@ -50,11 +50,12 @@ internal static void Main(string[] args)
 
             ShowWelcomeMessages();
 
-            var result = Parser.Default.ParseArguments<FromDirectoryOptions, FromPackageOptions>(args);
+            var result = Parser.Default.ParseArguments<FromDirectoryOptions, FromPackageOptions, RenameOptions>(args);
             var text = result
                 .MapResult(
                     (FromDirectoryOptions opts) => CommandHandler.HandleFromDirectory(opts),
                     (FromPackageOptions opts) => CommandHandler.HandleFromPackage(opts),
+                    (RenameOptions opts) => CommandHandler.HandleRename(opts),
                     err => "1");
             Console.WriteLine($"docs generation tool {sw.Elapsed.TotalSeconds}");
 # if DEBUG
diff --git a/src/Tools/NodeDocumentationMarkdownGenerator/Verbs/RenameOptions.cs b/src/Tools/NodeDocumentationMarkdownGenerator/Verbs/RenameOptions.cs
@@ -0,0 +1,25 @@
+using CommandLine.Text;
+using CommandLine;
+using System.Collections.Generic;
+
+namespace NodeDocumentationMarkdownGenerator.Verbs
+{
+    [Verb("rename", HelpText = "Renaming utilities for fallback MD files")]
+    internal class RenameOptions
+    {
+        [Option('f', "file", HelpText = "Input MD file. Renames a single MD file including any support files to a shorter length (~56-60 characters) base file name.", Required = false)]
+        public string InputMdFile { get; set; }
+        [Option('d', "directory", HelpText = "Input directory. Inspects all MD files in a directory and renames all MD files with a base name longer that maxlength (see below).", Required = false)]
+        public string InputMdDirectory { get; set; }
+        [Option('m', "maxlength", HelpText = "Max length of the base file name before renaming to a shorter length (~56-60 characters) base file name.", Required = false, Default = 65)]
+        public int MaxLength { get; set; }
+        [Usage(ApplicationAlias = "Dynamo docs generator")]
+        public static IEnumerable<Example> Examples
+        {
+            get
+            {
+                yield return new Example("Renaming utilities for fallback MD files", new RenameOptions());
+            }
+        }
+    }
+}
diff --git a/src/Tools/NodeDocumentationMarkdownGenerator/readme.md b/src/Tools/NodeDocumentationMarkdownGenerator/readme.md
diff --git a/test/DynamoCoreTests/Utilities/UtilitiesTests.cs b/test/DynamoCoreTests/Utilities/UtilitiesTests.cs
diff --git a/test/Tools/NodeDocumentationMarkdownGeneratorTests/MarkdownGeneratorCommandTests.cs b/test/Tools/NodeDocumentationMarkdownGeneratorTests/MarkdownGeneratorCommandTests.cs

Original file line number	Diff line number	Diff line change
`@@ -86,6 +86,7 @@ private set`
`86`	`86`	`private Uri link;`
`87`	`87`	`private string graphPath;`
`88`	`88`	`private string content;`
	`89`	`+ private string name;`
`89`	`90`
`90`	`91`	`private MarkdownHandler MarkdownHandlerInstance => markdownHandler ?? (markdownHandler = new MarkdownHandler());`
`91`	`92`	`public bool HasContent => !string.IsNullOrWhiteSpace(this.content);`
`@@ -184,6 +185,7 @@ private void HandleLocalResource(OpenDocumentationLinkEventArgs e)`
`184`	`185`	`{`
`185`	`186`	`string targetContent;`
`186`	`187`	`string graph;`
	`188`	`+ string graphName;`
`187`	`189`	`Uri link;`
`188`	`190`	`switch (e)`
`189`	`191`	`{`
`@@ -195,19 +197,22 @@ private void HandleLocalResource(OpenDocumentationLinkEventArgs e)`
`195`	`197`	`link = string.IsNullOrEmpty(mdLink) ? new Uri(String.Empty, UriKind.Relative) : new Uri(mdLink);`
`196`	`198`	`graph = GetGraphLinkFromMDLocation(link);`
`197`	`199`	`targetContent = CreateNodeAnnotationContent(openNodeAnnotationEventArgs);`
	`200`	`+ graphName = openNodeAnnotationEventArgs.MinimumQualifiedName;`
`198`	`201`	`break;`
`199`	`202`
`200`	`203`	`case OpenDocumentationLinkEventArgs openDocumentationLink:`
`201`	`204`	`link = openDocumentationLink.Link;`
`202`	`205`	`graph = GetGraphLinkFromMDLocation(link);`
`203`	`206`	`targetContent = ResourceUtilities.LoadContentFromResources(openDocumentationLink.Link.ToString(), GetType().Assembly);`
	`207`	`+ graphName = null;`
`204`	`208`	`break;`
`205`	`209`
`206`	`210`	`default:`
`207`	`211`	`// Navigate to unsupported`
`208`	`212`	`targetContent = null;`
`209`	`213`	`graph = null;`
`210`	`214`	`link = null;`
	`215`	`+ graphName = null;`
`211`	`216`	`break;`
`212`	`217`	`}`
`213`	`218`
`@@ -220,6 +225,7 @@ private void HandleLocalResource(OpenDocumentationLinkEventArgs e)`
`220`	`225`	`this.content = targetContent;`
`221`	`226`	`this.Link = link;`
`222`	`227`	`this.graphPath = graph;`
	`228`	`+ this.name = graphName;`
`223`	`229`	`}`
`224`	`230`	`}`
`225`	`231`	`catch (FileNotFoundException)`
`@@ -358,7 +364,8 @@ internal void InsertGraph()`
`358`	`364`	`{`
`359`	`365`	`if (graphPath != null)`
`360`	`366`	`{`
`361`		`- raiseInsertGraph(this, new InsertDocumentationLinkEventArgs(graphPath, Path.GetFileNameWithoutExtension(graphPath)));`
	`367`	`+ var graphName = this.name ?? Path.GetFileNameWithoutExtension(graphPath);`
	`368`	`+ raiseInsertGraph(this, new InsertDocumentationLinkEventArgs(graphPath, graphName));`
`362`	`369`	`}`
`363`	`370`	`else`
`364`	`371`	`{`
Original file line number	Diff line number	Diff line change
`@@ -5,6 +5,7 @@`
`5`	`5`	`using System.Threading;`
`6`	`6`	`using Dynamo.Interfaces;`
`7`	`7`	`using Dynamo.Logging;`
	`8`	`+using Dynamo.Utilities;`
`8`	`9`
`9`	`10`	`namespace Dynamo.DocumentationBrowser`
`10`	`11`	`{`
`@@ -95,10 +96,13 @@ public string GetAnnotationDoc(string nodeNamespace, string packageName)`
`95`	`96`	`return output;`
`96`	`97`	`}`
`97`	`98`
	`99`	`+ var shortName = Hash.GetHashFilenameFromString(nodeNamespace);`
	`100`	`+`
`98`	`101`	`FileInfo matchingDoc = null;`
`99`	`102`	`if (hostDynamoFallbackDocPath != null)`
`100`	`103`	`{`
`101`		`- matchingDoc = hostDynamoFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();`
	`104`	`+ matchingDoc = hostDynamoFallbackDocPath.GetFiles($"{shortName}.md").FirstOrDefault() ??`
	`105`	`+ hostDynamoFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();`
`102`	`106`	`if (matchingDoc != null)`
`103`	`107`	`{`
`104`	`108`	`return matchingDoc.FullName;`
`@@ -107,7 +111,8 @@ public string GetAnnotationDoc(string nodeNamespace, string packageName)`
`107`	`111`
`108`	`112`	`if (dynamoCoreFallbackDocPath != null)`
`109`	`113`	`{`
`110`		`- matchingDoc = dynamoCoreFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();`
	`114`	`+ matchingDoc = dynamoCoreFallbackDocPath.GetFiles($"{shortName}.md").FirstOrDefault() ??`
	`115`	`+ dynamoCoreFallbackDocPath.GetFiles($"{nodeNamespace}.md").FirstOrDefault();`
`111`	`116`	`}`
`112`	`117`
`113`	`118`	`return matchingDoc is null ? string.Empty : matchingDoc.FullName;`