From 9a1c27db41025eb9a9c780455df6e64b32f7c4ee Mon Sep 17 00:00:00 2001 From: "tina-cloud-app[bot]" <58178390+tina-cloud-app[bot]@users.noreply.github.com> Date: Tue, 24 Sep 2024 03:12:52 +0000 Subject: [PATCH 1/2] TinaCMS content update Co-authored-by: Brook J --- content/docs/introduction/faq.mdx | 40 ++++++++++++++++++------------- 1 file changed, 23 insertions(+), 17 deletions(-) diff --git a/content/docs/introduction/faq.mdx b/content/docs/introduction/faq.mdx index 142949d35..2ad38223c 100644 --- a/content/docs/introduction/faq.mdx +++ b/content/docs/introduction/faq.mdx @@ -1,6 +1,8 @@ --- title: FAQ last_edited: '2024-07-31T14:00:00.000Z' +next: '' +previous: '' --- ## What is TinaCloud? @@ -11,19 +13,23 @@ For more information, see [TinaCloud Overview](/docs/tina-cloud/overview). ## Where can I get help or share an idea for TinaCMS or TinaCloud? -- Check out our communities at [https://tina.io/community/](https://tina.io/community/) +* Check out our communities at [https://tina.io/community/](https://tina.io/community/) + +## What versions of Node are supported? + +We attempt to support the latest LTS version of Node. We currently support v18, v20, and v22 of Node. ## What is Tina's tech stack? ### TinaCloud -- Content querying + indexing - **Node** -- Cloud provider - **AWS** -- Identity management - **Go** +* Content querying + indexing - **Node** +* Cloud provider - **AWS** +* Identity management - **Go** ### TinaCMS -- CMS - **React 18** +* CMS - **React 18** ## What features are unavailable in self-hosted Tina compared to TinaCloud? @@ -114,9 +120,9 @@ When a user logs in from your site, we will pop open a login window. When login The most common reasons for this issue are: -- The Site URL is not properly set for the Tina project. The main window's base URL will need to match the Tina project's Site URL setup in the TinaCloud Dashboard. -- The Client ID setup in your site's environment variables does not match the Client ID in your project's settings on the TinaCloud dashboard. -- The user attempting to login to TinaCloud does not have access to edit this site. Ensure that this user is authorized on the TinaCloud dashboard. +* The Site URL is not properly set for the Tina project. The main window's base URL will need to match the Tina project's Site URL setup in the TinaCloud Dashboard. +* The Client ID setup in your site's environment variables does not match the Client ID in your project's settings on the TinaCloud dashboard. +* The user attempting to login to TinaCloud does not have access to edit this site. Ensure that this user is authorized on the TinaCloud dashboard. > Make sure to include `https` in the Site URL eg: [https://forestry.io](https://forestry.io) or if you are testing locally, it might be something like `http://localhost:3000` @@ -138,12 +144,12 @@ When you run `tinacms dev` locally, Tina will generate a development admin/index TinaCloud's GraphQL API returns this error when it cannot find a file in your GitHub repository. This may occur under the following circumstances: -- The `tina` folder (and `__generated__` subfolder) is not in your GitHub repository remote. - - If the folder is in your local repository, but not in your remote, make sure there isn't a `.gitignore` file excluding it. -- Tina is configured with a branch that doesn't exist or a branch that doesn't contain the `tina` folder. - - The referenced branch should be created and should contain the `tina` folder. -- The apiURL prop is misconfigured on the TinaCMS component. - - Check the apiURL and make sure it looks like `https://content.tinajs.io/content/{tina_client_id}/github/{branch}` where `{tina_client_id}` matches the Client ID on the Project in TinaCloud and `{branch}` is a valid branch. +* The `tina` folder (and `__generated__` subfolder) is not in your GitHub repository remote. + * If the folder is in your local repository, but not in your remote, make sure there isn't a `.gitignore` file excluding it. +* Tina is configured with a branch that doesn't exist or a branch that doesn't contain the `tina` folder. + * The referenced branch should be created and should contain the `tina` folder. +* The apiURL prop is misconfigured on the TinaCMS component. + * Check the apiURL and make sure it looks like `https://content.tinajs.io/content/{tina_client_id}/github/{branch}` where `{tina_client_id}` matches the Client ID on the Project in TinaCloud and `{branch}` is a valid branch. ### How do I resolve `The local GraphQL schema doesn't match the remote GraphQL schema.` errors? @@ -181,9 +187,9 @@ Generally this happens when there is branch protection on your main branch and T To fix this issue, either: -- Upgrade from legacy branch protection to branch rulesets - [https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository)\ +* Upgrade from legacy branch protection to branch rulesets - [https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository)\ Ensure that the TinaCloud app is allowed to bypass the rule requiring branch protection -- Enable [Editorial Workflow](/editorial-workflow) to create PRs on the branch +* Enable [Editorial Workflow](/editorial-workflow) to create PRs on the branch ### How do I resolve `Invalid or undefined branch` errors? @@ -199,7 +205,7 @@ Everything in the `tina` directory (except the `__generated__` folder) needs to ### How do I resolve `API URL is misformatted` errors? -The ContentAPI URL isn't formatted correctly. See [here](/docs/tina-cloud/overview/#enabling-tina-cloud-in-tinacms) for information on how the URL _should_ be formatted. +The ContentAPI URL isn't formatted correctly. See [here](/docs/tina-cloud/overview/#enabling-tina-cloud-in-tinacms) for information on how the URL *should* be formatted. ## Trying to access local GraphQL server when it's not running or in prod. From 4c4606c7c85fc5b9a8571600ded5f1e450aaac0d Mon Sep 17 00:00:00 2001 From: brookjeynes-ssw Date: Tue, 24 Sep 2024 14:01:39 +1000 Subject: [PATCH 2/2] add blockquote to setup overview page --- components/layout/setup-overview.tsx | 4 ++++ content/docs/introduction/faq.mdx | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/components/layout/setup-overview.tsx b/components/layout/setup-overview.tsx index dfe989ee1..1a136e882 100644 --- a/components/layout/setup-overview.tsx +++ b/components/layout/setup-overview.tsx @@ -71,6 +71,10 @@ const OverviewTemplate = (props) => {

Getting Started With Tina

+
+ TinaCMS supports the latest LTS version of Node. We currently + support v18, v20, and v22 of Node. +

Tina is a Git-backed headless content management system that enables developers and content creators to collaborate seamlessly. diff --git a/content/docs/introduction/faq.mdx b/content/docs/introduction/faq.mdx index 2ad38223c..257bcb45f 100644 --- a/content/docs/introduction/faq.mdx +++ b/content/docs/introduction/faq.mdx @@ -17,7 +17,7 @@ For more information, see [TinaCloud Overview](/docs/tina-cloud/overview). ## What versions of Node are supported? -We attempt to support the latest LTS version of Node. We currently support v18, v20, and v22 of Node. +TinaCMS supports the latest LTS version of Node. We currently support v18, v20, and v22 of Node. ## What is Tina's tech stack?