Update doc & API improvement

Author: csmir

src/Commands.Http/Commands.Http/Results/HttpResult.cs

@@ -63,13 +63,33 @@ public class HttpResult : IHttpResult
     /// <inheritdoc />
     public IDictionary<string, string> Headers { get; } = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
 
+    /// <summary>
+    ///     Initializes a new instance of the <see cref="HttpResult"/> class with the specified status code.
+    /// </summary>
+    /// <param name="code">The numeric status code of this result. Converted to a value of <see cref="HttpStatusCode"/> on initialization.</param>
+    public HttpResult(int code)
+        : this((HttpStatusCode)code)
+    {
+    }
+
     /// <summary>
     ///     Initializes a new instance of the <see cref="HttpResult"/> class with the specified status code.
     /// </summary>
     /// <param name="code">The status code of this result.</param>
     public HttpResult(HttpStatusCode code)
         => StatusCode = code;
 
+    /// <summary>
+    ///     Initializes a new instance of the <see cref="HttpResult"/> class with the specified status code, content, and content type.
+    /// </summary>
+    /// <param name="code">The status code of this result. Converted to a value of <see cref="HttpStatusCode"/> on initialization.</param>
+    /// <param name="content">The content of this result.</param>
+    /// <param name="contentType">The content type of this result.</param>
+    public HttpResult(int code, [DisallowNull] object content, string? contentType = null)
+        : this((HttpStatusCode)code, content, contentType)
+    {
+    }
+
     /// <summary>
     ///     Initializes a new instance of the <see cref="HttpResult"/> class with the specified status code, content, and content type.
     /// </summary>

src/Commands.Samples/Commands.Samples.Http/Program.cs

@@ -62,7 +62,7 @@
 
     // This adds a command that can be invoked via HTTP GET requests under the following url: http://localhost:5000/ping.
     // The command responds with a simple "OK!" message.
-    components.Add(new Command([HttpGet] () => new HttpResult(HttpStatusCode.OK), "ping"));
+    components.Add(new Command([HttpGet] () => new HttpResult(200), "ping"));
 
     // This adds a command that can be invoked via HTTP GET requests under the following url: http://localhost:5000/help.
     // The command lists all available commands in the component tree, providing a simple way to discover what commands are available.

wiki/v2/Http.md

@@ -56,7 +56,7 @@ host.UseComponents(components =>
 {
     components.Add(new Command([HttpGet] () =>
     {
-        return HttpResult.Ok("OK!");
+        return new HttpResult(200);
     }, "ping"));
 });
 
@@ -87,7 +87,7 @@ public sealed class HttpModule : HttpCommandModule<HttpCommandContext>
 {
     [HttpGet("get")]
     public IHttpResult Get(int initialValue, Guid anotherValue)
-        => HttpResult.Ok($"Hello World; {initialValue}, {anotherValue}");
+        => Ok($"Hello World; {initialValue}, {anotherValue}");
 }
 ```
 
@@ -104,7 +104,7 @@ public sealed class HttpModule : HttpCommandModule<HttpCommandContext>
 {
     [HttpPost("post")]
     public IHttpResult Post([JsonBody] string content)
-        => HttpResult.Ok($"Received: {content}");
+        => Ok($"Received: {content}");
 }
 ```
 
@@ -128,7 +128,7 @@ public sealed class HttpModule : HttpCommandModule<HttpCommandContext>
 {
     [HttpMethod("CUSTOM", "custom")]
     public IHttpResult CustomMethod()
-        => HttpResult.Ok("This is a custom HTTP method response.");
+        => Ok("This is a custom HTTP method response.");
 }
 ```