vim-jp / vim-jp/vimdoc-ja-working

敬体で書かれているリファレンスマニュアルを常体に変更する

Open
#1,799 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Vim Script
Stars
84
Forks
61
Avg merge
2d 19h
Merged PRs (30d)
35

Description

現状、リファレンスマニュアルがファイルによって、敬体 (です・ます) か常体 (だ・である) かに分かれていますが、これを常体に統一しようと思います。

※ユーザーマニュアル (usr_*.jax) は現状の敬体のまま。

PS
私は、以前は敬体派だった気がします。ですが、翻訳作業を多くこなしていくと、敬体は若干、鬱陶しくなってきました。
読み手としても常体が良いです。
ただ、常体の「~せよ。」だけは命令具合が強いので、それだけは使わないようにしようと考えています。

タスクリスト (「です。」を含むファイル。行数少ない順) (2024-11-10 18:00 JST時点)
  • pi_gzip.jax : 49 行
  • os_unix.jax : 63 行
  • pi_paren.jax : 71 行
  • pi_logipat.jax : 111 行
  • os_amiga.jax : 147 行
  • ft_mp.jax : 149 行
  • sponsor.jax : 153 行
  • ft_context.jax : 158 行
  • pi_zip.jax : 164 行
  • pi_tar.jax : 169 行
  • debug.jax : 175 行
  • os_mac.jax : 182 行
  • os_haiku.jax : 238 行
  • help.jax : 261 行
  • quotes.jax : 265 行
  • pi_vimball.jax : 270 行
  • arabic.jax : 307 行
  • if_perl.jax : 313 行
  • if_mzsch.jax : 322 行
  • uganda.jax : 330 行
  • version4.jax : 367 行
  • undo.jax : 430 行
  • helphelp.jax : 467 行
  • tabpage.jax : 484 行
  • ft_rust.jax : 495 行
  • pi_getscript.jax : 507 行
  • if_lua.jax : 544 行
  • tips.jax : 578 行
  • develop.jax : 599 行
  • print.jax : 740 行
  • ft_sql.jax : 752 行
  • various.jax : 800 行
  • intro.jax : 892 行
  • if_pyth.jax : 1010 行
  • netbeans.jax : 1022 行
  • term.jax : 1194 行
  • motion.jax : 1390 行
  • vi_diff.jax : 1398 行
  • pattern.jax : 1494 行
  • channel.jax : 1602 行
  • map.jax : 1912 行
  • quickfix.jax : 2073 行
  • vim9.jax : 2435 行
  • pi_netrw.jax : 4248 行
  • version8.jax : 41158 行
  • version9.jax : 41703 行

Contributor guide

No contributing guide indexed for this repository

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.

Research direction

Work through the unchecked reference-manual .jax files listed in the issue, excluding usr_*.jax user manuals. Start with the smallest unchecked file and compare its Japanese prose with the stated style goal. Done means the reference files use 常体 consistently without using the overly imperative 「~せよ。」 form.

Written by the indexing model from the issue text.

Assessment

Tech stack
vim
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.