Skip to content

Add User Stories for Dune Tools - #16352

Open
Sudha247 wants to merge 4 commits into
ocaml:mainfrom
Sudha247:tools-user-stories
Open

Sudha247 wants to merge 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.

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>
@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
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>
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

2 participants