Minor fixes

docs/how-to-guides/configure-service.md

@@ -35,9 +35,9 @@ configure(
 
 The only aspect that cannot be automated is choosing the backing storage for the database and file storage.
 
-Right now, you have 3 options for storing the models and large datasets: [great_ai.large_file.LargeFileLocal][], [great_ai.large_file.LargeFileMongo][], and [great_ai.large_file.LargeFileS3][].
+Right now, you have 3 options for storing the models and large datasets: [LargeFileLocal][great_ai.large_file.LargeFileLocal], [LargeFileMongo][great_ai.large_file.LargeFileMongo], and [LargeFileS3][great_ai.large_file.LargeFileS3].
 
-Without explicit configuration, [great_ai.large_file.LargeFileLocal][] is selected by default. This one still version-controls your files but it only stores them in a local path.
+Without explicit configuration, [LargeFileLocal][great_ai.large_file.LargeFileLocal] is selected by default. This one still version-controls your files but it only stores them in a local path.
 
 !!! important
     If your working directory contains a `mongo.ini` or `s3.ini` file, an attempt is made to auto-configure [LargeFileMongo][great_ai.large_file.LargeFileMongo] or [LargeFileS3][great_ai.large_file.LargeFileS3] respectively.
@@ -76,6 +76,7 @@ save_model(model, 'my-model')
 MONGO_CONNECTION_STRING=mongodb://localhost:27017  # this is the default value
 # if `MONGO_CONNECTION_STRING` is specified, this default is overridden
 MONGO_CONNECTION_STRING=ENV:MONGO_CONNECTION_STRING
+
 MONGO_DATABASE=my-database  # it is automatically created if doesn't exist
 ```
 
@@ -98,4 +99,4 @@ By default, a thread-safe version of [TinyDB](https://tinydb.readthedocs.io/en/l
 
 ### MongoDB
 
-At the moment, only MongoDB is supported as a production-ready `TracingDatabase`. In order to use it, you have to either place a file named `mongo.ini` in your working directory, or explicitly call [MongoDbDriver.configure_credentials_from_file][great_ai.MongoDbDriver.configure_credentials_from_file] or [MongoDbDriver.configure_credentials][great_ai.MongoDbDriver.configure_credentials].
+At the moment, only MongoDB is supported as a production-ready `TracingDatabase`. In order to use it, you have to either place a file named `mongo.ini` in your working directory, or explicitly call [MongoDbDriver.configure_credentials_from_file][great_ai.MongoDbDriver] or [MongoDbDriver.configure_credentials][great_ai.MongoDbDriver.configure_credentials].

docs/how-to-guides/create-service.md

@@ -24,7 +24,7 @@ def greeter(your_name):
 
 ## With types
 
-[Type annotating your codebase](https://realpython.com/python-type-checking/){ target=_blank } can save you from lots of trivial mistakes, that's why it's highly advised. Simply add the expected types to your function's signature.
+Even though it's not required by GreatAI, [type annotating your codebase](https://realpython.com/python-type-checking/){ target=_blank } can save you from lots of trivial mistakes, that's why it's highly advised. Simply add the expected types to your function's signature.
 
 ```python title="type_safe_greeter.py"
 from great_ai import GreatAI
@@ -100,7 +100,7 @@ assert type_safe_greeter('Andras').output == 'Hi Andras'
 Refer to the following example summarising the options you have when instantiating a GreatAI service.
 
 ```python title="complex.py"
-from great_ai import save_model, GreatAI, parameter, use_model
+from great_ai import save_model, GreatAI, parameter, use_model, log_metric
 
 save_model(4, 'secret-number')  #(1)
 
@@ -108,6 +108,10 @@ save_model(4, 'secret-number')  #(1)
 @parameter('positive_number', validator=lambda n: n > 0, disable_logging=True)
 @use_model('secret-number', version='latest', model_kwarg_name='secret')
 def add_number(positive_number: int, secret: int) -> int:
+    log_metric(
+        'log directly into the returned Trace', 
+        positive_number * 2
+    )
     return positive_number + secret
 
 assert add_number(1).output == 5

docs/how-to-guides/use-service.md

@@ -51,7 +51,8 @@ Some configuration options are also supported.
 ```sh
 great-ai greeter.py --port 8000 --host 127.0.0.1 --timeout_keep_alive 10
 ```
-> For more options (but no Notebook support, use [uvicorn](https://www.uvicorn.org/){ target=_blank })
+??? note "More options"
+    For more options (but no Notebook support), simply use [uvicorn](https://www.uvicorn.org/){ target=_blank } for starting your app (available at `greeter.app`).
 
 ### In production
 
@@ -80,7 +81,7 @@ docker run -p 6060:6060 --volume `pwd`:/app --rm \
 
 #### Use a Platform-as-a-Service
 
-Similarly to the previous approach, your code will run in a container. However, instead of manually managing it, you can just choose from a plethora of PaaS providers (such as [DO App platform](https://www.digitalocean.com/products/app-platform){ target=_blank } or [MLEM](https://mlem.ai/){ target=_blank }) that take a Docker image as a source and handle the rest of the deployment.
+Similarly to the previous approach, your code will run in a container. However, instead of manually managing it, you can just choose from a plethora of PaaS providers (such as [AWS ECS](https://aws.amazon.com/ecs/){ target=_blank }, [DO App platform](https://www.digitalocean.com/products/app-platform){ target=_blank }, [MLEM](https://mlem.ai/){ target=_blank }) that take a Docker image as a source and handle the rest of the deployment.
 
 To this end, you can also create a custom Docker image. It is especially useful if you have third-party dependencies, such as [PyTorch](https://pytorch.org/){ target=_blank } or [TensorFlow](https://www.tensorflow.org/){ target=_blank }.