3 ms·
> Ciao dozzie, I have omitted "implementation" from the title because I thought that was obvious enough. It seems not. Keep the proper terminology. If you omi
by dozzie 8y ago
> Ciao dozzie, I have omitted "implementation" from the title because I thought that was obvious enough. It seems not.
Keep the proper terminology. If you omit words left and right, it becomes
incomprehensible garbage.
> If you want to know what it does, read the specifications
The whole point of README is to say what it does so I don't need to read
specification that will be useless to me.
> or at least the first sentences of the README :)
I read it. The wall of words you cited says nothing about what it does and
what purpose it serves.
- gioscarab 8y ago"... is an Arduino compatible, multi-master, multi-media network protocol. It proposes a Standard, it is designed as a framework and implements a totally software emulated network protocol stack that can be easily cross-compiled on many architectures like ATtiny, ATmega, ESP8266, ESP32, STM32, Teensy, Raspberry Pi, Linux. It is a valid tool to quickly and comprehensibly build a network of devices". If this is a wall of words that says nothing about what the project is for, we are not from the same universe. And also, I don't think an omitted word in a title that must be short will make all the project an incomprehensible garbage, considering the amount of time and effort has been invested in docs and specs.
- dozzie 8y ago> "It is a valid tool to quickly and comprehensibly build a network of devices. Visit wiki and documentation to know more about the PJON Standard". If this is a wall of words that says nothing about what the project is for, we are not from the same universe. Nope, this still does not say what it does and what to use it for. "Network" is a term used on several different levels of abstraction. > [...] considering the amount of time and effort has been invested in docs and specs. Well, you should probably invest even more effort in your README. What I thought is that it was a mind dump, given it carefully omits a description where would I want to use it and what for (you only use ambiguous terms with no concrete context, or at least ambiguous to somebody who does not wire a bucket of Arduinos pin-to-pin to each other).
- gioscarab 8y agoI am sorry dozzie, did not want to be aggressive or dry, just I don't get what you mean. PJON works pretty much everywhere. The use you can do of PJON depends on your needs and the architecture that will execute it. In some cases PJON can be useful to "wire a bucket of Arduinos pin-to-pin to each other" but can also be used to create a virtual network computers running winx86, macosx or linux operating over the internet infrastructure. I think you would need some time to go through the available documentation and spec to have a clearer view of its features and limits.
- detaro 8y agoImmediately after the blurb is a section with key properties/selling points, which among other things explains the "multi-media" part. The wording of the description and readme isn't perfect (I suspect the author is not a native english speaker?), but it does contain the details necessary.
- gioscarab 8y agoCiao Detaro, thank you for your comment. Could you please point out the incosistencies you have found? I would be happy to fix that, yes I am not a native english speaker sadly :(