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

Group projects as appropriate #375

Open
jducoeur opened this issue Jul 22, 2022 · 9 comments
Open

Group projects as appropriate #375

jducoeur opened this issue Jul 22, 2022 · 9 comments
Labels
post-reboot Small improvements that can wait until after the new site is live

Comments

@jducoeur
Copy link
Member

The old website grouped projects together -- for example, projects that are specifically adapters for Shapeless were grouped together.

We probably want something of the sort on the new site, but we should pause and take a little time to think about design before jumping into that. Do we want "static" groupings like the old site had? Do we want something more modern and dynamic (eg, click on Shapeless and it expands to show the sub-projects)? How much effort are we willing to go to here?

@jducoeur jducoeur added the post-reboot Small improvements that can wait until after the new site is live label Jul 22, 2022
@rossabaker
Copy link
Member

I don't have the skills for the UI, but I can comment on the information architecture:

  • Are projects a tree, and if they are, are they a tree of depth 2? This is how it works on the current site, but only two projects have children, and some of those children are dubious. But it might let projects like http4s and scodec bring their children.
  • Are projects a graph, with links to related projects? Messy, but someone more talented could do visualizations.
  • Do we tag projects? If we do that, something as simple as the way we tag blog posts works, and is within my skillset.

@jducoeur
Copy link
Member Author

Yep, agreed on all points. I do think we need to step back and do some analysis, which is one reason why I specifically want to put this one off for a little while, so we can think about it properly.

@jducoeur
Copy link
Member Author

(We also may want to loop those affiliate projects explicitly into this conversation, and get their viewpoint on how they think about it, and what sorts of display make sense from their POV.)

@rossabaker
Copy link
Member

We can reach the maintainers of Typelevel projects on the maintainers discussion. We don't have such a convenient list of affiliate developers, though there's much overlap.

@jducoeur
Copy link
Member Author

Yeah, I'm not surprised. It'll take some time and effort, but we should probably deal with it gradually.

@ChristopherDavenport
Copy link
Member

I love the idea of tagging so that folks can limit based on dep, the tree then is the core TL libs and the the surrounding ecosystem branching off, and we can add tags as appropriate as we have more libraries join.

Like - cats, cats-effect, fs2, shapeless, scalacheck, discipline, http4s as initial tags that folks could filter by.

Just musings more than real thoughts.

@jducoeur
Copy link
Member Author

I don't know the site well enough yet to grok how it would work, but I agree that a tagging-oriented approach makes sense. (Especially given that some libraries are essentially glue, and conceptually belong under multiple headings.)

@rossabaker
Copy link
Member

I was thinking more like "HTTP", "Database", "Testing", etc., for people who don't know what the hell is an fs2. Chris' set is nice for "I know the basics, what works well with...", and my set is nice for "I'm new here, how do I...". They're both valid use cases, but I'm not sure how to render both without being confusing.

@jducoeur
Copy link
Member Author

They're not mutually exclusive -- that's why I like the tag approach, because it can handle multi-dimensional ontologies.

How we display that -- I don't know, and we're going to have to think hard about the information architecture here. But using tagging as the basis probably makes sense regardless.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
post-reboot Small improvements that can wait until after the new site is live
Projects
None yet
Development

No branches or pull requests

3 participants