Earlier quoted context omitted.
> 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 se…
Immediately 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.
Show HN: PJON v11.1 an independent, decentralized, open-source protocol
11–20 of 39 posts
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#12Earlier quoted context omitted.
> 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 se…
"... 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…
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).
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#13Earlier quoted context omitted.
Medium or media does not necessarily refer to an mp3 or a youtube video. See the original meaning of medium.
Of course it doesn't need to be audio nor video. It doesn't change the fact that you used a term that has more than one meaning without providing any context in which to interpret it. If somebody misreads it, then the problem is with your prose, not with the reader.
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#14Earlier quoted context omitted.
"... 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…
> "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 a…
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#15Earlier quoted context omitted.
Of course it doesn't need to be audio nor video. It doesn't change the fact that you used a term that has more than one meaning without providing any context in which to interpret it. If somebody misreads it, then the problem is with your prose, not with the reader.
Which word would you suggest to use instead of "multi-media" to refer to this characteristic?
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#16Earlier quoted context omitted.
Of course it doesn't need to be audio nor video. It doesn't change the fact that you used a term that has more than one meaning without providing any context in which to interpret it. If somebody misreads it, then the problem is with your prose, not with the reader.
Which word would you suggest to use instead of "multi-media" to refer to this characteristic?
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#17I definitely recommend it for most use cases, if you don't need a very high speed bus.
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#18Protocol cannot be open source . It can have a full specification published. A protocol does not have a source code, it's something that its implementation can have. Also, what the heck does it do? Neither README nor title says anything about that. The closest thing to such description is mentioning that it "supports multimedia", whatever that means.
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#19Protocol cannot be open source . It can have a full specification published. A protocol does not have a source code, it's something that its implementation can have. Also, what the heck does it do? Neither README nor title says anything about that. The closest thing to such description is mentioning that it "supports multimedia", whatever that means.
Ciao dozzie, I have omitted "implementation" from the title because I thought that was obvious enough. It seems not. The project proposes both an independent research in defining a specification, and also an open-source implementation based on that specification. If you want to know what it does, read the specifications or at least the first sentences of the README :) "PJON® (Padded Jittering Operative Network) is an…
Your README is needlessly abstract. It’s tantamount to saying you’ve invented a new wheel.
Well, wheels have all sorts of specifications, they're made of various materials, can have different weights, etc. They also have all sorts of use cases. From plastic wheels used in toys, rubber wheels used in cars, all the way to various wheels used for the construction of a rocket.
Although conceptually the wheel is an object that allows for easy rotation, you wouldn't use a plastic toy wheel for the construction, say of an automobile, would you? Also, not all wheels are used as rotary devices. Some can be used for just support.
Going back to your network protocol. What does this protocol allow one to do? What can it be used for? Be specific!
Re: Show HN: PJON v11.1 an independent, decentralized, open-source protocol
#20Earlier quoted context omitted.
Of course it doesn't need to be audio nor video. It doesn't change the fact that you used a term that has more than one meaning without providing any context in which to interpret it. If somebody misreads it, then the problem is with your prose, not with the reader.
Which word would you suggest to use instead of "multi-media" to refer to this characteristic?