typelevel / typelevel/typelevel.github.com

"Onboarding" experience site for TL?

未關閉
#595 2 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

主要語言
HTML
星號
42
分支
115
平均合併
5 天 5 小時
30 天內合併 PR
7

描述

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.)

貢獻指南

開啟貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

研究方向

首先檢視目前的教學,以及 Unison 的 onboarding 網站:https://share.unison-lang.org/。找出一小組具代表性的 TL 專案介紹,並概述它們所需的 UX 與資訊架構。只有當專案具備已達成共識的具體 onboarding 範圍,而不只是一般性的提案時,才算完成。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
html
領域
design, documentation, web-dev
Issue 類型
功能
難度
5/5
預估耗時
一週以上
活躍度
停滯
描述清晰度
需要釐清
新手友好度
25/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。