fix links, tweaks

Author: leemthompo

contribute-docs/index.md

@@ -25,13 +25,9 @@ To learn more about the new docs UX, read [how to use the documentation](/get-st
 
 |System|What it covers|Published at|Format|How to contribute
 |----|----|----|----|----|----|
-|Main docs|Guides, troubleshooting, release notes, etc.|[elastic.co/docs](https://www.elastic.co/docs)|Markdown|- [On the web](on-the-web.md) (quick edits) <br> - [Locally](locally.md) (complex changes) <br> - [Syntax guide](syntax/index.md)|
+|Main docs|Guides, troubleshooting, release notes, etc.|[elastic.co/docs](https://www.elastic.co/docs)|Markdown|- [On the web](on-the-web.md) (quick edits) <br> - [Locally](locally.md) (complex changes) <br> - [Syntax guide](syntax-quick-reference.md)|
 |API references|Elastic REST APIs|[elastic.co/docs/api](https://www.elastic.co/docs/api/)|[OpenAPI](https://swagger.io/specification/)|[Contribute to API docs](api-docs/index.md)|
 
-:::{note}
-If you need to update documentation in both the MarkDown and Asciidoc systems, you'll need two separate PRs. Refer to [Updating docs in both systems](asciidoc-guide.md#updating-docs-in-both-systems).
-:::
-
 ## Report issues or request features
 
 |Issue type|Where to report|
@@ -44,3 +40,7 @@ If you need to update documentation in both the MarkDown and Asciidoc systems, y
 |System|What it covers|Published at|Format/toolchain|How to contribute
 |----|----|----|----|----|----|
 |`elastic.co/guide` (Asciidoc)|Elastic docs & API references for 8.x and earlier|[elastic.co/guide](https://www.elastic.co/guide/index.html)|Asciidoc|[Contribute to the Asciidoc docs](./asciidoc-guide.md)|
+
+:::{note}
+If you need to update documentation in both the MarkDown and Asciidoc systems, you'll need two separate PRs. Refer to [Updating docs in both systems](asciidoc-guide.md#updating-docs-in-both-systems).
+:::

contribute-docs/locally.md

@@ -104,7 +104,7 @@ git clone https://github.com/elastic/docs-content.git
 
 ## Write the docs [#write-docs]
 
-We write docs in Markdown. Refer to our [syntax](syntax/index.md) guide for the flavor of Markdown we support and all of our custom directives that enable you to add a little extra pizzazz to your docs.
+We write docs in Markdown. Refer to our [syntax quick reference](syntax-quick-reference.md) for the flavor of Markdown we support and all of our custom directives that enable you to add a little extra pizzazz to your docs.
 
 This documentation is **cumulative**. This means that a new set of docs is not published for every minor release. Instead, each page stays valid over time and incorporates version-specific changes directly within the content. [Learn how to write cumulative documentation](how-to/cumulative-docs/index.md).
 

contribute-docs/syntax-quick-reference.md

@@ -6,12 +6,11 @@ navigation_title: "Syntax quick reference"
 
 Elastic documentation uses a custom implementation of [MyST Markdown](https://mystmd.org/) with extended syntax for directives, metadata, and tagging.
 
-:::{tip}
 For the full syntax reference, go to [elastic.github.io/docs-builder/syntax/](https://elastic.github.io/docs-builder/syntax/).
-:::
+
 
 :::{tip}
-Contributing to `elastic.co/guide` (Asciidoc)? Refer to [Contribute to `elastic.co/guide` (Asciidoc)](asciidoc-guide.md).
+Contributing to `elastic.co/guide`? Refer to [Contribute to `elastic.co/guide` (Asciidoc)](asciidoc-guide.md).
 :::
 
 This page offers quick guidance on commonly used syntax elements. Elements are in alphabetical order.