Update connectivity.md

[npentrel]

No description provided.

[viambot]

Overall readability score: 55.73 (🔴 -0.04)

File	Readability
sessions.md	53.03 (🟢 +0.05)
connectivity.md	46.06 (🔴 -4.67)
run.md	42.25 (🔴 -7.05)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
sessions.md	53.03	42	11.99	13.7	11.89	7.27
	🟢 +0.05	🟢 +0.3	🟢 +0.01	🟢 +0.1	🔴 -0.05	🔴 -0.03
connectivity.md	46.06	35.41	13.98	15.5	11.26	7.5
	🔴 -4.67	🔴 -5.28	🔴 -1.32	🔴 -2.1	🟢 +0.23	🟢 +0.37
run.md	42.25	42.75	15.06	17.4	11.26	7.63
	🔴 -7.05	🟢 +1.56	🔴 -3.08	🔴 -1.8	🟢 +0.87	🔴 -0.2

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	55.73	46.84	10.59	13.1	11.85	7.72
	🔴 -0.04	🔴 -0.01	🔴 -0.01	🔴 -0.01	🟢 +0	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[npentrel]

@dannenberg - could you read through the changes to the connectivity page and ensure that that answers all remaining questions

and @cheukt - apologies - could you confirm this is all still correct?

@sguequierre - please read over it for correctness as well

[cheukt]

looks accurate

[dannenberg]

the only question i'm not seeing an answer to here is "can a client establish a connection to the viam-server over LAN without an internet connection?" and possibly implicit in that "if we were connected via a route using the internet, but that gets severed, will the client be able to reconnect over their shared LAN?" (could this happen. that is, would webrtc ever choose a route out of LAN when LAN is available?)

otherwise this is looking great. thank you for your efforts

[sguequierre]

(opt) For clarity I would suggest moving this down and specifying "different LAN or WAN" or "through the cloud" vs just "through the internet", but idk I think this is technically correct anyways?

[npentrel]

@cheukt please confirm the answers:

1. "can a client establish a connection to the viam-server over LAN without an internet connection?"

I assume yes and you'd do that the same way as https://docs-test.viam.dev/d4b541ef8633aa931fd9723fc58b82f3d0fd8915/public/program/run/#run-code-on-robot ?

2. "if we were connected via a route using the internet, but that gets severed, will the client be able to reconnect over their shared LAN?" (could this happen. that is, would webrtc ever choose a route out of LAN when LAN is available?)

I believe it would automatially figure out there's a better connection and use LAN, so no reconnection needed?

[cheukt]

for 1, yes, and at this point you should be able to connect just using the code sample for all the supported SDKs
for 2, if the client was connected over internet, it will disconnect and reconnect again, but that should get handled automatically. it should favor a connection over LAN though, at which point connection will not get dropped

[dannenberg]

for clarity, the steps naomi linked in #1 are no longer necessary. correct cheuk?

[cheukt]

yes, it should definitely work with go and python sdk. possibly not for the typescript sdk

[npentrel]

@dannenberg and @cheukt could you please review the changes in the last commit ("Address feedback") to ensure the changes based on your comments are factually accurate and cover what we want to cover?

We will need to understand the Typescript limitations as well but we can do that separately.

[viambot]

You can view a rendered version of the docs from this PR at https://docs-test.viam.dev/39fc5ee56de4407039031aa93adcaa790735dd02/public