Skip to content

Commit 8ac454b

Browse files
authored
docs: simplify roadmap text (#339)
## Description This PR needs a quick review. ## Checklist - [X] Formatted Markdown - [X] Ran `just run-all`
1 parent da95f3c commit 8ac454b

File tree

1 file changed

+56
-77
lines changed

1 file changed

+56
-77
lines changed

roadmap/index.qmd

Lines changed: 56 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -7,124 +7,107 @@ format:
77

88
{{< include /includes/_wip.qmd >}}
99

10-
This is a very high level roadmap and "wishlist" for products we aim or
11-
want to create and develop in the Seedcase Project. We do not include
12-
timelines or estimates for completion in this document (see note below).
13-
We have a more detailed and regularly updated roadmap that has some
14-
general timelines available on our [Long-term Planning GitHub
15-
Board](https://github.com/orgs/seedcase-project/projects/22/views/1).
10+
This is a high level roadmap for products we want to create in the
11+
Seedcase Project. We do not include timelines or estimates for
12+
completion in this document.
1613

17-
::: callout-important
18-
Estimating a timeline can be extremely difficult, as it is dependent on
19-
multiple factors that often can't be predicted or anticipated.
20-
Therefore, and from our experiences on timelines regularly needing to be
21-
updated, we avoid giving specific timelines in this document.
22-
:::
14+
For a more detailed and regularly updated roadmap, see our [Long-term
15+
Planning GitHub
16+
Board](https://github.com/orgs/seedcase-project/projects/22/views/1).
2317

24-
## Product wishlist
18+
## Product roadmap
2519

26-
This is a non-exhaustive list of products or outputs that we believe
27-
fill multiple strong needs within the research community, especially in
28-
order to remain relevant and competitive in the modern research
29-
landscape. We believe that we have the capability, expertise,
30-
motivation, and passion to complete these products. These products, we
31-
believe, will substantially improve how research will be done in the
32-
future. However, given our current timelines and resources, we can't
33-
complete all of them but we list them here to show our visions and
20+
This is a non-exhaustive list of products or outputs that we believe can
21+
fill multiple strong needs within the research community. These
22+
products, we believe, have the capacity to substantially improve how
23+
research is done. However, given our current timelines and resources, we
24+
can't complete all of them. We list them here to show our visions and
3425
goals.
3526

3627
They are split into three main categories: software and
37-
software-related, technical documentation, and events. Technical
38-
documentation encompasses more than just usage guides or manuals for
39-
software, but also includes courses, opinion pieces, and outreach
40-
materials.
28+
software-related, technical documentation, and outreach.
4129

42-
Products are listed in the order that we would like to work on and aim
43-
to complete them. Beside each product is a status, which is one of the
44-
following:
30+
Products are listed in the order that we plan to work on and complete
31+
them. Beside each product is one of the following status icons:
4532

4633
| Status | Description |
4734
|:-----------------------------:|:----------------------------------------|
48-
| {{< var status.done >}} | Products we have completed a minimally viable product (MVP) of. As products are never truly "done", the "done" status simply indicates that the product is now in a usable state, but that we will continue improving and working on it. |
49-
| {{< var status.wip >}} | Products we are currently working on. |
50-
| {{< var status.planned >}} | Products we plan to work on and aim to complete within the current funding period (end of 2027). |
51-
| {{< var status.potential >}} | Products we are very interested in working on, but given the time and resources, may likely not get to within the current funding period (end of 2027). |
52-
| {{< var status.ongoing >}} | Products that we will continually work on and that don't strictly have a defined endpoint for "done" (e.g. aren't ever released or uploaded to an archive). |
35+
| {{< var status.done >}} | Products we've completed with a minimally viable product (MVP) that we'll continue to improve and work on. |
36+
| {{< var status.wip >}} | Products we are working on currently. |
37+
| {{< var status.planned >}} | Products we plan to complete within the current funding period (end of 2027). |
38+
| {{< var status.potential >}} | Products we'd like to work on, but probably won't finish within the current funding period (end of 2027) due to limited time and resources, |
39+
| {{< var status.ongoing >}} | Ongoing products without a final release (e.g., not archived or officially published). |
5340

5441
### Software and software-related
5542

56-
Because of the evolving nature of developing software, software products
57-
are rarely "complete", as they continue to be improved on and updated.
58-
The product reaches MVP and done status when we have created its first
59-
release on an official software archive (like PyPI for Python packages).
60-
After the first release of a MVP and if it gets sufficient use, it will
61-
continue to be tested and refined based on user feedback and identified
62-
bugs.
43+
Because software development is an ongoing process, software products
44+
are rarely truly "complete". They continue to evolve through updates and
45+
improvements. A product is considered to have reached MVP and "done"
46+
status once its first version is released on an official software
47+
archive (like PyPI for Python packages). If the product gets sufficient
48+
use, it will continue to be tested and refined based on user feedback.
6349

64-
Some of these products are not strictly software, but can be used within
65-
a software environment, can be integrate into other workflows, or are
66-
used to support research software and data engineering.
50+
Some of these products are not strictly software, but are designed to
51+
work within software environments, integrate with other workflows, or
52+
support research software and data engineering.
6753

6854
::: panel-tabset
6955
#### Software
7056

7157
| Status | Software |
72-
|:---------------------------------------------:|:------------------------|
58+
|:--------------------------------------------:|:------------------------|
7359
| {{< var status.wip >}} | [`seedcase-project/seedcase-sprout`](https://github.com/seedcase-project/seedcase-sprout): Upload your research data to formally structure it for better, more reliable, and easier research. |
7460
| {{< var status.planned >}} | `seedcase-project/check-datapackage`: Check the correctness of a `datapackage.json` file. |
7561
| {{< var status.planned >}} | `seedcase-flower`: Cataloging and browsing metadata within a data package. |
7662
| {{< var status.planned >}} | `seedcase-shears`: Processing raw data into a [Tidy](https://vita.had.co.nz/papers/tidy-data.pdf) [Polars DataFrame](https://pola.rs/). |
7763
| {{< var status.planned >}} | `seedcase-propagate`: Submitting requests for accessing specific data from a data package. |
7864
| {{< var status.planned >}} | `seedcase-garden`: Tend to and track projects using data from a data package. |
7965

80-
: "Wishlist" of software products we are currently working on, will work
81-
on, or hope to work on.
66+
: "Wishlist" of software products.
8267

8368
#### Software-related products
8469

8570
| Status | Software-related product |
86-
|:---------------------------------------------:|:------------------------|
87-
| {{< var status.ongoing >}} | [`seedcase-project/seedcase-theme`](https://github.com/seedcase-project/seedcase-theme): Template repository for website projects with a Seedcase-specific Quarto extension for aesthetics, helper commands, and infrastructural files. |
71+
|:--------------------------------------------:|:------------------------|
72+
| {{< var status.ongoing >}} | [`seedcase-project/seedcase-theme`](https://github.com/seedcase-project/seedcase-theme): Template repository for website projects with a Seedcase-specific Quarto extension for aesthetics and infrastructural files. |
8873
| {{< var status.ongoing >}} | [`seedcase-project/template-python-project`](https://github.com/seedcase-project/template-python-project): A template repository to use when making a Python project for Seedcase. |
8974
| {{< var status.ongoing >}} | [`seedcase-project/spaid`](https://github.com/seedcase-project/spaid): A toolkit for developing Seedcase projects. |
9075

91-
: "Wishlist" of software-related products we are currently working on,
92-
will work on, or hope to work on.
76+
: "Wishlist" of software-related products.
9377
:::
9478

9579
### Technical documentation
9680

97-
Following the [diátaxis](https://diataxis.fr/) method to structuring
98-
documentation, documentation is split up into four types: tutorials,
99-
how-to guides, reference, and explanation. A brief description of these
100-
types of documentation are expanded upon in the sections below. These
101-
technical documentation products reach MVP and done status when they are
102-
either:
81+
Following the [diátaxis](https://diataxis.fr/) method, we split
82+
documentation into four types: tutorials, how-to guides, reference, and
83+
explanation. A brief description of these types are expanded upon in the
84+
sections below. These technical documentation products reach MVP and
85+
done status when they are either:
10386

10487
- Uploaded to an archive like Zenodo (to generate a DOI).
105-
- Taught to participants in a course setting.
88+
- Taught to participants in a workshop setting.
10689
- Uploaded to a software archive (like PyPI) if they are within a
10790
software product's repository and are executable (the code within
10891
runs).
10992

11093
::::: panel-tabset
11194
#### Tutorials
11295

113-
Tutorials are learning-oriented documentation that includes multi-day
114-
courses, online tutorials, and learning shorts. These will be developed
115-
as [open educational
96+
Tutorials are learning-oriented documentation that includes workshops,
97+
online tutorials, and learning shorts. These will be developed as [open
98+
educational
11699
resources](https://en.wikipedia.org/wiki/Open_educational_resources).
117100

118101
| Status | Learning resource |
119102
|:--------------------------------------------:|:-------------------------|
120-
| {{< var status.wip >}} | [`rostools/git4cats`](https://github.com/rostools/git4cats): 🐱 Git for Collaborative Teams: An introductory course on using Git and GitHub for team-based collaborative workflows and practices |
121-
| {{< var status.potential >}} | Course: Introduction to building research software using Python as a solo developer in research environments. |
122-
| {{< var status.potential >}} | Course: Iterative project management and development for effective collaboration and work. |
103+
| {{< var status.done >}} | [`rostools/github-intro`](https://github.com/rostools/github-intro): An introductory workshop on using GitHub |
104+
| {{< var status.wip >}} | [`rostools/git4cats`](https://github.com/rostools/git4cats): 🐱 Git for Collaborative Teams: An introductory workshop on using Git and GitHub for team-based collaborative workflows and practices |
105+
| {{< var status.potential >}} | Workshop: Introduction to building research software using Python as a solo developer in research environments. |
106+
| {{< var status.potential >}} | Workshop: Iterative project management and development for effective collaboration and work. |
123107
| {{< var status.potential >}} | [`rostools/r-pkg-intro`](https://github.com/rostools/r-pkg-intro): Build research software using R as a solo developer in research environments. |
124-
| {{< var status.potential >}} | Course: Building research software using Python in a team setting. |
108+
| {{< var status.potential >}} | Workshop: Building research software using Python in a team setting. |
125109

126-
: "Wishlist" of learning-type documentation products we are currently
127-
working on, will work on, or hope to work on.
110+
: "Wishlist" of learning-type documentation products.
128111

129112
#### How-to guides
130113

@@ -146,8 +129,7 @@ user manuals.
146129
| {{< var status.potential >}} | Building DataOps pipelines and infrastructure for improving research data quality and reduce time from collection to analysis. |
147130
| {{< var status.potential >}} | Integrating research operations in organizations to improve quality and speed up research. |
148131

149-
: "Wishlist" of goal-type documentation products we are currently
150-
working on, will work on, or hope to work on.
132+
: "Wishlist" of goal-type documentation products.
151133

152134
#### Reference
153135

@@ -167,14 +149,14 @@ products are all classified as "ongoing".
167149

168150
| Status | Information resource |
169151
|:--------------------------------------------:|:-------------------------|
152+
| {{< var status.ongoing >}} | [`seedcase-project/seedcase-sprout`](https://sprout.seedcase-project.org/docs/reference/): Reference docs for Sprout. |
170153
| {{< var status.ongoing >}} | [`seedcase-project/design`](https://github.com/seedcase-project/design): Overall architectural design documentation for Seedcase software. |
171154
| {{< var status.ongoing >}} | [`seedcase-project/team`](https://github.com/seedcase-project/team): Documentation specific to the Seedcase team, like onboarding, common configuration files, and meeting agendas and minutes. |
172155
| {{< var status.ongoing >}} | [`seedcase-project/community`](https://github.com/seedcase-project/community): Content for community building, outreach, and contributing guidelines for the Seedcase Project. |
173156
| {{< var status.ongoing >}} | [`seedcase-project/seedcase-website`](https://github.com/seedcase-project/seedcase-website): Main website for the Seedcase Project. |
174157
| {{< var status.ongoing >}} | [`seedcase-project/examples`](https://github.com/seedcase-project/examples): Practical examples of how to use Seedcase software to structure datasets and prepare them to be used by others. All data is either fake, synthetically generated, or completely open. |
175158

176-
: "Wishlist" of informational-type documentation products we are
177-
currently working on, will work on, or hope to work on.
159+
: "Wishlist" of informational-type documentation products.
178160

179161
#### Explanation
180162

@@ -192,8 +174,7 @@ pieces, and outreach materials.
192174
| {{< var status.potential >}} | Research data engineering: What is it and why is it vital for modern research? |
193175
| {{< var status.potential >}} | Challenges and barriers: Workflows and digital infrastructure for building software in a team-based research environment. |
194176

195-
: "Wishlist" of explanation-type documentation products we are currently
196-
working on, will work on, or hope to work on.
177+
: "Wishlist" of explanation-type documentation products.
197178

198179
::: content-hidden
199180
| Status | Deliverable |
@@ -206,9 +187,8 @@ working on, will work on, or hope to work on.
206187

207188
### Outreach and events
208189

209-
These are activities that would involve engaging with the research
210-
community, mainly through in-person seminars, symposiums, or other
211-
events.
190+
These are activities involves engaging with the research community,
191+
mainly through in-person seminars, symposiums, or other events.
212192

213193
::: callout-note
214194
Given the expertise and resources needed for these types of "products"
@@ -223,8 +203,7 @@ research community about the various topics we work on and advocate for.
223203
| {{< var status.potential >}} | Seminar series: Unmet needs for research data engineering and current challenges in implementation |
224204
| {{< var status.potential >}} | Symposium: Current state of data engineering in research environment |
225205

226-
: "Wishlist" of outreach event "products" we are currently working on,
227-
will work on, or hope to work on.
206+
: "Wishlist" of outreach event "products".
228207

229208
## Collaborations and users
230209

0 commit comments

Comments
 (0)