search

typelevel / governance

Typelevel governance
Creative Commons Attribution 4.0 International
9 stars 2 forks source link

"Onboarding" experience site for TL? #60

Open jducoeur opened 2 years ago

jducoeur commented 2 years ago

Folks have observed that Unison has an excellent site for helping folks get started with the language, under https://share.unison-lang.org/

At least in principle, it would be great if we had something similar: some paint-by-numbers introductions that go beyond the current tutorials and ease the path of getting oneself started with TL projects.

This is a fairly tall order, not least because there are so many different kinds of potential TL projects: there's probably no one-size-fits-all starting points. But a few solid examples might be really helpful.

(Note that this isn't just a code-plus-text project: well-thought-out UX and information architecture are likely to also matter.)

rossabaker commented 2 years ago

I don't fully understand what's going on on that page.

First of all, it's a curated list of projects, categorized. Great. That's on our radar.

And then they go to nice descriptions of the project in the main pane, with what looks like API doc on the left. Is that just a standard Unison project site? It's an nice experience, but we're a federated project without a standard site template. Some Laika, some Jekyll, some just a GitHub. Is there anything we can do to hook into documentation that Typelevel projects already provide, or are we looking at additional work per project here?

softinio commented 1 year ago

At a glance, to me it looks to be the same as Scaladex