[Feature]: DNDocs #10055

src/AccountDeleter/EmptyFeatureFlagService.cs

@@ -71,6 +71,11 @@ public bool IsDisplayFuGetLinksEnabled()
             throw new NotImplementedException();
         }
 
+        public bool IsDisplayDNDocsLinksEnabled()
+        {
+            throw new NotImplementedException();
+        }
+
         public bool IsDisplayNuGetPackageExplorerLinkEnabled()
         {
             throw new NotImplementedException();

src/GitHubVulnerabilities2Db/Fakes/FakeFeatureFlagService.cs

@@ -65,6 +65,11 @@ public bool IsDisplayFuGetLinksEnabled()
             throw new NotImplementedException();
         }
 
+        public bool IsDisplayDNDocsLinksEnabled()
+        {
+            throw new NotImplementedException();
+        }
+
         public bool IsDisplayNuGetTrendsLinksEnabled()
         {
             throw new NotImplementedException();

src/NuGetGallery.Services/Configuration/FeatureFlagService.cs

@@ -29,6 +29,7 @@ public class FeatureFlagService : IFeatureFlagService
         private const string DisplayVulnerabilitiesFeatureName = GalleryPrefix + "DisplayVulnerabilities";
         private const string ManagePackagesVulnerabilitiesFeatureName = GalleryPrefix + "ManagePackagesVulnerabilities";
         private const string DisplayFuGetLinksFeatureName = GalleryPrefix + "DisplayFuGetLinks";
+        private const string DisplayDNDocsLinksFeatureName = GalleryPrefix + "DisplayDNDocsLinks";
         private const string DisplayNuGetPackageExplorerLinkFeatureName = GalleryPrefix + "DisplayNuGetPackageExplorerLink";
         private const string DisplayNuGetTrendsLinkFeatureName = GalleryPrefix + "DisplayNuGetTrendsLink";
         private const string ODataReadOnlyDatabaseFeatureName = GalleryPrefix + "ODataReadOnlyDatabase";
@@ -168,6 +169,11 @@ public bool IsDisplayFuGetLinksEnabled()
             return _client.IsEnabled(DisplayFuGetLinksFeatureName, defaultValue: false);
         }
 
+        public bool IsDisplayDNDocsLinksEnabled()
+        {
+            return _client.IsEnabled(DisplayDNDocsLinksFeatureName, defaultValue: false);
+        }
+
         public bool IsDisplayNuGetPackageExplorerLinkEnabled()
         {
             return _client.IsEnabled(DisplayNuGetPackageExplorerLinkFeatureName, defaultValue: false);

src/NuGetGallery.Services/Configuration/IFeatureFlagService.cs

@@ -77,6 +77,11 @@ public interface IFeatureFlagService
         /// </summary>
         bool IsDisplayFuGetLinksEnabled();
 
+        /// <summary>
+        /// Whether or not a dndocs.com link is visible on a package's details page.
+        /// </summary>
+        bool IsDisplayDNDocsLinksEnabled();
+
         /// <summary>
         /// Whether or not a nugettrends.com link is visible on a package's details page.
         /// </summary>

src/NuGetGallery/App_Data/Files/Content/flags.json

@@ -25,6 +25,7 @@
     "NuGetGallery.DisplayVulnerabilities": "Enabled",
     "NuGetGallery.ManagePackagesVulnerabilities": "Enabled",
     "NuGetGallery.DisplayFuGetLinks": "Enabled",
+    "NuGetGallery.DisplayDNDocsLinks": "Enabled",
     "NuGetGallery.DisplayNuGetPackageExplorerLink": "Enabled",
     "NuGetGallery.DisplayNuGetTrendsLink": "Enabled",
     "NuGetGallery.PatternSetTfmHeuristics": "Enabled",

src/NuGetGallery/Controllers/PackagesController.cs

@@ -981,6 +981,7 @@ public virtual async Task<ActionResult> DisplayPackage(string id, string version
             model.IsPackageDeprecationEnabled = isPackageDeprecationEnabled;
             model.IsPackageVulnerabilitiesEnabled = isPackageVulnerabilitiesEnabled;
             model.IsFuGetLinksEnabled = _featureFlagService.IsDisplayFuGetLinksEnabled();
+            model.IsDNDocsLinksEnabled = _featureFlagService.IsDisplayDNDocsLinksEnabled();
             model.IsNuGetPackageExplorerLinkEnabled = _featureFlagService.IsDisplayNuGetPackageExplorerLinkEnabled();
             model.IsNuGetTrendsLinksEnabled = _featureFlagService.IsDisplayNuGetTrendsLinksEnabled();
             model.IsPackageRenamesEnabled = _featureFlagService.IsPackageRenamesEnabled(currentUser);

src/NuGetGallery/Helpers/ViewModelExtensions/DisplayPackageViewModelFactory.cs

@@ -174,6 +174,12 @@ private DisplayPackageViewModel SetupCommon(
                 viewModel.FuGetUrl = fugetReadyUrl;
             }
 
+            var dndocsUrl = $"https://dndocs.com/i/nuget/{package.Id}/{package.NormalizedVersion}";
+            if (PackageHelper.TryPrepareUrlForRendering(dndocsUrl, out string dndocsReadyUrl))
+            {
+                viewModel.DNDocsUrl = dndocsReadyUrl;
+            }
+
             var nugetPackageExplorerUrl = $"https://nuget.info/packages/{package.Id}/{package.NormalizedVersion}";
             if (PackageHelper.TryPrepareUrlForRendering(nugetPackageExplorerUrl, out string nugetPackageExplorerReadyUrl))
             {

src/NuGetGallery/NuGetGallery.csproj

@@ -1357,6 +1357,8 @@
     <Content Include="Areas\Admin\DynamicData\PageTemplates\ListDetails.aspx" />
     <Content Include="Content\admin\SupportRequestStyles.css" />
     <Content Include="Content\fabric.css" />
+    <Content Include="Content\gallery\img\dndocs-32x32.png" />
+    <Content Include="Content\gallery\img\dndocs.svg" />
     <Content Include="Content\gallery\img\logo-og-600x600.png" />
     <Content Include="Content\gallery\img\rss-24x24.png" />
     <Content Include="Content\Images\icons\apiKey.png" />
@@ -2400,4 +2402,4 @@
       copy "$(ProjectDir)..\Bootstrap\dist\js\bootstrap.js" "$(ProjectDir)Scripts\gallery" &gt;NUL
     </PreBuildEvent>
   </PropertyGroup>
-</Project>
+</Project>

src/NuGetGallery/ViewModels/DisplayPackageViewModel.cs

@@ -38,6 +38,7 @@ public class DisplayPackageViewModel : ListPackageItemViewModel
         public bool IsPackageDeprecationEnabled { get; set; }
         public bool IsPackageVulnerabilitiesEnabled { get; set; }
         public bool IsFuGetLinksEnabled { get; set; }
+        public bool IsDNDocsLinksEnabled { get; set; }
         public bool IsNuGetTrendsLinksEnabled { get; set; }
         public bool IsNuGetPackageExplorerLinkEnabled { get; set; }
         public bool IsPackageRenamesEnabled { get; set; }
@@ -89,6 +90,7 @@ public bool HasNewerRelease
         public string ProjectUrl { get; set; }
         public string LicenseUrl { get; set; }
         public string FuGetUrl { get; set; }
+        public string DNDocsUrl { get; internal set; }
         public string NuGetTrendsUrl { get; set; }
         public string NuGetPackageExplorerUrl { get; set; }
         public IReadOnlyCollection<string> LicenseNames { get; set; }
@@ -148,6 +150,11 @@ public bool CanDisplayFuGetLink()
             return IsFuGetLinksEnabled && !string.IsNullOrEmpty(FuGetUrl) && Available;
         }
 
+        public bool CanDisplayDNDocsLink()
+        {
+            return IsDNDocsLinksEnabled && !string.IsNullOrEmpty(DNDocsUrl) && Available;
+        }
+
         public bool CanDisplayNuGetTrendsLink()
         {
             return IsNuGetTrendsLinksEnabled && !string.IsNullOrEmpty(NuGetTrendsUrl) && Available;

src/NuGetGallery/Views/Packages/DisplayPackage.cshtml

@@ -1102,7 +1102,7 @@
                                 else
                                 {
                                     <a href="@Model.LicenseUrl"
-                                        data-track="outbound-license-url" title="Make sure you agree with the license" rel="nofollow">
+                                       data-track="outbound-license-url" title="Make sure you agree with the license" rel="nofollow">
                                         License Info
                                     </a>
                                 }
@@ -1134,8 +1134,8 @@
                         <li>
                             <i class="ms-Icon ms-Icon--FabricFolderSearch" aria-hidden="true" aria-label="@disclaimer" title="@disclaimer"></i>
                             <a href="@Model.NuGetPackageExplorerUrl" data-track="outbound-nugetpackageexplorer-url"
-                                aria-label="open in NuGet Package Explorer"
-                                title="Explore additional package info on NuGet Package Explorer" target="_blank" rel="nofollow noreferrer">
+                               aria-label="open in NuGet Package Explorer"
+                               title="Explore additional package info on NuGet Package Explorer" target="_blank" rel="nofollow noreferrer">
                                 Open in NuGet Package Explorer
                             </a>
                         </li>
@@ -1147,17 +1147,34 @@
 
                         <li>
                             <img class="icon"
-                                    aria-label="@disclaimer" title="@disclaimer"
-                                    src="@Url.Absolute("~/Content/gallery/img/fuget.svg")"
-                                    @ViewHelpers.ImageFallback(Url.Absolute("~/Content/gallery/img/fuget-32x32.png")) />
+                                 aria-label="@disclaimer" title="@disclaimer"
+                                 src="@Url.Absolute("~/Content/gallery/img/fuget.svg")"
+                                 @ViewHelpers.ImageFallback(Url.Absolute("~/Content/gallery/img/fuget-32x32.png")) />
                             <a href="@Model.FuGetUrl" data-track="outbound-fuget-url"
-                                aria-label="open in fuget.org explorer"
-                                title="Explore additional package info on fuget.org" target="_blank" rel="nofollow noreferrer">
+                               aria-label="open in fuget.org explorer"
+                               title="Explore additional package info on fuget.org" target="_blank" rel="nofollow noreferrer">
                                 Open in FuGet Package Explorer
                             </a>
                         </li>
                     }
 
+                    @if (Model.CanDisplayDNDocsLink() && Model.ShowDetailsAndLinks)
+                    {
+                        var disclaimer = "dndocs.com is a 3rd party website, not controlled by Microsoft. This link is made available to you per the NuGet Terms of Use.";
+
+                        <li>
+                            <img class="icon"
+                                 aria-label="@disclaimer" title="@disclaimer"
+                                 src="@Url.Absolute("~/Content/gallery/img/dndocs.svg")"
+                                 @ViewHelpers.ImageFallback(Url.Absolute("~/Content/gallery/img/dndocs-32x32.png")) />
+                            <a href="@Model.DNDocsUrl" data-track="outbound-dndocs-url"
+                               aria-label="open in dndocs.com explorer"
+                               title="Explore API on dndocs.com" target="_blank" rel="nofollow noreferrer">
+                                Open in DNDocs API Explorer
+                            </a>
+                        </li>
+                    }
+
                     @if (Model.CanDisplayNuGetTrendsLink() && Model.ShowDetailsAndLinks)
                     {
                         var disclaimer = "nugettrends.com is a 3rd party website, not controlled by Microsoft. This link is made available to you per the NuGet Terms of Use.";

src/NuGetGallery/Web.config

@@ -274,7 +274,7 @@
   -->
   <system.web>
     <httpCookies requireSSL="true" httpOnlyCookies="true"/>
-    <compilation debug="false" targetFramework="4.7.2">
+    <compilation debug="true" targetFramework="4.7.2">
       <assemblies>
         <add assembly="netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51"/>
       </assemblies>

src/VerifyMicrosoftPackage/Fakes/FakeFeatureFlagService.cs

@@ -33,6 +33,8 @@ public class FakeFeatureFlagService : IFeatureFlagService
         public bool IsManagePackagesVulnerabilitiesEnabled() => throw new NotImplementedException();
 
         public bool IsDisplayFuGetLinksEnabled() => throw new NotImplementedException();
+
+        public bool IsDisplayDNDocsLinksEnabled() => throw new NotImplementedException();
 
         public bool AreEmbeddedIconsEnabled(User user) => throw new NotImplementedException();
 

tests/NuGetGallery.Facts/ViewModels/DisplayPackageViewModelFacts.cs

@@ -295,6 +295,57 @@ public void CannotDisplayFuGetLinkWhenInvalid(bool isEnabled, string url, bool i
             Assert.False(model.CanDisplayFuGetLink());
         }
 
+        [Theory]
+        [InlineData("foo", "1.0.0", "https://dndocs.com/i/nuget/foo/1.0.0")]
+        [InlineData("foo", "1.1.0", "https://dndocs.com/i/nuget/foo/1.1.0")]
+        [InlineData("Foo.Bar", "1.1.0-bETa", "https://dndocs.com/i/nuget/Foo.Bar/1.1.0-bETa")]
+        public void ItInitializesDNDocsUrl(string packageId, string packageVersion, string expected)
+        {
+            var package = new Package
+            {
+                Version = packageVersion,
+                NormalizedVersion = packageVersion,
+                PackageRegistration = new PackageRegistration
+                {
+                    Id = packageId,
+                    Owners = Enumerable.Empty<User>().ToList(),
+                    Packages = Enumerable.Empty<Package>().ToList()
+                }
+            };
+
+            var model = CreateDisplayPackageViewModel(package, currentUser: null, packageKeyToDeprecation: null, readmeHtml: null);
+            Assert.Equal(expected, model.DNDocsUrl);
+        }
+
+
+        [Theory]
+        [InlineData(false, "https://dndocs.com/i/nuget/foo/1.0.0", true)]
+        [InlineData(true, "", true)]
+        [InlineData(true, null, true)]
+        [InlineData(true, "https://dndocs.com/i/nuget/foo/1.0.0", false)]
+        public void CannotDisplayDNDocsLinkWhenInvalid(bool isEnabled, string url, bool isAvailable)
+        {
+            var package = new Package
+            {
+                Version = "1.0.0",
+                NormalizedVersion = "1.0.0",
+                PackageRegistration = new PackageRegistration
+                {
+                    Id = "foo",
+                    Owners = Enumerable.Empty<User>().ToList(),
+                    Packages = Enumerable.Empty<Package>().ToList()
+                }
+            };
+
+            var model = CreateDisplayPackageViewModel(package, currentUser: null, packageKeyToDeprecation: null, readmeHtml: null);
+
+            model.IsDNDocsLinksEnabled = isEnabled;
+            model.DNDocsUrl = url;
+            model.Available = isAvailable;
+
+            Assert.False(model.CanDisplayDNDocsLink());
+        }
+
         [Fact]
         public void ItInitializesNuGetTrendsUrl()
         {