Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Guidelines for interpretations / contributions with large dependencies #19

Open
cah6 opened this issue Jun 7, 2019 · 4 comments
Open

Comments

@cah6
Copy link

cah6 commented Jun 7, 2019

This is somewhat related to #16, but I was actually planning on asking before that issue, too.

My question is: do you have any thoughts / guidelines on a central location for user-contributed effects or interpretations, especially for those interpretations with large dependencies? I doubt you want to define any and all user provided interpretations in this zoo package, since it would probably end up with every Haskell package. But I think it's useful to have one place for people to browse packages, if only just because seeing a ton of examples helps me internalize the concepts and create my own.

For instance, say I interpret KVStore here in terms of the Elasticsearch bloodhound library, in my own repository. Where could people go to check if this was defined before making their own?

The easiest thing is probably just encouraging linking to other repositories in the readme of this repo, though some questions that might be worth thinking about even for this:

  1. should any library be allowed to be linked, or should it be reviewed by you first
  2. should any guidelines be enforced in them, for instance naming the package in some form (like polysemy-* or polysemy-effectName-interpretationName)
  3. Should any specific ordering of the links be stated up front, like grouping it by general effect type, then effect, then interpretations, etc
@Avi-D-coder
Copy link
Contributor

What about keeping multiple packages in this repo. That way they get more eyes on them and are kept up to date.

Effects like @adamConnerSax 's RandomFu would not add dependencies, but would still be visible and tested against.

@adamConnerSax
Copy link
Contributor

Fine by me. Though we should then remove the CanonicalEffect type-family or have some guidelines for when it can be used. Maybe only in this repo?

@isovector
Copy link
Member

@Avi-D-coder I'm not opposed to this, but it still has a significant package maintenance burden that I don't particularly want on my plate! If someone else wanted to step up, I'd be more than happy to support them in that!

@googleson78
Copy link
Member

Is it a good idea for stuff like this to go under the polysemy-research group?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants