docs(): some tweaks to the streaming files chapter

Author: kamilmysliwiec

content/techniques/streaming-files.md

@@ -1,6 +1,8 @@
-### Streaming Files
+### Streaming files
 
-There won't always be a time where you're sending back JSON or string responses. There may be times where you'd like to send back a file from the server to the client. To do this with Nest, normally you'd do te following:
+> info **Note** This chapter shows how you can stream files from your **HTTP application**. The examples presented below do not apply to GraphQL or Microservice applications.
+
+There may be times where you would like to send back a file from your REST API to the client. To do this with Nest, normally you'd do the following:
 
 ```ts
 @Controller('file')
@@ -13,20 +15,22 @@ export class FileController {
 }
 ```
 
-to manage sending the file back. This is still doable in Nest, by injecting `@Res()` in the controller, but in doing so you end up losing access to your post-controller interceptor logic. To handle this, you can return a `StreamableFile` instance and under the hood Nest will take care of piping the response.
+But in doing so you end up losing access to your post-controller interceptor logic. To handle this, you can return a `StreamableFile` instance and under the hood, the framework will take care of piping the response.
 
-#### Streamable File
+#### Streamable File class
 
-A `StreamableFile` is as class that holds onto the stream that is to be returned. To create a new `StreamableFile`, you can pass either a `Buffer` or a `Stream` to the `StreamableFile` constructor.
+A `StreamableFile` is a class that holds onto the stream that is to be returned. To create a new `StreamableFile`, you can pass either a `Buffer` or a `Stream` to the `StreamableFile` constructor.
 
 > info **hint** The `StreamableFile` class can be imported from `@nestjs/common`.
 
-#### Cross Platform Support
+#### Cross-platform support
 
-Fastify, by default, can support sending files without needing to `stream.pipe(res)`, so you don't need to use the `StreamableFile` class. However, Nest supports the use of `StreamableFile` in both platform types, so if you end up switching between Express and Fastify there's no need to worry about compatibility between the two engines.
+Fastify, by default, can support sending files without needing to call `stream.pipe(res)`, so you don't need to use the `StreamableFile` class at all. However, Nest supports the use of `StreamableFile` in both platform types, so if you end up switching between Express and Fastify there's no need to worry about compatibility between the two engines.
 
 #### Example
 
+You can find a simple example of returning the `package.json` as a file instead of a JSON below, but the idea extends out naturally to images, documents, and any other file type.
+
 ```ts
 import { Controller, Get, StreamableFile } from '@nestjs/common';
 import { createReadStream } from 'fs';
@@ -41,6 +45,3 @@ export class FileController {
   }
 }
 ```
-
-This is of course a simple example of returning the `package.json` as a file instead of a JSON, but the idea extends out naturally to images, documents, and any other file type.
-

src/app/homepage/menu/menu.component.ts

@@ -95,7 +95,7 @@ export class MenuComponent implements OnInit {
         { title: 'Events', path: '/techniques/events' },
         { title: 'Compression', path: '/techniques/compression' },
         { title: 'File upload', path: '/techniques/file-upload' },
-        { title: 'Streaming Files', path: '/techniques/streaming-files' },
+        { title: 'Streaming files', path: '/techniques/streaming-files' },
         { title: 'HTTP module', path: '/techniques/http-module' },
         { title: 'Session', path: '/techniques/session' },
         { title: 'Model-View-Controller', path: '/techniques/mvc' },