Deprecate graphql alias for gql tag function

Because importing the same thing from two different import points will
increase the final bundle size. If you want a different name for the tag
function, then use `as` syntax, such as:

```ts
import {gql as graphql} from 'apollo-angular';
```

Author: PowerKiKi

.changeset/nine-pets-wait.md

@@ -0,0 +1,13 @@
+---
+'apollo-angular': patch
+---
+
+Deprecate `graphql` alias for `gql` tag function
+
+Because importing the same thing from two different import points will
+increase the final bundle size. If you want a different name for the tag
+function, then use `as` syntax, such as:
+
+```ts
+import {gql as graphql} from 'apollo-angular';
+```

packages/apollo-angular/src/gql.ts

@@ -6,4 +6,8 @@ const typedGQLTag: <Result, Variables>(
 ) => TypedDocumentNode<Result, Variables> = gqlTag;
 
 export const gql = typedGQLTag;
+
+/**
+ * @deprecated Instead, use `import {gql as graphql} from 'apollo-angular';`. Because different exports for the same thing will increase the final bundle size.
+ */
 export const graphql = typedGQLTag;

website/src/pages/docs/get-started.mdx

@@ -99,9 +99,9 @@ Once all is hooked up, you're ready to start requesting data with `Apollo` servi
 The `Apollo` is an Angular service exported from `apollo-angular` to share GraphQL data with your
 UI.
 
-First, pass your GraphQL query wrapped in the `gql` or `graphql` function (from `apollo-angular`) to
-the `query` property in the `Apollo.watchQuery` method, in your component. The `Apollo` service is a
-regular angular service available to you, and your data is streamed through Observables.
+First, pass your GraphQL query wrapped in the `gql` function (from `apollo-angular`) to the `query`
+property in the `Apollo.watchQuery` method, in your component. The `Apollo` service is a regular
+angular service available to you, and your data is streamed through Observables.
 
 The `watchQuery` method returns a `QueryRef` object which has the `valueChanges` property that is an
 `Observable`.