Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

RFC: Reorganize module namespaces

Open
#563 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
20/100
Issue type
Refactor
Clarity
Needs clarification
Activity status
Stale
Tech stack
vim
Domain
tooling

Research direction

Start by reviewing the linked Google spreadsheet and the discussion in vim-jp/#vital-dev, then read related issues #376 and #423. The issue needs an agreed namespace policy before implementation can begin; done would include the decided module reorganization and the proposed package rules documented in the README.

Written by the indexing model from the issue text.

Description

Slack の vim-jp/#vital-dev にて、各モジュールがどのパッケージに入っているべきかの見直しの話題が出ました。
https://docs.google.com/spreadsheets/d/1ncrq_k64viFgR5bwpMf8IuYcDaiXjLx-2kNCoqQBvxs/edit

パッケージの現状を上記のスプレッドシートに軽くまとめ、見直しとして、以下のような意見があります。

  • Prelude.is_windows() 系の関数をどこかに移したい
  • System と言う名前割と曖昧なので用途をはっきりさせたい
    • 実行環境的なニュアンスがある
    • その観点で言うと System.Cache だけ異端
  • Data は Haskell から来ている
  • 方針決めて新しいモジュールセットを作りたい
  • Process と System.Process があるのがわかりづらい
    • Process系全部廃止したい
  • DateTime がひょこんと root にいるのもちょっと気になる
    • どこに入れるべきか悩んだ結果そうなった
  • パッケージごとに何に関するモジュールを入れとけばいいかってのだけ決めとけばいいのではないか
  • Data はデータ構造を突っ込む場所って観点だと思ったよりそんなに違和感あるモジュールはなかった
    • データ構造と、 Data.String みたいに既存データを扱うやつが混在している
  • System -> OS にしたい
    • is_windows 系の移住先としては OS 使いたい
    • そもそも System って単語が幅が広過ぎる

Slack ではログが流れるため、ある程度の議論が終わったらこちらに dump してください。

関連 issue #376 #423

Dominant language
Vim Script
Stars
586
Forks
64
Avg merge
9h 24m
Merged PRs (30d)
1

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from vim-jp/vital.vim

All issues in vim-jp/vital.vim

Similar issues

More DevTools issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.