4 ms·

Another JS optional charting library I've been keeping my eye on: Pancake, from the creator of Svelte. Experimental, pre-release: https://pancake-charts.surge.

Another JS optional charting library I've been keeping my eye on: Pancake, from the creator of Svelte. Experimental, pre-release: https://pancake-charts.surge.sh https://pancake-charts.surge.sh

reaperducer 6y ago
Documentation is TODO Why do people do this? If you're going to bother to make a project public with a big page demonstrating what it can do, why would you skip the part where you tell people how? It really comes off as amateur. I have other things to do with my time than reverse-engineer your code.
- kjhughes 6y ago
  It really comes off as amateur. I have other things to do with my time than reverse-engineer your code. Perhaps the authors, who were generous enough to share the results of their work, have better things to do than to handhold you through review of their work.
  - tomrod 6y ago
    Then their work probably isn't worthwhile to adopt, given the plethora of alternatives. If their time is limited so that no documentation is produced, dropping bugfixes seem to be next (IME).
    - scrollaway 6y ago
      Unless those authors are specifically trying to get you to adopt their work for whatever reason (sales, good will, etc) and in which case they'd likely have documented it, you are not doing them a favor by adopting their work. You're just benefiting from what they've released. It's like going to a free buffet and complaining there's no napkins. Sure, you can complain, and you're technically correct that there should be napkins. But it's still in bad taste.
      - tomrod 6y ago
        If there is no desire to have adoption, then there is no compelling reason to host publically outside of convenience. We fundamentally agree, I think, with the difference of our thought being that we have a "show hn" post (I assume from the author?) which is an invitation to test, critique, and or adopt. Of course, the OP's relationship to the author flavors this expectation, and I could be in error.
        danShumway 6y ago
        > If there is no desire to have adoption, then there is no compelling reason to host publically outside of convenience. I get the sentiment, but please don't listen to advice like this. I have benefited multiple times from small Open Source projects on Github that were essentially abandoned and undocumented. Sometimes just having source code is enough. More than one of the projects I'm currently working on are essentially just forks of permissively licensed, undocumented projects that I found on Github. Yes, documentation is very important if you want an actual professional project that lots of people can use. But I generally encourage people to get into the habit of just releasing stuff. A permissively licensed project with no documentation on Github might end up benefiting at least one or two people. Maybe it won't benefit anyone at all, but at least the possibility is there. A project that never gets released to anyone is guaranteed to benefit nobody except the original maintainer. In general, people are bad at determining what parts of their work have value. People worry about drowning Github in tiny or unfinished trash-projects, but my experience has been that it is much easier to filter projects than to find projects. If I have a problem, I can spend 2 hours filtering through bad solutions and reading source code until I get at least a picture of what a solution might look like. That'll be more enjoyable than spending 2 hours scrolling through unrelated blog posts or desperately trying to come up with search terms to find anything anywhere that's applicable to what I'm trying to do. Documenting > Orphaning > Not Releasing
        tomrod 6y ago
        You know what, that is a completely fair assessment and a fantastic take. Edit period has passed, so I'd revise my prior stance to be clearer that my point wasn't advice, but more general motivation/driver assessment. In terms of what benefits society as a whole, I agree with you completely.
- nathancahill 6y ago
  It's a pre-release experimental library.
- hazz99 6y ago
  Experimental charting library for Svelte Key word being "experimental". This is the description of the Github. It's open source and they don't owe you anything––they are doing this for free. If anything, it's more amateur to document an experimental API you know will be continually broken until a stable release in the distant future. They don't want people to start relying on it.

Another JS optional charting library I've been keeping my eye on: Pancake, from the creator of Svelte. Experimental, pre-release: https://pancake-charts.surge.sh https://pancake-charts.surge.sh

reaperducer 6y ago

Documentation is TODO Why do people do this? If you're going to bother to make a project public with a big page demonstrating what it can do, why would you skip the part where you tell people how? It really comes off as amateur. I have other things to do with my time than reverse-engineer your code.

kjhughes 6y ago
It really comes off as amateur. I have other things to do with my time than reverse-engineer your code. Perhaps the authors, who were generous enough to share the results of their work, have better things to do than to handhold you through review of their work.
- tomrod 6y ago
  Then their work probably isn't worthwhile to adopt, given the plethora of alternatives. If their time is limited so that no documentation is produced, dropping bugfixes seem to be next (IME).
  - scrollaway 6y ago
    Unless those authors are specifically trying to get you to adopt their work for whatever reason (sales, good will, etc) and in which case they'd likely have documented it, you are not doing them a favor by adopting their work. You're just benefiting from what they've released. It's like going to a free buffet and complaining there's no napkins. Sure, you can complain, and you're technically correct that there should be napkins. But it's still in bad taste.
    - tomrod 6y ago
      If there is no desire to have adoption, then there is no compelling reason to host publically outside of convenience. We fundamentally agree, I think, with the difference of our thought being that we have a "show hn" post (I assume from the author?) which is an invitation to test, critique, and or adopt. Of course, the OP's relationship to the author flavors this expectation, and I could be in error.
      - danShumway 6y ago
        > If there is no desire to have adoption, then there is no compelling reason to host publically outside of convenience. I get the sentiment, but please don't listen to advice like this. I have benefited multiple times from small Open Source projects on Github that were essentially abandoned and undocumented. Sometimes just having source code is enough. More than one of the projects I'm currently working on are essentially just forks of permissively licensed, undocumented projects that I found on Github. Yes, documentation is very important if you want an actual professional project that lots of people can use. But I generally encourage people to get into the habit of just releasing stuff. A permissively licensed project with no documentation on Github might end up benefiting at least one or two people. Maybe it won't benefit anyone at all, but at least the possibility is there. A project that never gets released to anyone is guaranteed to benefit nobody except the original maintainer. In general, people are bad at determining what parts of their work have value. People worry about drowning Github in tiny or unfinished trash-projects, but my experience has been that it is much easier to filter projects than to find projects. If I have a problem, I can spend 2 hours filtering through bad solutions and reading source code until I get at least a picture of what a solution might look like. That'll be more enjoyable than spending 2 hours scrolling through unrelated blog posts or desperately trying to come up with search terms to find anything anywhere that's applicable to what I'm trying to do. Documenting > Orphaning > Not Releasing
        tomrod 6y ago
        You know what, that is a completely fair assessment and a fantastic take. Edit period has passed, so I'd revise my prior stance to be clearer that my point wasn't advice, but more general motivation/driver assessment. In terms of what benefits society as a whole, I agree with you completely.
nathancahill 6y ago
It's a pre-release experimental library.
hazz99 6y ago
Experimental charting library for Svelte Key word being "experimental". This is the description of the Github. It's open source and they don't owe you anything––they are doing this for free. If anything, it's more amateur to document an experimental API you know will be continually broken until a stable release in the distant future. They don't want people to start relying on it.