-
Feature
-
Resolution: Unresolved
-
Critical
-
None
-
None
-
None
-
False
-
-
False
-
Not Selected
Feature Overview (mandatory - Complete while in New status)
We need to provide a simple entry point for users to be able to run document conversions. Since docling is the documented, recommended process in the downstream product today, we can use that for this step.
We separate this piece out since conversion to a .md file(s) can be riddled with errors, and we need to make this a simple, iterative process.
Goals (mandatory - Complete while in New status)
Provide high-level goal statement, providing user context and expected user outcome(s) for this Feature
- Users can easily run the notebook
Requirements (mandatory -_ Complete while in Refinement status):
A list of specific needs, capabilities, or objectives that a Feature must deliver to satisfy the Feature. Some requirements will be flagged as MVP. If an MVP gets shifted, the Feature shifts. If a non MVP requirement slips, it does not shift the feature.
Requirement | Notes | isMVP? |
Provide a notebook with well-documented steps: For eg. showcase how a user can use different docling configurations (explain the options available, provide defaults), highlight what configuration to choose when and other best practices Start with installing the library and versions needed at the top of each notebook |
Yes | |
Notebook should provide workflows for both: 1. single document 2. multiple documents 3. multiple folders of documents |
Yes | |
Consider how this particular notebook’s inputs/outputs flow with the next notebook in the process - how is it all put together? Ensure file paths, output types etc are consistent |
Yes | |
Potentially a demo showing: how will this be run on RHEL AI? with Elyra? Workbench container? | No | |
Show how a user would work through a folder of documents - show progress bars | No |
Done - Acceptance Criteria (mandatory - Complete while in Refinement status):
Acceptance Criteria articulates and defines the value proposition - what is required to meet the goal and intent of this Feature. The Acceptance Criteria provides a detailed definition of scope and the expected outcomes - from a users point of view.
- Ensure it passes UX reviews ([reqs documented here|https://github.com/instructlab/examples/blob/main/Notebook-UX-Review-Template.md])
Use Cases - i.e. User Experience & Workflow: (Initial completion while in Refinement status):
Include use case diagrams, main success scenarios, alternative flow scenarios.
<your text here>
Out of Scope {}{}(Initial completion while in Refinement status):
High-level list of items or persona’s that are out of scope.
<your text here>
Documentation Considerations {}{}(Initial completion while in Refinement status):
Provide information that needs to be considered and planned so that documentation will meet customer needs. If the feature extends existing functionality, provide a link to its current documentation..
<your text here>
Questions to Answer {}{}(Initial completion while in Refinement status):
Include a list of refinement / architectural questions that may need to be answered before coding can begin.
<your text here>
Background and Strategic Fit (Initial completion while in Refinement status):
Provide any additional context is needed to frame the feature.
<your text here>
Customer Considerations {}{}(Initial completion while in Refinement status):
Provide any additional customer-specific considerations that must be made when designing and delivering the Feature.
<your text here>
Team Sign Off (Completion while in Planning status)
- All required Epics (known at the time) are linked to the this Feature
- All required Stories, Tasks (known at the time) for the most immediate Epics have been created and estimated
- Add - Reviewers name, Team Name
- Acceptance == Feature as “Ready” - well understood and scope is clear - Acceptance Criteria (scope) is elaborated, well defined, and understood
- Note: Only set FixVersion/s: on a Feature if the delivery team agrees they have the capacity and have committed that capability for that milestone
Reviewed By | Team Name | Accepted | Notes |
- …
- account is impacted by
-
RHELAI-4309 [AI-Eng] Step 3 (conversion dashboard) - Document ingestion UI
-
- Closed
-
-
RHELAI-4354 Feedback Implementation - Document Ingestion UI Stages 1 & 2
-
- Closed
-