-
Notifications
You must be signed in to change notification settings - Fork 0
Requirement Specification
Isabel Giang edited this page Apr 19, 2017
·
51 revisions
- Users cannot make accounts, and their data will not be recorded or stored
- All information provided to the users must be correct, or as correct as official sources: Roll20, D&D Player’s Handbook
- Users must be provided a clear and concise instructions for how to follow the prescribed leveling up process, which must be broken into the manageable steps, already separated in the book (D&D Player’s Handbook 5th Edition)
- Users must be able to determine the purpose and scope of Level - particularly that it does not support accounts or character data storage.
- Users must be able to easily determine and distinguish where and how Level and Class queries are made.
- Users must be able to click anywhere on the input form in order to be able to provide input (ex: text box, drop-down menu)
- Users must be able to find and select the class for their search query.
- Users must be able to deselect the class for their search query.
- Available classes must be sorted in increasing alphabetical order.
- The default state of the interface will select "Barbarian" - the first of the Dungeons & Dragons classes in alphabetical order - as a placeholder.
- Users must be able to find and select the level for their search query.
- Users must be able to deselect the level for their search query.
- Levels must be sorted in ascending order.
- The default state of the interface will select "Level 1" as a placeholder.
- Users must have a way to choose when to begin the level-up process
- Users must be able to determine how to begin the level-up process
- Users must only be able to navigate to the a new page if both class and level have been selected
- Users must have a clear understanding of what the different components (container providing information; reference to character sheet) of the reference pop-up window are
- All D&D and Gaming ‘Jargon Keywords’ - in other words, a concept, phrase or word that has a particular meaning or function within the Dungeons & Dragons universe that requires additional contextual information for novices or beginners - must have bold, green font to indicate that it is jargon and be clickable
- Clicking on jargon words must bring open the reference pop-up window.
- This window must accurately explain the concept of the jargon word in question
- This window must explicitly show where the user should look on their own character sheet to understand the jargon word in the context of their character sheet through some kind of visual indication that is easily understandable by the reader.
- This window must be able to close the Reference Pop-Up Window easily, after which they are returned to the screen from which they originated - where they clicked on the green word, without any changes to their progression through the app, the Level and Class choices that they made, or any other changes that would otherwise modify the displayed information in a way that does not reflect desired behavior.
Steps Overview
- Steps must follow a particular format and be ordered as follows:
-
Simple Increases
- Increase Hit Points
- Increase Proficiency (when applicable)
- Class Specific (when applicable [Barbarian, Monk, Rogue, Sorcerer])
-
Features
- Action Features (when applicable)
- Enhance Features (when applicable)
- Shape Features (when applicable)
- Update Features (when applicable)
-
Magic
- Increase Spell Slots (when applicable)
- Learn Spells, Cantrips, Incantations (when applicable)
-
Simple Increases
-
Subheaders
- On the top of each step page, users must be shown the Class and Level for which they are iterating through a level-up proces.
- On the top of each step page, users must be shown which Step they are on, both number and title, and the purpose of the Step, in terms of what information it provides (Ex: Step 1, Increase Hit Points)
-
Next and Back Buttons
- There must be a next button at the bottom right section of the page
- Upon clicking the next button, users must be taken to the next step, unless this step is the last (Step 1 to Step 2 / last step to Completed Page)
- There must be a back button at the bottom left section of the page
- Upon clicking the back button, users must be taken to the previous step, unless this step is the first (Step 4 to Step 3 / Step 1 to Homepage)
-
Progress Bar
- There must be a progress bar at the bottom of the page, filled to A/B, where A is the current step number, and B is the calculated number of steps this process includes for this specific Class and Level.
- User must be able to make a reasonable estimate of where they are in the level-up process from the filled progress in the progress bar.
- User's must be provided with correct, simple Hit Die instructions that give a clear indication of what they must to do calculate Hit Points for their character (Fighter, Step 1: roll a 1d10, then add your character’s constitution modifier)
- Users must be see a visual representation of the correct dice type for their character class (Fighter: illustration of a 10-sided dice)
- At the relevant levels, users must be provided with a Step that instructs them to increase their proficiency to +3 at Level 5, +4 at Level 9, +5 at Level 13, and +6 at Level 17
- Users must be able to determine which attributes the proficiency bonus applies to, which is variable depending on class.
- Users must be able to utilize Level for Dungeons & Dragons 5th Edition classes with specialized features that require a unique implementation.
- Barbarians must be provided with a specific Step to increase Rage and/or Rage Damage at Levels specified by the rules.
- Monks must be provided with specific Steps to increase Martial Arts, Ki Points, and Unarmored Movement at Levels specified by the rules.
- Rogues must be provided with a specific Step to increase Sneak Attack at Levels specified by the rules.
- Sorcerers must be provided with a specific Step to increase Sorcery Points at Levels specified by the rules.
- Users must be provided with all the features for their Level & Class, and the features for no other Levels and/or Classes.
- Users must be provided with Steps that provide instructions on how to add new or adjust old features for their character, as specified by the rules for each specific Class and Level.
- For updating existing Features, users must be shown the correct information for the given level and class. (Change Song of Rest from 1d6 at Level 2 to 1d8 at Level 9)
- Each Feature must have its own Step, which must be indicated by page separation.
- If a Feature has functions that are separate (in the sense that their functionality is not related to each other), this separation will be visually indicated by breaking up the container that hods the feature into multiple Steps.
- If a Feature includes displaying a list, each choice must be shown as a bullet point to avoid implying to the user that they must indicate their choices on Level's interface
- If Feature choices are long (too many and/or too lengthy to fit comfortably on a mobile web page), choices must be labeled, included description must be removed entirely, then be expandable in a Reference Pop-Up Window for full detail.
- If a character is gaining the magic of spellcasting for the first time, there must be a prominent region which shows their Spell Save Difficulty Class and their Spell Attack Modifier, with lots of Jargon Keywords
- Users must be informed as to which spell slots they have just gained, and have the ability to see what their total spell slots are.
- User's must be informed as to how many spells they are able to learn
- If the user’s character has the feature to replace existing spell, they must be prompted that they have that option.
- All possible spells must be shown, for their class and level (only from the Player’s Handbook)
- Spells must be expandable to show detailed effect, properties, constraints; all relevant and correct information as specified in the Handbook
- Once expanded to the Spell page, users must be able to return to the previous Step page with a back button.
- Spells must be sorted ascending by their spell level, then by alphabetical order, with the spell level sort taking precedence
- Users must be given a visual indication that level-up is complete, and that they have been provided with all of the information necessary to complete a level-up (“Congratulations! You are now a Level 5 Wizard”)
- Users must be able to return to the previous Step page with a back button
- Users must be able to return to the Home Page to iterate through the Level-Up process again, if desired