--
You received this message because you are subscribed to the Google Groups "d3-js" group.
To unsubscribe from this group and stop receiving emails from it, send an email to d3-js+un...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to a topic in the Google Groups "d3-js" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/d3-js/zHcH-FIEroE/unsubscribe.
To unsubscribe from this group and all its topics, send an email to d3-js+un...@googlegroups.com.
--
--
--
--
--
--
You received this message because you are subscribed to the Google Groups "d3-js" group.
To unsubscribe from this group and stop receiving emails from it, send an email to d3-js+un...@googlegroups.com.
--
You received this message because you are subscribed to the Google Groups "d3-js" group.
To unsubscribe from this group and stop receiving emails from it, send an email to d3-js+un...@googlegroups.com.
Shyamal,
For someone who likes to say talk is cheap you've sure done a lot of it.
Anyway, welcome to the d3 community, you'll find it a very engaging and thoughtful place with many helpful people. You haven't made the best first impression but we all know how frustrating it can be to get stuck on a bug, so I'm going to assume you lashed out in the heat of the moment.
In addition to the already mentioned links there is a REPL like environment:
http://blockbuilder.org
and you can search over
12,000 examples at
http://blockbuilder.org/search
One of the things that makes this community so fun to be a part of is the attitudes of the people involved, this thread is evidence of their generosity in the face of blatant trolling. If you don't want to be a part of it you are welcome to leave. If you keep trolling you wont be welcome to stay.
The biggest danger I see to open source innovation is entitled users. Open source is fun; I love it. I share ideas with the world and people engage with them. I invest effort and people benefit from that. It’s exponential value creation. That’s what drives me. And I don’t think I’m unique.
But some — and even just a few — bad actors can easily ruin it. Open Source authors don’t work for you. They owe you nothing, yet give you so much.
If you show up in a repo rudely demanding something, if you trash-talk a project, or worst of all if you personally attack someone — for whatever reason — you’ve just cost the world something of value. Maybe it’s 5 minutes that could have been spent fixing an issue. Or maybe it’s much more.
We all need to defend against this culture of entitlement. Protect our vibrant community, which is sourced all over the world. Thank people. Let them know their work is valued. Make an effort to contribute and help.
If everybody engaged with a mentality to add more value than they receive from a project, we would see much less stress and burnout among authors.
On a larger scale, there’s another discussion to be had about how to make major projects that start personal but become commercially valuable en masse sustainable. But until we crack that, and even after, every single person counts.
Every interaction either adds to, or subtracts from, the value of the ecosystem as a whole.
Where does it say GPLv3 or BSD or MIT license? This is not free software as coined by Richard Stallman.Copyright (c) 2010-2016, Michael BostockAll rights reserved.Redistribution and use in source and binary forms, with or withoutmodification, are permitted provided that the following conditions are met:* Redistributions of source code must retain the above copyright notice, thislist of conditions and the following disclaimer.* Redistributions in binary form must reproduce the above copyright notice,this list of conditions and the following disclaimer in the documentationand/or other materials provided with the distribution.* The name Michael Bostock may not be used to endorse or promote productsderived from this software without specific prior written permission.THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THEIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MICHAEL BOSTOCK BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
there is no charge to you.
That is because every one who works on it has done so for free, without charge.
that is what open source means: it means free software that gets you a bit closer to where you want to go, but you have to accept that there may be issues with the software and with it's documentation at the moment you seem to be the only person complaining about the documentation for D3, so why don't you document it.
Shyamal,
For someone who likes to say talk is cheap you've sure done a lot of it.
Anyway, welcome to the d3 community, you'll find it a very engaging and thoughtful place with many helpful people. You haven't made the best first impression but we all know how frustrating it can be to get stuck on a bug, so I'm going to assume you lashed out in the heat of the moment.
In addition to the already mentioned links there is a REPL like environment:
http://blockbuilder.organd you can search over
12,000 examples at
http://blockbuilder.org/searchOne of the things that makes this community so fun to be a part of is the attitudes of the people involved, this thread is evidence of their generosity in the face of blatant trolling. If you don't want to be a part of it you are welcome to leave. If you keep trolling you wont be welcome to stay.
Shyamal,I use vim (spacemacs), and don't really want a different editor unless it does something genuinely new.
You might find Bret Victor's talk "Media for Thinking the Unthinkable" interesting. See Demo 6 for the relevant UI. I want to draw a picture and then have it magically work with my data. It is possible, the UI has been designed, why hasn't someone made $1B releasing it?
Shyamal,I am a silent observer of this group but today I have to write this. D3 is one data viz solution which is truly meant for developers. I haven't seen these many coding examples for any data viz solution before. Forget about people like us who dedicatedly spend their time on data viz, even novice can go on https://github.com/mbostock/d3/wiki/Gallery and find their solution for whatsoever data set they have.We are a community and we help each other without complaining.
I have not seen a thread like this before. If you choose to be part of this community, then stop complaining.
Given that you are such a big fan of documentation, why don't you spend your effort on documenting it rather than initiating this rude thread.
Hello Shyamal,I'm curious, which function(s) in did you find inadequately documented such that you had to dive into the source? If we can pinpoint the source of frustration, perhaps the docs for that specific thing can be ironed out.
The D3 documentation is the gold standard of library documentation in my mind.
I aspire to write documentation that is so clear, with such a consistent format, with clear indications of which arguments are optional (using brackets), with each item linkable, with explanations of the behavior under various conditions, with explanations of all return values, and with a well organized index page. I and many others have huge respect for this work.
Also, I'd like to mention, there is a great tool http://bl.ocksplorer.org/ that lets you search D3 examples based on which API calls are used. Let's say, for example, usage of linear scales was not clear from the documentation, you could search for examples that use linear scales. Bl.ocksplorer has auto-complete as well (image attached), which gets at some of the ideas you had about IDE development.Lastly, I'd like to voice my personal opinion that this list is no place for ad hominem insults like "stealth developers", "snooty developers", and "coding priest".
Best regards,Curran
--
You received this message because you are subscribed to the Google Groups "d3-js" group.
To unsubscribe from this group and stop receiving emails from it, send an email to d3-js+un...@googlegroups.com.
--
taken from sustainable open source. we thank you mike for all you do for us! we'd all be happy to help you shyamal, just us a chance.The biggest danger I see to open source innovation is entitled users. Open source is fun; I love it. I share ideas with the world and people engage with them. I invest effort and people benefit from that. It’s exponential value creation. That’s what drives me. And I don’t think I’m unique.
But some — and even just a few — bad actors can easily ruin it. Open Source authors don’t work for you. They owe you nothing, yet give you so much.
If you show up in a repo rudely demanding something, if you trash-talk a project, or worst of all if you personally attack someone — for whatever reason — you’ve just cost the world something of value. Maybe it’s 5 minutes that could have been spent fixing an issue. Or maybe it’s much more.
We all need to defend against this culture of entitlement. Protect our vibrant community, which is sourced all over the world. Thank people. Let them know their work is valued. Make an effort to contribute and help.
If everybody engaged with a mentality to add more value than they receive from a project, we would see much less stress and burnout among authors.
On a larger scale, there’s another discussion to be had about how to make major projects that start personal but become commercially valuable en masse sustainable. But until we crack that, and even after, every single person counts.
Every interaction either adds to, or subtracts from, the value of the ecosystem as a whole.
On Thursday, April 21, 2016 at 1:05:44 PM UTC-4, Curran wrote:Hello Shyamal,I'm curious, which function(s) in did you find inadequately documented such that you had to dive into the source? If we can pinpoint the source of frustration, perhaps the docs for that specific thing can be ironed out.The D3 documentation is the gold standard of library documentation in my mind. I aspire to write documentation that is so clear, with such a consistent format, with clear indications of which arguments are optional (using brackets), with each item linkable, with explanations of the behavior under various conditions, with explanations of all return values, and with a well organized index page. I and many others have huge respect for this work.Also, I'd like to mention, there is a great tool http://bl.ocksplorer.org/ that lets you search D3 examples based on which API calls are used. Let's say, for example, usage of linear scales was not clear from the documentation, you could search for examples that use linear scales. Bl.ocksplorer has auto-complete as well (image attached), which gets at some of the ideas you had about IDE development.Lastly, I'd like to voice my personal opinion that this list is no place for ad hominem insults like "stealth developers", "snooty developers", and "coding priest".Best regards,Curran
--