diff --git a/src/Cake.Common/Tools/DotNetCore/DotNetCoreAliases.cs b/src/Cake.Common/Tools/DotNetCore/DotNetCoreAliases.cs
index 4258abc43b..b31c31f1f3 100644
--- a/src/Cake.Common/Tools/DotNetCore/DotNetCoreAliases.cs
+++ b/src/Cake.Common/Tools/DotNetCore/DotNetCoreAliases.cs
@@ -150,10 +150,10 @@ public static void DotNetCoreRestore(this ICakeContext context, string root)
         ///     {
         ///         Sources = new[] {"https://www.example.com/nugetfeed", "https://www.example.com/nugetfeed2"},
         ///         FallbackSources = new[] {"https://www.example.com/fallbacknugetfeed"},
-        ///         Packages = "./packages",
+        ///         PackagesDirectory = "./packages",
         ///         Verbosity = Information,
         ///         DisableParallel = true,
-        ///         Runtimes = new[] {"runtime1", "runtime2"}
+        ///         InferRuntimes = new[] {"runtime1", "runtime2"}
         ///     };
         ///
         ///     DotNetCoreRestore(settings);
@@ -179,10 +179,10 @@ public static void DotNetCoreRestore(this ICakeContext context, DotNetCoreRestor
         ///     {
         ///         Sources = new[] {"https://www.example.com/nugetfeed", "https://www.example.com/nugetfeed2"},
         ///         FallbackSources = new[] {"https://www.example.com/fallbacknugetfeed"},
-        ///         Packages = "./packages",
+        ///         PackagesDirectory = "./packages",
         ///         Verbosity = Information,
         ///         DisableParallel = true,
-        ///         Runtimes = new[] {"runtime1", "runtime2"}
+        ///         InferRuntimes = new[] {"runtime1", "runtime2"}
         ///     };
         ///
         ///     DotNetCoreRestore("./src/*", settings);
@@ -235,7 +235,7 @@ public static void DotNetCoreBuild(this ICakeContext context, string project)
         /// <code>
         ///     var settings = new DotNetCoreBuildSettings
         ///     {
-        ///         Frameworks = new[] { "net451", "dnxcore50" },
+        ///         Framework = "netcoreapp1.0",
         ///         Configuration = "Debug",
         ///         OutputDirectory = "./artifacts/"
         ///     };
@@ -290,8 +290,7 @@ public static void DotNetCorePack(this ICakeContext context, string project)
         /// <code>
         ///     var settings = new DotNetCorePackSettings
         ///     {
-        ///         Frameworks = new[] { "dnx451", "dnxcore50" },
-        ///         Configurations = new[] { "Debug", "Release" },
+        ///         Configuration = "Release",
         ///         OutputDirectory = "./artifacts/"
         ///     };
         ///
@@ -382,7 +381,7 @@ public static void DotNetCoreRun(this ICakeContext context, string project, Proc
         /// <code>
         ///     var settings = new DotNetCoreRunSettings
         ///     {
-        ///         Framework = "dnxcore50",
+        ///         Framework = "netcoreapp1.0",
         ///         Configuration = "Release"
         ///     };
         ///
@@ -436,7 +435,7 @@ public static void DotNetCorePublish(this ICakeContext context, string project)
         /// <code>
         ///     var settings = new DotNetCorePublishSettings
         ///     {
-        ///         Framework = "dnxcore50",
+        ///         Framework = "netcoreapp1.0",
         ///         Configuration = "Release",
         ///         OutputDirectory = "./artifacts/"
         ///     };
diff --git a/src/Cake.Common/Tools/GitReleaseManager/Close/GitReleaseManagerMilestoneCloser.cs b/src/Cake.Common/Tools/GitReleaseManager/Close/GitReleaseManagerMilestoneCloser.cs
index 2d9dfc5cbc..0ee8d57c00 100644
--- a/src/Cake.Common/Tools/GitReleaseManager/Close/GitReleaseManagerMilestoneCloser.cs
+++ b/src/Cake.Common/Tools/GitReleaseManager/Close/GitReleaseManagerMilestoneCloser.cs
@@ -32,7 +32,7 @@ public GitReleaseManagerMilestoneCloser(
         }
 
         /// <summary>
-        /// Creates a Release using the specified and settings.
+        /// Creates a Release using the specified settings.
         /// </summary>
         /// <param name="userName">The user name.</param>
         /// <param name="password">The password.</param>