Overview
Exactly as title suggests. The website (particularly landing page) reads like an absolute nothing-burger. It fills the most public facing page with the least useful information.
Choice of Vocabulary
Some of the choice of vocabs is just baffling:
"Real backends, real silicon"
as opposed to... fake backend and fake silicon? Is having real functioning backends somehow worthy of celebrating nowadays?
"Unknown opcodes, statuses and event states stay raw integers until validated, so decoding untrusted bytes never constructs an invalid Rust enum."
"A successful submit yields an event, and an indeterminate failure must yield one too — the operation's resources are still owned by the device."
why are these relevant at all? I don't even know how to make sense of these sentences in context to the repo... It could have been literally anything else and still provide more information.
"Portability tiers are checked in CI on bare-metal targets rather than asserted in a README, so a no_std crate stays no_std."
this is just a legendarily useless sentence.
I am sure I will find way more instances of these but my own sanity requires me to stop.
@Colin-Hayes
@aravishankar-mp
@julian-avar
Please proof read the other critical sections, I'm not worried about docs since that's generated from docstrings, I am worried about the pages that are supposed to be informative, like the landing page.
Overview
Exactly as title suggests. The website (particularly landing page) reads like an absolute nothing-burger. It fills the most public facing page with the least useful information.
Choice of Vocabulary
Some of the choice of vocabs is just baffling:
as opposed to... fake backend and fake silicon? Is having real functioning backends somehow worthy of celebrating nowadays?
why are these relevant at all? I don't even know how to make sense of these sentences in context to the repo... It could have been literally anything else and still provide more information.
this is just a legendarily useless sentence.
I am sure I will find way more instances of these but my own sanity requires me to stop.
@Colin-Hayes
@aravishankar-mp
@julian-avar
Please proof read the other critical sections, I'm not worried about docs since that's generated from docstrings, I am worried about the pages that are supposed to be informative, like the landing page.