Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page Properties


Type
Status
subtletrue
colourGreen
titleImprovement
Target release2/7/18
Product Jira 
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-886
Product ownerMegan Brehman (Unlicensed)
UX/UI designerMegan Brehman (Unlicensed)
Developer ApprovalEnrique Ponce de Leon
QA Approved
Editions


...

Table of Contents
maxLevel3
minLevel2


PHASE 1: VALIDATION 


GOALS

What problem are we trying to solve? 

...

  • Users said it looked like an external product 

What’s the goal of this improvement?

The goal of this improvement is to clean up the UI so it matches the standard ProcessMaker Designer UI. 

RESEARCH


Review analytics to validate assumptions. Conduct research to understand why we should develop the feature.

USERCUSTOMEREXAMPLES
DavidIntermétrica
PatricioIntermétrica
  • It should work the same as designer - consistency.

  • A part of the platform, not an add-on made by someone else - integrated.

OmarTelefonica
EberhardTHOMSON REUTERS


These UI changes are also important according to the 10 Heuristics of Usability Framework. 

  • Consistency and Standards
    • Description: Oh, I know that! Is the content of the system consistent? Always make sure that your system has continuity across your platform.
    • Insight: Plugin should act like it's part of the PM platform. Users expect it to have the same look and functionality as PM platform.
    • Examples:
      • Not consistent with PM
      • Plugin looks generic, designer vs. EasyDoc
      • No blue bar, no right click or auto-save (expect to have it), different formatting toolbar
  • Aesthetic and minimalist design
    • Description: Does the system have too much information? Dialogues should not contain irrelevant information. Always make sure your system is aethetically pleasing and efficiently composed.
    • Insight: UI needs to be simplified.
    • Examples: Settings button, scroll bars, designer/ designer, new section options, messy text, overlapping text, align on bar and dropdown

What’s the priority for this feature— why is it more important than others?

The priority for this improvement is critical. 

What does this feature do? (this is applicable only to new features)

N/A

Who is this feature for? How many users will benefit?

Survey and usability testing participants agreed that Process Documenter would benefit anyone using ProcessMaker.

How does it improve the product? How does it relate to our overall product strategy?

It improves the UI and increases the user's ability to understand the tool.  

What technical, business or user assumptions are we making?

  • Technical: We're assuming that we know the best way to improve the functionality. 
  • Business: We're assuming that this matters from a business persceptive.
  • User: We're assuming that other users will feel the same way.



*** IMPORTANT: Feature must be validated before moving forward ***


PHASE 2: REQUIREMENTS


#REQUIREMENTTYPEPriorityDESCRIPTION
1User-friendly/ intuitiveFunctional Critical

UI makes sense to the user 

2Help and documentationFunctional

Critical

Does the system have an easy to access help section? 

3Match between system and the real world FunctionalCriticalDoes the user understand the language of the system? What are you talking about?
4Consistency and standards FunctionalCriticalIs the content of the system consistent? Always make sure that your system has continuity across your platform.
5Recognition or recallFunctionalCriticalYou want the user's brain to do less work. Recognizing something requires less work than recalling something. Making objects, actions and options more visible.
6Aesthetic and minimalist designFunctionalCriticalDoes the system have too much information? Dialogues should not contain irrelevant information. Always make sure your system is aethetically pleasing and efficiently composed.


USER PERSONAS

All ProcessMaker users - see above survey responses 

...


#

TITLEUSER STORYPRIORITY
1Have Process Documenter UI interface consistentAs a Business User, I want the Process Documenter interface to be consistent with the ProcessMaker Core interface, so that I feel it is part of the enterprise features/plugins.
2Improve new section creationAs a Business User, I want to see only the necessary fields when I'm creating a new section so that I can easily create it.
3
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-872
As a Business User, I want the interface to be clean so that I can easily find what I'm looking for. Major
4
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-873
As a Business User, I want everything on the interface to have a purpose so that it is straightforward.  Major
5
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-874
As a Business User, I want everything on the interface to have a purpose so that I know what functionality is available. Major
6
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-875
As a Business User, I want titles to be clear and district from the content so that I can quickly understand what is going on.  Major
7
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-876
As a Business User, I want grammar to be correct so that the interface looks professional.  Major
8
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-877
As a Business User, I want wording to be correct so that I understand what I'm reading. Minor
9
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-878
As a Business User, I want to quickly find the button to make changes so that I can be efficient with my time. Critical
10
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-879
As a Business User, I only want to see tools are easy to understand so that I feel confident in what I'm doing.  Major
11
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-880
As a Business User, I want buttons to be in order so that I can easily navigate back to the Designer or forward to the Preview. Minor
12
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-881
As a Business User, I want the labels to make sense so that my options are clear.  Minor
13
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-882
As a Business User, I want all heading words to be capitalized so that everything is consistent.  Major
14
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-883
As a Business User, I want things to be called what they normally are so that I recognize it. Critical
15
Jira Legacy
serverSystem JIRA
serverIda61eec73-2ffd-3943-ab40-4d6f93d4c28e
keyPROD-884
As a Business User, I want the button to be the same name as the plugin so that it's consistent.  Critical


PHASE 3: DESIGN + REVIEW


UI SPECIFICATIONS + MOCKUPS

...

New Section Pop-up User States  

Blank state - when a user opens the pop-up and before they choose an option. Change 'Scope' to 'Applies to.' Delete 'Choose an option' and make 'This Element Only' the default state.

After a user types in a name, the user scrolls over 'This Element Only' to open the dropdown. When the dropdown opens, a white checkmark and blue bar appear over 'This Element Only.'

The blue bar moves with the mouse when a user scrolls down over the other options. The checkmark next to 'This Element Only' darkens since it is the default state. When a user clicks on 'All Process Elements' with the blue bar, the dropdown closes. 

'All Process Elements' stays as the chosen option - before it was 'This Element Only.' If the user reopens the dropdown, 'All Process Elements' will have a blue bar with a white checkmark. 

When a user scrolls the blue bar over 'Some Elements' and clicks on it, a checkmark will appear - like the other options above. A list below will also appear for the user to check off which Elements they would like to include. 

 

MOCKUPS                                  

Jira TICKET


(insert mockups)


REVIEW STATUS



STAKEHOLDER APPROVAL




RISKS + QUESTIONS

We need to be aware of any significant, known risks that the project faces. I.e. Are there business requirements unrelated to how the software functions? Do the developers need to take any special parameters into consideration? Is the feature going to be formally announced and if so, when should we engage marketing?


#QUESTIONREPORTERRESOLUTION
1



WHAT WE'RE NOT DOING + FUTURE IDEAS

We also want to detail what this feature does NOT do. This helps us make sure we're considering every aspect. Here we can also capture ideas for the future and how the feature might evolve.

We are not making larger, more structural changes at this point- unless they are simple to do. Examples include: auto-save, right click, changing formatting bar to Designer formatting bar.

...

  • Hide/ Unhide - provide explanation/ add tooltip
  • Add document versioning
  • Add element properties to the document
  • Ability to upload images
  • Display customized attributes displayed in the map
  • Indicate if a process has an attachment


METRICS

How do we measure success? What metrics do we need to instrument and track? We need to put proper tracking in place upfront to measure the outcome of our feature. Unless we know exactly what our users are doing, we won't know how to improve. 

List 3 main questions. These will also be our key metrics — to help us understand how our feature or improvement is doing.


#QUESTIONMETRICOUTCOME
1


2


3