search

trilitech / tezos-developer-docs

Tezos Developer Docs (beta)
https://docs.tezos.com
MIT License
7 stars 13 forks source link

Update tezos-different.md #347

Closed NicNomadic closed 9 months ago

NicNomadic commented 9 months ago

Here are some changes resulting from a review of the page "What makes Tezos different?"

vercel[bot] commented 9 months ago

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

Name Status Preview Updated (UTC)
docs-staging ✅ Ready (Inspect) Visit Preview Mar 6, 2024 2:24pm
NicNomadic commented 9 months ago

The page https://opentezos.com/formal-verification doesn't seem to work correctly, should we change this link?

NicNomadic commented 9 months ago

The title section "Stakeholders participate in governance" doesn't convey the key idea, because this phrase is true in any blockchain, if by "stakeholders" you understand influential core developers, for instance. What would be more specific for Tezos is something like "Everyone can participate in governance" or "Any user can participate in governance".

NicNomadic commented 9 months ago

(I cannot add a comment on the unmodified lines so I put here more comments)

I would add the word "regularly" in the phrase "This feature allows Tezos to [regularly] adapt to new technologies", to express the fact that Tezos not only "can upgrade itself", but really does it on a regular basis.

timothymcmackin commented 9 months ago

The page https://opentezos.com/formal-verification doesn't seem to work correctly, should we change this link?

That's the correct link but there seems to be a problem with the page. Sometimes I see a blank page but when I switch to mobile layout by changing the browser dimensions it reappears. Can't reproduce it locally. I sent a message to Mathias about it.

timothymcmackin commented 9 months ago

(I cannot add a comment on the unmodified lines so I put here more comments)

I would add the word "regularly" in the phrase "This feature allows Tezos to [regularly] adapt to new technologies", to express the fact that Tezos not only "can upgrade itself", but really does it on a regular basis.

Sure, that makes sense. Maybe it could be "regularly and rapidly" to illustrate that the update process happens relatively quickly.

NicNomadic commented 9 months ago

The page https://opentezos.com/formal-verification doesn't seem to work correctly, should we change this link?

That's the correct link but there seems to be a problem with the page. Sometimes I see a blank page but when I switch to mobile layout by changing the browser dimensions it reappears. Can't reproduce it locally. I sent a message to Mathias about it.

Solved by Mathias today

NicNomadic commented 9 months ago

(I cannot add a comment on the unmodified lines so I put here more comments) I would add the word "regularly" in the phrase "This feature allows Tezos to [regularly] adapt to new technologies", to express the fact that Tezos not only "can upgrade itself", but really does it on a regular basis.

Sure, that makes sense. Maybe it could be "regularly and rapidly" to illustrate that the update process happens relatively quickly.

Done (didn't add "rapidly" because there was already a "rapidly" in that phrase)

NicNomadic commented 9 months ago

Are we ready for merging now?

timothymcmackin commented 9 months ago

Are we ready for merging now?

Yes, thanks for the updates. I'll merge now.