Move content to avoid naked headings (timescale#2673)

* Move content to avoid naked headings

* Fix L2 heading

* Move to H2 headings, and add snippet

* remove duplicate H3 headings

* fix snippet description

Author: Loquacity

.vscode/collapsible.code-snippets

@@ -0,0 +1,21 @@
+{
+  // Place your docs-timescale workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and
+  // description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope
+  // is left empty or omitted, the snippet gets applied to all languages. The prefix is what is
+  // used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+  // $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders.
+  // Placeholders with the same ids are connected.
+  // Example:
+  "Collapsible": {
+    "scope": "markdown,html",
+    "prefix": [
+      "collapsible"
+    ],
+    "body": [
+      "<Collapsible heading=\"${1:heading}\"",
+      "defaultExpanded={false}",
+      "headingLevel={3}>"
+    ],
+    "description": "Inserts a collapsible heading"
+  }
+}

_partials/_cloud-connect.md

@@ -1,8 +1,3 @@
-When you have a service up and running, you can connect to it from your local
-system using the `psql` command-line utility. If you've used PostgreSQL before,
-you might already have `psql` installed. If not, check out the [installing
-psql][install-psql] section.
-
 <Procedure>
 
 ### Connecting to your service from the command prompt
@@ -33,5 +28,4 @@ psql][install-psql] section.
 
 </Procedure>
 
-[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/
 [tsc-portal]: https://console.cloud.timescale.com/

_partials/_cloud-create-service.md

@@ -1,6 +1,3 @@
-A service in Timescale is a cloud instance which contains your database.
-Each service contains a single database, named `tsdb`.
-
 <Procedure>
 
 ### Create a Timescale service

getting-started/services.md

@@ -32,36 +32,43 @@ connect to it from the command prompt on your local machine. You can then use
 
 In this section, you sign up for a Timescale account, create a service, and
 connect to it from your local machine using `psql`. Don't forget to download the
-cheatsheet when you create your service, it contains important information that
+cheat sheet when you create your service, it contains important information that
 you need later on.
 
 For more information, see
 [the services section][services-how-to].
 
-## Create your Timescale account
+<Collapsible heading="Create your Timescale account" defaultExpanded={false}>
 
-<Collapsible heading="Creating your Timescale account" defaultExpanded={false} headingLevel={3}>
+Before you can create your first service, you need to sign up for a free
+Timescale account.
 
 <Install />
 
 </Collapsible>
 
-## Create your first service
+<Collapsible heading="Create your first service" defaultExpanded={false}>
 
-Create a service to use for the tasks in this guide. You can use the default values.
-
-<Collapsible heading="Creating your first service" defaultExpanded={false} headingLevel={3}>
+Create a service to use for the tasks in this guide. A service in Timescale is a
+cloud instance which contains your database. You can use the default values when
+you create your service, which sets up a single database, named `tsdb`.
 
 <CreateService demoData={false} />
 
 </Collapsible>
 
 ## Connect to your service
 
+When you have a service up and running, you can connect to it from your local
+system using the `psql` command-line utility. If you've used PostgreSQL before,
+you might already have `psql` installed. If not, check out the
+[installing psql][install-psql] section.
+
 <Collapsible heading="Connecting to your service" headingLevel={3}>
 
 <Connect />
 
 </Collapsible>
 
 [services-how-to]: /use-timescale/:currentVersion:/services/
+[install-psql]: /use-timescale/:currentVersion:/integrations/query-admin/psql/