Skip to content

Commit

Permalink
Merge pull request #993 from TypedProject/rc-fix-doc-typos
Browse files Browse the repository at this point in the history
Fix typos in README
  • Loading branch information
Romakita committed Oct 12, 2020
2 parents c2a3c70 + 4d54b9f commit 4a2bf8a
Show file tree
Hide file tree
Showing 4 changed files with 45 additions and 48 deletions.
22 changes: 11 additions & 11 deletions docs/getting-started/README.md
Expand Up @@ -44,8 +44,8 @@ to develop your application.

It uses [Express.js](https://expressjs.com/) HTTP server frameworks by default, but it's also possible to use [Koa.js](https://koajs.com) as well.

Ts.ED provides a level of abstraction above theses common Node.js framework (Express/Koa) with the [Platform API](/docs/platform-api.md)
but also exposes their APIs directly for the developer. This gives developers the freedom to use the myriad of third-party
Ts.ED provides a level of abstraction above these common Node.js frameworks (Express/Koa) with the [Platform API](/docs/platform-api.md)
but also exposes their APIs directly for the developer. It gives developers the freedom to use the myriad of third-party
node modules which are available for the underlying platform.

## Philosophy
Expand All @@ -61,7 +61,7 @@ To achieve this, Ts.ED provides out-of-the-box an application architecture, high

## Platform features support

Here the features list provided by Ts.ED and the compatibility with the different platforms:
Here are the features list provided by Ts.ED and the compatibility with the different platforms:

<div class="table-features">

Expand All @@ -86,7 +86,7 @@ Features | Express.js | Koa.js

## Platform plugins support

Here the plugins provided by Ts.ED and the compatibility with the different platforms:
Here are the plugins provided by Ts.ED and the compatibility with the different platforms:

<div class="table-features">

Expand Down Expand Up @@ -141,10 +141,10 @@ You can therefore use it for your projects without installing the whole framewor
::: tip See also
New features are available:

- [Managing models using Typescript generics](/docs/controllers.md#generics).
- [Manage models using Typescript generics](/docs/controllers.md#generics).
- [Add validation decorator on endpoint parameters](/docs/controllers.md#validation)
- [Management response models by content-type and status code (OAS3)](/tutorials/swagger.md).
- [Configure swagger to generate OpenSpec3](/tutorials/swagger.md).
- [Manage response models by content-type and status code (OAS3)](/tutorials/swagger.md).
- [Configure Swagger to generate OpenSpec3](/tutorials/swagger.md).

:::

Expand All @@ -159,9 +159,9 @@ You can therefore use it for your projects without installing the whole framewor

::: tip See also

- @@Ignore@@ decorator accept a callback to define when the property should be ignored!
- @@Ignore@@ decorator accepts a callback to define when the property should be ignored.
- @@serialize@@ and @@deserialize@@ function can be used in place of @@ConverterService@@.
- `@Converter` have been replaced in favor of @@JsonMapper@@. See our [migration guide](/gettings-started/migration-from-v5.md#converter-to-jsonmapper).
- `@Converter` has been replaced in favor of @@JsonMapper@@. See our [migration guide](/gettings-started/migration-from-v5.md#converter-to-jsonmapper).

:::

Expand All @@ -188,15 +188,15 @@ Alternatively, you can checkout one of these projects:

<Projects type="getting-started" />

If none of previous solutions aren't satisfying maybe you are in these cases:
If none of previous solutions are satisfying maybe you are in these cases:

- [I want to create application from scratch](/getting-started/from-scratch.md)
- [I want to migrate my application from Ts.ED v5](/getting-started/migration-from-v5.md)
- [I want to migrate my application from Express.js](/getting-started/migrate-from-express.md)

## What's next?

Now we can follow one of these links to develop your new application:
Now you can follow one of these links to develop your new application:

- [Create your first controller](/getting-started/create-your-first-controller.md)
- [Change server configuration](/docs/configuration.md)
Expand Down
6 changes: 3 additions & 3 deletions docs/getting-started/create-your-first-controller.md
Expand Up @@ -11,8 +11,8 @@ meta:
# Create your first controller

Create a new `CalendarCtrl.ts` in your controllers directory (by default `root/controllers`).
All controllers declared with @@Controller@@ decorators are considered as Express routers.
An Express router requires a path (here, the path is `/calendars`) to expose an url on your server.
All controllers declared with @@Controller@@ decorators are considered as Platform routers (Express.Router, Koa.Router, ...).
A Platform router requires a path (here, the path is `/calendars`) to expose an url on your server.
More precisely, it's a part of a path, and the entire exposed url depends on the Server configuration (see [Configuration](configuration.md))
and the [children controllers](/docs/controllers.md).

Expand All @@ -22,7 +22,7 @@ So the controller's url will be `http://host/rest/calendars`.
<<< @/docs/docs/snippets/controllers/basic-controller.ts

::: tip
Decorators @@Get@@, @@Post@@, @@Delete@@, @@Put@@, etc..., support dynamic pathParams (eg: `/:id`) and `RegExp` like Express API.
Decorators @@Get@@, @@Post@@, @@Delete@@, @@Put@@, etc., support dynamic pathParams (eg: `/:id`) and `RegExp` like Express API.

See [Controllers](/docs/controllers.md) section for more details
:::
Expand Down
61 changes: 30 additions & 31 deletions docs/getting-started/migration-from-v5.md
Expand Up @@ -43,9 +43,9 @@ You can therefore use it for your projects without installing the whole framewor
::: tip See also
New features are available:

- [Managing models using Typescript generics](/docs/controllers.md#generics).
- [Add validation decorator on endpoint parameters](/docs/controllers.md#validation)
- [Management response models by content-type and status code (OAS3)](/tutorials/swagger.md).
- [Manage models using Typescript generics](/docs/controllers.md#generics).
- [Add validation decorator on endpoint parameters](/docs/controllers.md#validation).
- [Manage response models by content-type and status code (OAS3)](/tutorials/swagger.md).
- [Configure swagger to generate OpenSpec3](/tutorials/swagger.md).

:::
Expand All @@ -67,18 +67,18 @@ You can therefore use it for your projects without installing the whole framewor

::: tip See also

- @@Ignore@@ decorator accept a callback to define when the property should be ignored!
- @@Ignore@@ decorator accepts a callback to define when the property should be ignored.
- @@serialize@@ and @@deserialize@@ function can be used in place of @@ConverterService@@.
- `@Converter` have been replaced in favor of @@JsonMapper@@. See our [migration guide](/gettings-started/migration-from-v5.md#converter-to-jsonmapper).
- `@Converter` has been replaced in favor of @@JsonMapper@@. See our [migration guide](/gettings-started/migration-from-v5.md#converter-to-jsonmapper).

:::

## Breaking changes
### Api & Features

- `ServerLoader` API have been remove in favor of Platform API. See [Platform API](/docs/platform-api.md).
- `Filter` feature have been removed in favor of [Pipes](/docs/pipes.md).
- `GlobalErrorHandlerMiddleware` have been.removed in favor of [Exception Filters](/docs/exceptions.md#exception-filter).
- `ServerLoader` API has been remove in favor of Platform API. See [Platform API](/docs/platform-api.md).
- `Filter` feature has been removed in favor of [Pipes](/docs/pipes.md).
- `GlobalErrorHandlerMiddleware` has been removed in favor of [Exception Filters](/docs/exceptions.md#exception-filter).
- @@ConverterService@@ doesn't perform data validation. Validation is performed by [`@tsed/ajv`](/tutorials/ajv.md) package or any other validation library.

### Modules
Expand All @@ -100,10 +100,10 @@ The following decorators have been removed:
#### @tsed/common

- `@ServerSettings`: Use @@Configuration@@.
- `@ExpressApplication`: Use @@PlatformApplication@@ instead of.
- `@ExpressRouter`: Use @@PlatformRouter@@ instead of.
- `@ResponseView`: Use @@View@@ decorator instead of.
- `@Filter`: Filter feature have been removed.
- `@ExpressApplication`: Use @@PlatformApplication@@ instead.
- `@ExpressRouter`: Use @@PlatformRouter@@ instead.
- `@ResponseView`: Use @@View@@ decorator instead.
- `@Filter`: Filter feature has been removed.
- `@MiddlewareError`: Use @@Middleware@@.
- `@Converter`: @Converter is replaced by @@JsonMapper@@ from `@tsed/json-mapper`. See [Converter to JsonMapper](/getting-started/migration-from-v5.md#converter-to-jsonmapper) section for more details.
- `PropertyDeserialize` and `PropertySerialize` have been removed and replaced by @@OnDeserialize@@ and @@OnSerialize@@ from `@tsed/json-mapper`.
Expand All @@ -118,29 +118,29 @@ Import the following decorators from `@tsed/schema`:

<ApiList query="['Consumes', 'Deprecated', 'Description', 'Example', 'Name', 'Produces', 'Returns','Security', 'Summary', 'Title'].includes(symbolName)" />

- `@BaseParameter` have been removed.
- `@Operation` have been removed.
- `@Responses` have been remove.
- `@ReturnsArray` have been removed. Use @@Returns@@ from `@tsed/schema`.
- `@BaseParameter` has been removed.
- `@Operation` has been removed.
- `@Responses` has been remove.
- `@ReturnsArray` has been removed. Use @@Returns@@ from `@tsed/schema`.

### Classes

#### @tsed/common

- Classes like `ArrayConverter`, `SetConverter`, etc... replaced by his equivalents @@ArrayMapper@@, @@SetMapper@@, etc... These classes cannot be injected to another provider.
- Classes like `ArrayConverter`, `SetConverter`, etc... are replaced by their equivalents @@ArrayMapper@@, @@SetMapper@@, etc... These classes cannot be injected to another provider.


## Migration guide
### ServerLoader to Platform API

All change related to [Platform API](/docs/platform-api.md) and how to migrate the Server on this new API, is described on a dedicated page.
All changes related to [Platform API](/docs/platform-api.md) and how to migrate the Server on this new API, are described on a dedicated page.
We encourage you to browse the entire page to migrate from v4/v5 to v6.

See our [Platform API](/docs/platform-api.md) documentation page.

### Inject service in the Server

With the `ServerLoader` API in v4/5, inject a provider can be done as follows:
With the `ServerLoader` API in v4/5, injecting a provider can be done as follows:

```typescript
import {ServerLoader, ServerSettings} from "@tsed/common";
Expand All @@ -158,7 +158,7 @@ export class Server extends ServerLoader {
```

Now Platform API, the Server class is considered as a @@Provider@@.
It means, you can use decorator like @@Constant@@ and @@Inject@@ to get any configuration, provider or service from the DI registry.
It means that you can use decorator like @@Constant@@ and @@Inject@@ to get any configuration, provider or service from the DI registry.

```typescript
import {Configuration} from "@tsed/common";
Expand All @@ -180,7 +180,7 @@ export class Server {

::: warning Breaking changes

- CustomGlobalErrorHandlerMiddleware have been removed.
- CustomGlobalErrorHandlerMiddleware has been removed.
- Default [Exception Filter](/docs/exceptions.html#exception-filter) returns a Json object to your consumer.

:::
Expand All @@ -196,12 +196,11 @@ class Server {
```

::: tip
To migrate your `CustomGlobalErrorHandlerMiddleware` to create an exception filter.
See our [Exception Filter](/docs/exceptions.html#exception-filter) documentation page to know what is the appropriate implementation
To migrate your `CustomGlobalErrorHandlerMiddleware` to create an exception filter, see our [Exception Filter](/docs/exceptions.html#exception-filter) documentation page to know what is the appropriate implementation
for your use case.
:::

Exception Filter use @@Catch@@ decorator to catch a specific instance error. For example, if you want to catch an Http exception
Exception Filter uses @@Catch@@ decorator to catch a specific instance error. For example, if you want to catch an Http exception
you have to provide the generic @@Exception@@ class to the decorator as follows:

<<< @/docs/docs/snippets/exceptions/http-exception-filter.ts
Expand All @@ -210,13 +209,13 @@ you have to provide the generic @@Exception@@ class to the decorator as follows:

The `@tsed/json-mapper` package is now responsible to map a plain object to a model and a model to a plain object.

It provides two functions @@serialize@@ and @@deserialize@@ to transform object depending on which operation you want to perform.
It provides two functions @@serialize@@ and @@deserialize@@ to transform objects depending on which operation you want to perform.
It uses all decorators from `@tsed/schema` package and TypeScript metadata to work.

::: warning Breaking changes

- The `@Converter` decorator have been removed in favor of @@JsonMapper@@ decorator.
- Classes like `ArrayConverter`, `SetConverter`, etc... replaced by his equivalents Types mapper: @@ArrayMapper@@, @@SetMapper@@, etc...
- The `@Converter` decorator has been removed in favor of @@JsonMapper@@ decorator.
- Classes like `ArrayConverter`, `SetConverter`, etc... are replaced by their equivalents Types mapper: @@ArrayMapper@@, @@SetMapper@@, etc...
- Type mapper classes are no longer injectable services.
- ConverterService is always available and can be injected to another provider, but now, ConverterService doesn't perform data validation. Validation is performed by [`@tsed/ajv`](/tutorials/ajv.md) package or any other validation library.
- `PropertyDeserialize` and `PropertySerialize` have been removed and replaced by @@OnDeserialize@@ and @@OnSerialize@@.
Expand Down Expand Up @@ -261,7 +260,7 @@ To help you migrate your custom mapper, here is a small table of equivalent poin

V5 | V6 | Description
---|---|---
Converter | JsonMapper | The decorator have the same behavior. You can use JsonMapper to override an existing mapper.
Converter | JsonMapper | The decorator has the same behavior. You can use JsonMapper to override an existing mapper.
deserializer/serializer | options.next(item) | Call the next function to deserialize/serialize object.
target/baseType | JsonMapperCtx.type/JsonMapperCtx.collectionType | The types of the object and the collection.

Expand Down Expand Up @@ -318,7 +317,7 @@ class MyController {

### ReturnsArray decorator

`ReturnsArray` is deprecated and will be remove in v7. You have to use @@Returns@@.
`ReturnsArray` is deprecated and will be removed in v7. You have to use @@Returns@@.

<Tabs class="-code">
<Tab label="Before">
Expand All @@ -329,7 +328,7 @@ import {ReturnsArray, Controller, Get} from "@tsed/common";
@Controller("/")
class MyController {
@Get("/")
@ReturnsArray(200, Model)
@ReturnsArray(200, TypeC)
get(){}
}
```
Expand All @@ -350,4 +349,4 @@ class MyController {
```

</Tab>
</Tabs>
</Tabs>
4 changes: 1 addition & 3 deletions docs/getting-started/start-with-cli.md
Expand Up @@ -38,8 +38,6 @@ meta:
---
# Create application with CLI

To get started, you can either scaffold the project with the Ts.ED CLI, or clone a starter project (see.

To scaffold the project with the CLI, run the following commands. This will create a new project directory,
and populate the directory with the initial core Ts.ED files and supporting modules, creating a conventional base structure for your project.
Creating a new project with the CLI is recommended for first-time users.
Expand All @@ -51,4 +49,4 @@ tsed init .

::: tip
See our [CLI website](https://cli.tsed.io) for more details.
:::
:::

0 comments on commit 4a2bf8a

Please sign in to comment.