Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

remove any/all code language hints for now #715

Closed
wants to merge 2 commits into from

Conversation

dovholuknf
Copy link
Member

@dovholuknf dovholuknf commented Sep 25, 2023

removes any language hints for now until the formatter can be consistent

did a find/replace for:

```.+

@dovholuknf dovholuknf requested review from a team as code owners September 25, 2023 16:22
@vercel
Copy link

vercel bot commented Sep 25, 2023

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
ziti-doc ✅ Ready (Inspect) Visit Preview Sep 29, 2023 0:58am

qrkourier
qrkourier previously approved these changes Sep 28, 2023
Copy link
Member

@qrkourier qrkourier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I hope we find a better highlighter because colors are pretty.

@qrkourier
Copy link
Member

The Markdown linter suggests

```text
not highlighted
```

Instead of bare fences.

https://github.com/DavidAnson/markdownlint/blob/v0.31.1/doc/md040.md based on https://cirosantilli.com/markdown-style-guide/#option-code-fenced

Copy link
Member

@qrkourier qrkourier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

need to keep the mermaid fences or diagrams won't work

bash highlighter seems to be the problem. Let's keep the others, especially yaml, json, which appear to render flawlessly and are where the majority of the benefits of highlighting lie, because they're structured data.

@@ -4,7 +4,7 @@ title: Workload Tunneling

This guide will help you discover the best strategy and tool for connecting a Kubernetes workload. This overview page links to child pages for each strategy and tool, and a summary of each is provided in the sections below. Click on the chart's outcomes to see the corresponding documentation.

```mermaid
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These have to be mermaid or the diagrams will break

@@ -10,7 +10,7 @@ This [daemonset manifest](https://get.openziti.io/tun/docker/ziti-tun-daemonset.

The default nameserver address is `100.64.0.2`, but containers don't automatically use it until you configure cluster DNS. CoreDNS doesn't currently have a fallthrough mechanism, but you can use conventional names for your OpenZiti services' like `*.ziti`, and configure CoreDNS to forward queries that match that namespace to the OpenZiti nameserver.

```yaml
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are the yaml highlights actually creating a problem, or just bash? The yaml and json look right to me.

@@ -1,6 +1,6 @@
# Endpoint Initialization

```mermaid
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needed

@@ -1,6 +1,6 @@
# Endpoint Registration

```mermaid
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needed

@@ -1,6 +1,6 @@
# Service Dial

```mermaid
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needed

@@ -15,7 +15,7 @@ or the Ziti [Edge Management API](docs/reference/developer/api/02-edge-managemen
Below is diagram showing initial authentication for some client. The same model is used between the [Edge Client API](docs/reference/developer/api/01-edge-client-reference.mdx)
and [Edge Management API](docs/reference/developer/api/02-edge-management-reference.mdx).

```mermaid
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needed

@@ -10,7 +10,7 @@ client in the form of [Posture Checks](posture-checks.md).
Authorization to connect to an Edge Router affects the Edge Router that are discoverable by a client. This will be
reflected when listing a Edge Router directly and receiving a list of them during Session creation.

```mermaid
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needed

@@ -13,7 +13,7 @@ Environmental state is saved as Posture Data - a set of values describing enviro
to the controller via Posture Response sent from the client. Posture Responses are constructed from Posture Queries
which are reported to the client per service from the controller.

```mermaid
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needed

@@ -209,7 +209,7 @@ ziti@724087d30014:/persistent$ ziti edge list identities
╰────────────┴───────────────────────┴────────┴────────────╯
results: 1-6 of 6

````
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

legit

cd "${ZITI_HOME}/ziti-console"
npm install
````
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

legit

@dovholuknf dovholuknf closed this Sep 29, 2023
@dovholuknf dovholuknf deleted the remove-code-format-hints branch September 29, 2023 14:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants