UPD | docs: threadpoolfs & blocked signals

Author: xiadnoring

docs/content/docs/intro/blockedsignals.mdx

@@ -0,0 +1,38 @@
+---
+title: Blocked Signals
+description: Managing Blocked Signals
+---
+
+In networking, errors can sometimes generate special signals that need to be handled. If ignored, these signals may terminate our program unexpectedly.
+
+```cpp
+#include <manapihttp/ManapiEventLoop.hpp>
+#include <manapihttp/std/ManapiAsyncContext.hpp>
+
+int main(int argc, char *argv[]) {
+    auto blockedsignals = manapi::async::context::blockedsignals();
+
+    // Ignore SIGABRT
+    sigaddset(blockedsignals.get(), SIGABRT);
+    pthread_sigmask(SIG_BLOCK, blockedsignals.get(), nullptr);
+
+    manapi::async::context::gbs(std::move(blockedsignals));
+
+    return 0;
+}
+```
+
+<Callout title="Information">```manapi::async::context::blockedsignals()``` returns a sigset_t with ```SIGPIPE``` already blocked by default.</Callout>
+
+For most use cases, the default configuration is sufficient:
+
+```cpp
+#include <manapihttp/ManapiEventLoop.hpp>
+#include <manapihttp/std/ManapiAsyncContext.hpp>
+
+int main(int argc, char *argv[]) {
+    manapi::async::context::gbs(manapi::async::context::blockedsignals());
+
+    return 0;
+}
+```

docs/content/docs/intro/threadpoolfs.mdx

@@ -0,0 +1,61 @@
+---
+title: ThreadPoolFs
+description: Thread Pool for Blocking Filesystem Operations
+---
+
+Operating systems contain many blocking operations. To handle these efficiently, ManapiHttp provides the ThreadPoolFs method, which sets up a thread pool specifically for blocking operations (particularly filesystem operations). Users can also add their own tasks to ThreadPoolFs. Note that ThreadPoolFs cannot be modified while the event loop is running.
+
+<Callout title="Information">The default size for ThreadPoolFs is 4 threads.</Callout>
+
+### Initialize ThreadPoolFs
+```cpp
+#include <manapihttp/std/ManapiAsyncContext.hpp>
+
+int main(int argc, char *argv[]) {
+    /* Configures event loops to use 2 threads for blocking I/O system calls */
+    manapi::async::context::threadpoolfs(2);
+
+    return 0;
+}
+```
+
+### Create a Task
+```cpp
+#include <chrono>
+#include <thread>
+
+#include <manapihttp/ManapiDebug.hpp>
+#include <manapihttp/ManapiEventLoop.hpp>
+#include <manapihttp/std/ManapiAsyncContext.hpp>
+
+int main(int argc, char *argv[]) {
+    manapi::async::context::threadpoolfs(2);
+    auto ctx = manapi::async::context::create().unwrap();
+
+    ctx->run([](std::function<void()> bind) -> void {
+        manapi::async::current()->eventloop()->append_task([](const manapi::ev::shared_work &w) -> void {
+            // This executes in a worker thread
+            assert(!manapi::async::context_exists());
+
+            std::chrono::seconds duration(5);
+            std::this_thread::sleep_for(duration);
+
+            manapi_log_debug("Waiting has finished");
+        }, [](const manapi::ev::shared_work &w, int status) -> void {
+            // This executes back in the main event loop thread
+            assert(manapi::async::context_exists());
+            
+            manapi_log_debug("Waiting has finished with status: %d", status);
+
+            // Stop the event loop
+            manapi::async::run(manapi::async::current()->eventloop()->stop());
+        });
+
+        manapi_log_debug("Waiting has started");
+
+        bind();
+    });
+
+    return 0;
+}
+```

docs/content/docs/meta.json

@@ -5,6 +5,8 @@
         "intro/install", 
         "intro/quick-start",
         "intro/syslogs",
+        "intro/threadpoolfs",
+        "intro/blockedsignals",
         "---Data Formats---",
         "data-formats/json"
     ]