cube-code icon indicating copy to clipboard operation
cube-code copied to clipboard

Does this have any benefits over the speedsolving.com wiki?

Open lgarron opened this issue 10 years ago • 12 comments

https://www.speedsolving.com/wiki/index.php/Main_Page > Utitilities

lgarron avatar Apr 18 '15 21:04 lgarron

github has the benefit of being more coder oriented. @justinj said that this is a convention among other software projects: https://github.com/sindresorhus/awesome-nodejs, so it seems reasonable to me.

jfly avatar Apr 18 '15 21:04 jfly

Of course it's a coder convention. ;-)

But I feel like I'd rather not create two places with lists that have a similar purpose, especially if one of them is already the standard place for cubers to look. We should at least cross-reference this repo from there, but at that point I'd just move over all the entries from here.

lgarron avatar Apr 18 '15 21:04 lgarron

Maybe I should make it clearer that I think this repo should be specifically for libraries and developer resources, as opposed to end-user software, which seems to be what the wiki is focused on (at the moment, at least).

justinj avatar Apr 18 '15 21:04 justinj

I would still rather create a page for devs on the wiki. (It's a wiki; we can restructure however we want.)

At the very least, this repo and the wiki should be cross-linked.

lgarron avatar Apr 18 '15 21:04 lgarron

I'm not really a big fan of the wiki in general, to be honest, so I might not be considering this fairly. But personally, I'd rather have it here where it can be edited with tools I'm used to and be colocated with the libraries it's pointing to.

I'd be interested to hear what other people think?

justinj avatar Apr 18 '15 21:04 justinj

I'm definitely more comfortable in github than a wiki.

jfly avatar Apr 19 '15 00:04 jfly

I'm not really a big fan of the wiki in general, to be honest, so I might not be considering this fairly.

It's not the wiki we need, but it's the wiki we deserve. :-P I guess I'm just cynical about these efforts for cubing. There are so many well-meaning efforts, and nearly all of them fizzle out sooner or later. We might as well let it fizzle in a place where other cubing information is located, instead of letting two places get out of date.

lgarron avatar Apr 21 '15 07:04 lgarron

That's a very fair argument, maybe we could brainstorm if I outline the specific problem I'm trying to solve: It's sort of ridiculous how the fundamental stuff you'd need for almost any cube-related project doesn't exist for every major programming language. Stuff like:

  • A cube representation (tbh I'm not aware of a sufficiently general purpose one with a sensible interface in any language)
  • A set of high-quality scramblers, although I think libtnoodle or something like it might be the future here
  • Utility stuff that's annoying to write, like calculating session averages and alg manipulation (I only recently found alg.js, but it's really useful)

My thoughts in creating this were:

  1. It would make it easier to find such libraries that already exist
  2. It would incentivize people to make them in the first place, since there's a place to put them where others will see them

Part of my problem with putting this list on the wiki (which also exists with putting it here, to some extent), is that how active the wiki is is not clear unless you go into the edit history. On GitHub, the level of activity/popularity is more visible (issue discussion, number of stars, etc) which might help with #2.

I'm not convinced putting this on GitHub is the correct solution to the actual problem, but I really think the state of cube libraries is sort of terrible at the moment.

justinj avatar Apr 21 '15 07:04 justinj

I think the solution is to start writing good libraries. ;-)

If you continue this repo, I just have two requests:

  • Make it worth it. Make sure no coder ever has a reason they wouldn't find or use this list if they need it.
  • Clearly cross-link from/to the wiki (maybe even the wiki home page) so that anyone looking in one place will find the other place soon enough.

Sound good? :-D

»Lucas

On Tue, Apr 21, 2015 at 12:52 AM Justin Jaffray [email protected] wrote:

That's a very fair argument, maybe we could brainstorm if I outline the specific problem I'm trying to solve: It's sort of ridiculous how the fundamental stuff you'd need for almost any cube-related project doesn't exist for every major programming language. Stuff like:

  • A cube representation (tbh I'm not aware of a sufficiently general purpose one with a sensible interface in any language)
  • A set of high-quality scramblers, although I think libtnoodle https://github.com/jfly/libtnoodle or something like it might be the future here
  • Utility stuff that's annoying to write, like calculating session averages and alg manipulation (I only recently found alg.js, but it's really useful)

My thoughts in creating this were:

  1. It would make it easier to find such libraries that already exist
  2. It would incentivize people to make them in the first place, since there's a place to put them where others will see them

Part of my problem with putting this list on the wiki (which also exists with putting it here, to some extent), is that how active the wiki is is not clear unless you go into the edit history. On GitHub, the level of activity/popularity is more visible (issue discussion, number of stars, etc) which might help with #2.

I'm not convinced putting this on GitHub is the correct solution to the actual problem, but I really think the state of cube libraries is sort of terrible at the moment.

— Reply to this email directly or view it on GitHub https://github.com/cubing/cube-code/issues/1#issuecomment-94680492.

lgarron avatar Apr 21 '15 07:04 lgarron

I'm not sure I'm up to the task of writing all the libraries I want myself :)

I'll add a link on the wiki and make a speedsolving post soon, and clean up the presentation a bit.

I also think this issue should be left open for now, since I think this is a worthwhile discussion to continue as more stuff gets aggregated/more people come here.

justinj avatar Apr 22 '15 11:04 justinj

I'll add a link on the wiki and make a speedsolving post soon, and clean up the presentation a bit.

Could we also link to the wiki from this repo?

lgarron avatar Apr 25 '15 21:04 lgarron

Sure, do you want to do it? I'm not sure what you're thinking for the context of the link.

justinj avatar Apr 25 '15 22:04 justinj