Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Vis Library Roadmap

## Path to 0.1.0
Copy link
Collaborator

@lanesawyer lanesawyer Mar 17, 2025

Choose a reason for hiding this comment

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

My ideas:

  1. Remove the deprecated beginLongRunningFrame function (Remove deprecated beginLongRunningFrame from vis-core #139)
  2. Examples website is deployed (doesn't have to be pretty)
  3. Test coverage tools are in place and we're alerted on PRs as to how the coverage has changed
  4. All lint issues are fixed
  5. Libraries used are updated to latest versions
  6. Docs are fleshed out a bit more (can still be markdown and not be fully comprehensive)

I think on any more!

Copy link
Contributor

Choose a reason for hiding this comment

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

I'd say the example site should be minimally pretty, maybe we follow some of the bkp client design ideas. I'd be happy to do a design spike for it in figma so that Su and Joel can focus on the more important design stuff

Copy link
Collaborator

Choose a reason for hiding this comment

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

Yeah, minimally pretty is more of what I meant. A little better than what we have now, at the very least lol

- Rename the `vis-scatterbrain` package to `vis-core`
- Apply error handling across the codebase with consistent formatting, usage of error types and logging
- Test coverage tools are in place and we're alerted on PRs as to how the coverage has changed
- Libraries used are updated to latest versions
- Docs are fleshed out a bit more (can still be markdown and not be fully comprehensive)
- Examples website is upgraded to be somewhat more user-friendly and easier on the eyes (doesn't have to be fancy)

## Path to 1.0.0
- Comprehensive, easy to use docs that are deployed to a publically-accessible website, e.g. an mdBook site, an Astro Docs site, etc.
- Comprehensive docs include tutorials for how to setup and use each package, descriptions of lifecycles of key elements, etc.
- Live running examples of library components alongside the documentation, with users able to experiment with different settings (ala Storybook) to explore what the visualizations can do
- Live CodePens or similar available on documentation site to enable code-level experimentation for users
- Nice/very nice to have: Performance tests triggered by PR changes
- All packages have been tested extensively for over 6 months without any major issues
- Package publishing is entirely or significantly automated
- Changelog has been published
- Documentation for how to create the changelog has been published
- The `bkp-client` Scatterbrain capabilities have been translated into a new `vis-scatterbrain` or similar package