There are a few places where some diagrams might be helpful. For example, we could illustrate our specific flow of HTTP messages, and possibly show the relationship between different bits of LabThings a bit more visually too. I suspect Mermaid would do a nice job of this, and I believe it integrates into Sphinx.
It would be nice to add some diagrams, particularly of the HTTP communication. While we do our best to follow the WoT standard, said standard allows a fair bit of wiggle room in the "protocol binding" so it would be useful to be clear about how we are currently implementing it.
There are a few places where some diagrams might be helpful. For example, we could illustrate our specific flow of HTTP messages, and possibly show the relationship between different bits of LabThings a bit more visually too. I suspect Mermaid would do a nice job of this, and I believe it integrates into Sphinx.
It would be nice to add some diagrams, particularly of the HTTP communication. While we do our best to follow the WoT standard, said standard allows a fair bit of wiggle room in the "protocol binding" so it would be useful to be clear about how we are currently implementing it.