Skip to content

Add User Stories for Dune Tools - #16352

Merged
Sudha247 merged 4 commits into
ocaml:mainfrom
Sudha247:tools-user-stories
Sep 16, 2026
Merged

Sudha247 merged 4 commits into
ocaml:mainfrom
Sudha247:tools-user-stories

Conversation

@Sudha247

@Sudha247 Sudha247 commented Sep 7, 2026

Copy link
Copy Markdown
Member

Description

This is a draft list of user stories for tools, from the perspective of users. Opening a PR early to get opinions from collaborators, but any thoughts are welcome!

Related Issue and Motivation

Fixes #15546.

Checklist

  • Tests added, if applicable.
  • Change log entry added for any user-facing changes.
  • Documentation added for any user-facing changes.

@Sudha247
Sudha247 marked this pull request as ready for review September 14, 2026 14:47

@shonfeder shonfeder left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These seems like a good start to me, and I'd be fine with this being merged after addressing my proposed fixes, and then we can build it out as needed.

If this will inform our work, it could be useful to also cover more nuanced cases like wanting to use a tool that is provided by a test dependency, or how to "promote" a discretionary tool into a dependency, or to install sets of related tools together.

But, as I say, this is already a good start. I also don't have much experience working with user stories, so I'm not totally sure what is optimal in that approach :)

Comment thread doc/dev/tools-design/user-stories.md Outdated
Comment thread doc/dev/tools-design/user-stories.md Outdated
Comment thread doc/dev/tools-design/user-stories.md Outdated
Comment thread doc/dev/tools-design/user-stories.md Outdated
Comment thread doc/dev/tools-design/user-stories.md
@Sudha247 Sudha247 changed the title [WIP] Add User Stories for Dune Tools Add User Stories for Dune Tools Sep 15, 2026
@Sudha247

Copy link
Copy Markdown
Member Author

Thanks for the review @shonfeder! I'm merging this. We can always update the file with edits/additions.

Fixed ocaml#15546.

This is a draft list of user stories for tools, from the perspective of users.
Opening a PR early to get opinions from others involved, but any thoughts
welcome!

Signed-off-by: Sudha Parimala <sudharg247@gmail.com>
Signed-off-by: Sudha Parimala <sudharg247@gmail.com>
Co-authored-by: Shon Feder <shon.feder@gmail.com>

Signed-off-by: Sudha Parimala <sudharg247@gmail.com>
Signed-off-by: Sudha Parimala <sudharg247@gmail.com>
@Sudha247
Sudha247 merged commit df5fff2 into ocaml:main Sep 16, 2026
18 of 20 checks passed
@Alizter Alizter added this to the 3.25.0 milestone Sep 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Develop user stories to illustrate and inform the dune tools requirements

3 participants