Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[todo] Develop a way to mark issues for discussions over JLreq-d topics as pending for text development #389

Closed
himorin opened this issue Dec 19, 2023 · 3 comments
Assignees

Comments

@himorin
Copy link
Contributor

himorin commented Dec 19, 2023

From JL-TF call 2023-12-19, management of discussion at JLreq-d repository.

While we have draft text to be used for basis of upcoming JLreq-d, only some sections are well developed but others are not.
There are several discussion topics which have been well discussed within JL-TF and concluded with mature consensus, but without any target document for raising/drafting PR.
To separate these issues from other on-going issues or discussions, we need to have some method, which shall be easily noticeable at both list of issues page and individual issue page, and also easily handled by participants.

Several ideas raised during call

  • simply adding label
  • set milestone
  • use project view
@kidayasuo
Copy link
Contributor

kidayasuo commented Dec 25, 2023

参考
Appleのバグトラッキングシステム(Radar)には次のステートがある: Analyze, Integrate, Build, Verify, and Close。またAnalyzeを細分化した状態に”Fix”がある。”Fix”は問題の原因は判明しているが具体的な修正を行う前の状態。修正でなく新しい機能を作るときもこのラベルを使っていた。今回必要なのはこの状態に近い(ちなみにIntegrateは修正が終わって、組み込みを待っている状態で、GitHubの開発サイクルではPush Requestが該当する)。ラベル名として、この"Fix"、もしくは新しく文書起こすことにフォーカスすると"Compose"を提案する。後者の方が良いかも。

ラベルを作る以外の管理方法として、方向性のディスカッションと、実際の文言を作るIssueを分ける方法もあると思う。こちらの方がスッキリしそう。

c.f.
Apple's bug tracking system (Radar) has the following states: Analyze, Integrate, Build, Verify, and Close. Also, the Analyze has (within the Engineering org.) has a substate "Fix". The 'Fix' state indicates that the analysis of the bug has been completed, but the actual fix has not yet been implemented. Therefore, something equivalent to Apple's "Fix" state would be what we need. I propose the "Fix", or by focusing on creating a new text, "Compose"?

Alternative management method is to separate the discussion of direction and the creation of the actual wording into different issues. This seems like it would be clearer.

@kidayasuo
Copy link
Contributor

kidayasuo commented Dec 27, 2023

と言うことで、方向は決まったがまだテキストは作っていない、状態を示すのに、Fix または Compose というラベルを使うのはどうでしょう。

また、ラベルより良い方法として、方向性のディスカッションと、実際の文言を作るIssueを分ける方法を提案します。方向性が決まったら、文言を作るissueを新たに作って、元のissueは閉じる。こうすればより状態が明確になって管理がしやすいかと思います。方向性のディスカッションは、最初にどのくらい議論の対象が明確かによって、議論の対象が明確ならIssue、幅広いならDisucssion などと緩く使い分けすれば良いかと。

@kidayasuo
Copy link
Contributor

At the JLReq TF meeting on 2024-1-9, the team agreed to separate issues that tracks discussions and issues that track the actual implementation of the agreements.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants