Improved Code Examples in Docs

docs/content/get-started/define-control-points.md

@@ -43,7 +43,7 @@
 
 In the organization created within Aperture Cloud, navigate to the
 **`Aperture`** tab in the sidebar menu. From there, select **`Agent API Keys`**
 in the top bar. This is where you can find and copy the **`AGENT_API_KEY`** and
 use it in the SDK as follows:
 
 :::
@@ -69,16 +69,16 @@
 ```
 
 Once you have configured Aperture SDK, you can create a feature control point
-wherever you want in your code. Before executing the business logic of a
-specific API, you can create a feature control point that can control the
-execution flow of the API and can reject the request based on the policy defined
-in Aperture. The [Create Your First Policy](./policies/policies.md) section
-showcases how to define policy in Aperture. The code snippet below shows how to
-wrap your [Control Point](/concepts/control-point.md) within the `StartFlow`
-call and pass [labels](/concepts/flow-label.md) that will be matched with
-policy. The function `Flow.ShouldRun()` checks if the flow allows the request.
-The `Flow.End()` function is responsible for sending telemetry, and updating the
-specified cache entry within Aperture.
+anywhere within your code. Before executing the business logic of a specific
+API, you can create a feature control point that can control the execution flow
+of the API and can reject the request based on the policy defined in Aperture.
+The [Create Your First Policy](./policies/policies.md) section showcases how to
+define policy in Aperture. The code snippet below shows how to wrap your
+[Control Point](/concepts/control-point.md) within the `StartFlow` call and pass
+[labels](/concepts/flow-label.md) to Aperture Agents. The function
+`Flow.ShouldRun()` checks if the flow allows the request. The `Flow.End()`
+function is responsible for sending telemetry, and updating the specified cache
+entry within Aperture.
 
 Let's create a feature control point in the following code snippet.
 
@@ -88,19 +88,20 @@
 ```
 
 ```typescript
-async function handleFlow() {
+async function handleRequest(req, res) {
   const flow = await apertureClient.StartFlow("archimedes-service", {
     labels: {
-      label_key: "api_key",
-      interval: "60",
+      api_key: "some_api_key",
     },
     grpcCallOptions: {
-      deadline: Date.now() + 1200000, // 20 minutes deadline
+      deadline: Date.now() + 300, // ms
     },
   });
 
   if (flow.ShouldRun()) {
     // Do Actual Work
+    // After completing the work, you can return a response, for example:
+    res.send({ message: "foo" });
   } else {
     // Handle flow rejection
     flow.SetStatus(FlowStatusEnum.Error);

docs/content/guides/per-user-rate-limiting.md

@@ -50,13 +50,13 @@
 :::note
 
 The following policy is based on the
 [Rate Limiting](/reference/blueprints/rate-limiting/base.md) blueprint.
 
 :::
 
 ## Rate Limiting with Aperture SDK
 
 The first step to use Aperture SDK is to import and set up Aperture Client:
 
 ```mdx-code-block
 <Tabs>
@@ -90,14 +90,13 @@
 ```
 
 ```javascript
-async function handleFlow() {
+async function handleRequest(req, res) {
   const flow = await apertureClient.StartFlow("awesomeFeature", {
     labels: {
-      label_key: "some_user_id",
-      interval: "1s",
+      user_id: "some_user_id",
     },
     grpcCallOptions: {
-      deadline: Date.now() + 1200000, // 20 minutes deadline
+      deadline: Date.now() + 300, // ms
     },
   });
 
@@ -124,8 +123,8 @@
 ## Configuration
 
 This policy is based on the
 [Rate Limiting](/reference/blueprints/rate-limiting/base.md) blueprint. It
 applies a rate limiter to the **`awesomeFeature`** and identifies unique users
 by referencing the **`user_id`**.
 
 Each user is allowed **`2`** requests every **`1s`** (1 second) period. A burst

docs/content/sdk/dotnet/manual.md

@@ -28,7 +28,7 @@ more information, refer to
 
 :::
 
-```csharp
+```cpp
 var sdk = ApertureSdk
     .Builder()
     .SetAddress("ORGANIZATION.app.fluxninja.com:443")
@@ -38,7 +38,7 @@ var sdk = ApertureSdk
 
 The created instance can then be used to start a flow:
 
-```csharp
+```cpp
 // do some business logic to collect labels
 
 var labels = new Dictionary<string, string>();

docs/content/sdk/javascript/manual.md

@@ -37,14 +37,13 @@ export const apertureClient = new ApertureClient({
 The created instance can then be used to start a flow:
 
 ```javascript
-async function handleFlow() {
+async function handleRequest(req, res) {
   const flow = await apertureClient.StartFlow("feature-name", {
     labels: {
       label_key: "some_user_id",
-      interval: "60",
     },
     grpcCallOptions: {
-      deadline: Date.now() + 1200000, // 20 minutes deadline
+      deadline: Date.now() + 300, // ms
     },
   });