Skip to content
Open
Show file tree
Hide file tree
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
497 changes: 497 additions & 0 deletions scripts/bash/create-ado-workitems.sh

Large diffs are not rendered by default.

508 changes: 508 additions & 0 deletions scripts/powershell/create-ado-workitems.ps1

Large diffs are not rendered by default.

26 changes: 26 additions & 0 deletions specs/001-hello-world/.speckit/azure-devops-mapping.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
{
"syncDate": "2026-03-03T10:06:25.3985315+05:30",
"organization": "MSFTDEVICES",
"project": "Devices",
"workItems": [
{
"StoryNumber": "1",
"Title": "Display Welcome Message",
"Priority": "P1",
"WorkItemId": 5388270,
"WorkItemUrl": "https://dev.azure.com/MSFTDEVICES/Devices/_workitems/edit/5388270",
"ParentStoryNumber": null,
"Status": "Created"
},
{
"StoryNumber": "2",
"Title": "Simple Documentation Page",
"Priority": "P2",
"WorkItemId": 5388271,
"WorkItemUrl": "https://dev.azure.com/MSFTDEVICES/Devices/_workitems/edit/5388271",
"ParentStoryNumber": null,
"Status": "Created"
}
],
"feature": "001-hello-world"
}
90 changes: 90 additions & 0 deletions specs/001-hello-world/spec.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
# Feature Specification: Hello World Documentation

**Feature Branch**: `001-hello-world`
**Created**: March 3, 2026
**Status**: Draft
**Input**: User description: "create hello world doc"

## User Scenarios & Testing *(mandatory)*

### User Story 1 - Display Welcome Message (Priority: P1)

New users visiting the application should see a friendly "Hello World" message that confirms the application is running correctly.

**Why this priority**: This is the most fundamental piece - it demonstrates the application is working and provides immediate feedback to users.

**Independent Test**: Can be fully tested by launching the application and verifying the "Hello World" message appears on screen, delivering immediate confirmation of application functionality.

**Acceptance Scenarios**:

1. **Given** the application is not running, **When** the user starts the application, **Then** a "Hello World" message is displayed prominently
2. **Given** the application displays the message, **When** the user refreshes or reloads, **Then** the "Hello World" message remains visible
3. **Given** the application is running, **When** the user accesses the main page, **Then** the message appears within 1 second

---

### User Story 2 - Simple Documentation Page (Priority: P2)

Users should be able to access a simple documentation page that explains what the Hello World application demonstrates.

**Why this priority**: Provides contextual information and helps users understand the purpose of the example.

**Independent Test**: Can be tested by navigating to the documentation page and verifying that explanatory text about the Hello World application is displayed.

**Acceptance Scenarios**:

1. **Given** the user is on the main page, **When** they click a "Documentation" link, **Then** they are taken to a page explaining the Hello World application
2. **Given** the user is on the documentation page, **When** they read the content, **Then** they find clear explanations of what Hello World demonstrates
3. **Given** the documentation page is displayed, **When** the user wants to return, **Then** a "Back" or "Home" link is available

---

### User Story 3 - Customizable Greeting (Priority: P3)

Users should be able to customize the greeting message to personalize their experience.

**Why this priority**: Adds interactivity and demonstrates basic user input handling, but not essential for the core functionality.

**Independent Test**: Can be tested by providing a custom name and verifying that the message changes from "Hello World" to "Hello [Name]".

**Acceptance Scenarios**:

1. **Given** the user is on the main page, **When** they enter their name in an input field and submit, **Then** the message changes to "Hello [Name]"
2. **Given** the user has customized the greeting, **When** they clear the input, **Then** the message reverts to "Hello World"
3. **Given** the user enters special characters or very long names, **When** they submit, **Then** the application handles input gracefully without errors

---

### Edge Cases

- What happens when the application is accessed on different devices (mobile, tablet, desktop)?
- How does the system handle multiple simultaneous users?
- What happens if JavaScript is disabled in the browser?
- How does the application behave with different character sets or internationalization?

## Requirements *(mandatory)*

### Functional Requirements

- **FR-001**: System MUST display "Hello World" message on the main page
- **FR-002**: System MUST render the message in a clearly visible format (large, centered text)
- **FR-003**: System MUST load and display the message within 1 second of page load
- **FR-004**: Users MUST be able to access documentation explaining the Hello World application
- **FR-005**: System MUST support optional customization of the greeting message
- **FR-006**: System MUST handle empty or invalid input gracefully without crashing
- **FR-007**: System MUST be accessible on modern web browsers (Chrome, Firefox, Safari, Edge)

### Key Entities *(include if feature involves data)*

- **Greeting**: The message displayed to users, defaults to "Hello World", can be customized
- **User Input**: Optional name or text provided by users to personalize the greeting

## Success Criteria *(mandatory)*

### Measurable Outcomes

- **SC-001**: New users can see the "Hello World" message immediately upon accessing the application (within 1 second)
- **SC-002**: 100% of users successfully see the greeting on first visit across all supported browsers
- **SC-003**: Documentation page loads within 1 second and contains at least 100 words of explanatory content
- **SC-004**: Users can customize the greeting and see their changes reflected within 500ms of submission
- **SC-005**: Application maintains 99.9% uptime and handles at least 100 concurrent users without degradation
Loading