Open Call for Contributions

オープン
#42 コメント 0 件 リアクション 5 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
25/100
issue の種類
ドキュメント
明瞭さ
説明が足りない
活発さ
停滞
技術スタック
python

調査の方向性

This issue is a general contribution call rather than a specific task, and it points contributors to course issues or a new issue for a proposed notebook. Start by choosing a course or educational topic and opening or joining its corresponding issue; use the contribution checklist and marimo best-practices link as guidance. Done means completing an agreed notebook contribution, not work defined by this issue alone.

索引モデルが issue の本文から書いたものです。

説明

enhancement help wanted

🔔 Open Call for Contributions 🔔

Hey there! 👋

We are excited to open up our repository for open-source contributions and can't wait to see what educational notebooks you come up with! 🧑‍🏫 This is a collaborative space where we develop and share high-quality marimo notebooks for education, covering fundamental concepts across various topics.

🚀 Projects We'd Love Your Help With

Below is a list of courses we're eager to develop. Each course is an opportunity to contribute and make a meaningful impact:

Project Status Author/s
Probability Course ✅ @Haleshot
Python ✅ @Haleshot
Polars Course 🚧 @koushikkhan, @jorammutenge, @etrotta, @debajyotid2, @peter-gy, @Jystine, @jesshart
Daft Course 🚧 @peter-gy
DuckDB course 🚧 @Mustjaab, @julius383, @thliang01
Functional programming course 🚧 @metaboulie
Calculus for Machine Learning Open -
HoloViews course Open -
hvplot course Open -
Plotly course Open -
Matplotlib Visualization Course Open -
Real Analysis Repo Open -
Linear Algebra Course Open -

✨ Have your own idea? Feel free to propose new courses or individual notebooks! Open an issue to suggest your idea, and we'll be happy to discuss and potentially add it to the list.

📝 How to Contribute

  1. Open a New Issue

    • If you're interested in any of the courses above or have a new idea, please comment on the corresponding issue if it exists, or open a new issue with a title that reflects the project.
    • Use the issue to discuss your approach and gather feedback.
  2. Let Us Know

    • Comment on this issue to let us know you've opened a new issue. We'll update the project list with a link to your issue.
  3. Start Coding

    • Follow our contribution checklist when developing your notebook.
    • Use marimo's reactive programming model to create interactive, educational content.
  4. Submit a Pull Request

    • Once you're ready, open a Pull Request (PR) linking to the issue you created.
    • Make sure to tag the issue in your PR description for easy reference.

📚 Contribution Checklist

  • Include package dependencies in notebook files using --sandbox
  • If adding a course, include a README.md
  • Keep language direct and simple
  • Follow marimo best practices for reactive programming
  • Ensure cells are idempotent and minimize global state
  • Use descriptive variable names that reflect data and computation intent
  • Apply appropriate caching strategies for expensive operations

🌟 Why Contribute to marimo learn?

Contributing to marimo learn is a great opportunity to:

  • Share your knowledge with the community
  • Receive an author byline in contributed notebooks and course README
  • Help others learn important concepts through interactive notebooks
  • Improve your own understanding of topics by teaching them
  • Build your portfolio and gain recognition in the open-source community
  • Help shape the future of educational content for marimo

🔍 What Makes a Great marimo Notebook?

Great marimo notebooks for education should:

  • Explain concepts clearly with a mix of markdown explanations and code
  • Be structured with a clear learning progression
  • If appropriate, include visualizations and UI elements to enhance understanding
  • If appropriate, include exercises or challenges for learners to practice
  • Be accessible to the target audience (beginners, intermediate, advanced)
主要言語
Python
スター
369
フォーク
69
平均マージ
1時間 32分
マージ済み PR(30日)
4

環境構築

  • Dockerfile または Docker Compose ファイルあり
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

marimo-team/learn のほかの issue

marimo-team/learn の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。