=== NarraFirma ===
Contributors: cfkurtz, pdfernhout
Plugin Name: NarraFirma
Plugin URI: https://www.narrafirma.com
Tags: stories, narrative, research, participation, community
Author URI: http://www.cfkurtz.com
Author: Cynthia Kurtz and Paul Fernhout
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DGVVDT2D49QA8
Requires at least: 4.3.1
Tested up to: 6.9.4
Stable tag: trunk
Version: 1.6.13
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Participatory Narrative Inquiry in a box. Gather stories and make sense of challenges and opportunities in your community or organization.

== Description ==

NarraFirma is companion software to the textbook [Working with Stories in Your Community Or Organization: Participatory Narrative Inquiry](http://www.workingwithstories.org).

Participatory Narrative Inquiry is a form of Participatory Action Research in which groups of people share and work with their stories of personal experiences to understand each other and to make collective sense of complex issues and situations. You can use it to help the people in your community or organization discover insights, catch emerging trends, make decisions, generate ideas, resolve conflicts, and connect people.

= What is NarraFirma? =

* It's a checklist. NarraFirma provides practical guidance as you work, with questions for you to answer, recommendations based on the conditions you describe, activities that help you make decisions, and just-in-time advice.

* It's a journal. NarraFirma helps you keep careful records about what happened in your project, and it gives you places to reflect on what happened. This reminds you to keep learning as you work, and it helps you to document your project for future reference.

* It's a kiosk. NarraFirma helps you collect stories, on-line and/or off-line, based on question forms you design (with sample questions you can copy). Because story collection is integrated, there is no need to export or import data.

* It's a workstation. NarraFirma helps you explore and interpret patterns in your data (stories and answers to questions about stories), creating annotated visualizations you can use to make sense of the stories you collected.

= Why choose NarraFirma? =

* It's portable. You can install NarraFirma anywhere, as a WordPress plugin or a Node.js web application. Web hosting is inexpensive, popular, and well supported. You can also install NarraFirma on your local computer and use it off-line. (Whichever installation method you choose, we strongly suggest that you set up SSL security on your web site before collecting or entering confidential or important information. Many hosting providers can help you with this task.) 

* It's a team player. With NarraFirma your team can work on projects together in real time without having to hand files back and forth. You can plan your project, collect stories, discover patterns, and reflect on what you've learned - together.

* It's an open book. NarraFirma is open source software. So if you have a question about how something works, you can just look at the source code to find out. If you need the software to do something it can't do, you can add new functionality yourself or ask someone else to add it.

* It works in the real world. One NarraFirma installation supports multiple projects, forms, data sets, and reports. Why? Because real-life story projects are rarely simple or predictable. So go ahead and make a mess. NarraFirma is ready for it.

== Installation ==

To install NarraFirma:

1. Download the NarraFirma plugin (in zip format) from WordPress.org or the [NarraFirma web site](narrafirma.com).
2. In your WordPress dashboard, click on "Plugins," then click "Add New." 
3. In the "Add Plugins" page, click "Upload Plugin."
4. Click "Browse," then choose the zip file you downloaded.
5. Click "Install Now."
6. Click "Activate."
7. You should see a new "NarraFirma" menu item in your dashboard menu. Click it.
8. In the screen that appears, create a new project and add some users who can access it.

Or you can install NarraFirma from the WordPress plugins directory:

1. In your WordPress installation, click "Plugins."
2. Click "Add New."
3. In the search box, type "narrafirma".
4. When NarraFirma appears, click "Install."
5. Click "Activate."
6. You should see a new "NarraFirma" menu item in your dashboard menu. Click it.
7. In the screen that appears, create a new project and add some users who can access it.

== Frequently Asked Questions ==

= Where can I found out more about Participatory Narrative Inquiry? =

Take a look at the book behind NarraFirma, [Working with Stories in Your Community Or Organization: Participatory Narrative Inquiry](http://www.workingwithstories.org)

= What should I do if I find a bug? =

Tell us about it on the [GitHub issues list](https://github.com/pdfernhout/narrafirma/issues).

= What about web security? =

We strongly suggest that you set up any web site on which you intend to install NarraFirma with SSL (secure sockets). Your hosting provider should be able to help you do that.

== Screenshots ==

Please note that these screenshots are out of date. The basic functionality of the software has not changed, but some of the pages look a little different now.

1. This is the main page of NarraFirma. The sections of the software (and the phases of PNI) are shown in the diagram. Clicking on any of these buttons  leads to that section.

2. This the main page for the NarraFirma planning section. Links to all the pages in that section are listed. You can enter reminders for any page; they show up on this page.

3. Here the NarraFirma user is describing the groups of people who will be participating in their project. Describing your groups helps you think about how you should collect stories and what you should do with them.

4. Here the NarraFirma user is doing a little sensemaking exercise based on some stories they told about what might happen when they do the project. Thinking in stories during project planning helps to make better decisions about how to carry out the project.

5. Here the NarraFirma user is deciding how they will collect stories. They are looking at recommendations the software is giving them based on the answers they gave to the questions about their participant groups (see screenshot 3). 

6. Here the NarraFirma user is creating questions they will ask people about their stories.

7. Here is the NarraFirma survey form participants see when they tell their stories (or NarraFirma users see when they enter the stories they collected off-line).

8. Here the NarraFirma user is looking at stories as they come in to the collection. They are looking here only at stories told by older people who said the person in their story wanted to be heard.

9. Here the user is looking at patterns in the data (answers to questions) collected. The selected row of the table of patterns (at the top) shows that the questions "How do you feel about this story" and "What is your age" are being compared, creating a contingency (bubble) graph. The user has written an observation about that pattern ("People under 35 more positive") and two interpretations of what that pattern might mean ("More weight on older shoulders" versus "Younger people have lots of energy"). The user has selected some stories on the graph to read; the stories appear in the table at the bottom of the image.

10. Here the NarraFirma user is designing a plan for a sensemaking session, where people will work with the collected stories and patterns to make sense of the topic being explored.

11. Here the NarraFirma user is ansewring questions about the outcomes of the project for each participant group. Those outcomes will determine recommendations for interventions.

12. Here the NarraFirma user is reflecting on the entire project, to learn from it and to keep good records for the future.

== Changelog ==

= 1.6.13 = 

* Changed: Fixed versioning mistake (in 1.6.12, forgot to update "tested up to" WordPress version).
* Changed: Updated GitHub readme description.

= 1.6.12 =

* Changed: Increased batch size of startup message loading from 100 to 1000. Should reduce errors due to rate limiting on WordPress servers.
* Changed: Updated home-page diagram to match new PNI-phases diagram in fourth edition of Working with Stories.
* Changed: Updated labels on "PNI planning questions" to match revised headings in fourth edition of WWS.
* Changed: To improve clarity, tweaked various elements of home page and section/phase pages (headers, icons, page names, etc). 
* Changed: Removed unnecessary and distracting title-attribute popup tooltips on some buttons, icons, and links.
* Changed: Replaced excerpts from the third edition of WWS with comparable excerpts from the fourth edition.

= 1.6.11 =

Added: On "Configure catalysis report" page, added options to hide story-count labels on bar graphs and histograms as well as on contingency tables
Added: On "Review graphs" page, story-count labels are now hidden by default (but there is a new checkbox to show them)
Changed: Stopped capitalizing graph titles (if you like them, check the blog for how to get them back)
Changed: Bolded axis name labels 
Changed: Changed "Count" on bar graphs to "Number of stories" 
Changed: In histogram and scatterplot sets, moved set answer names (e.g., Feel: happy) to above graphs 
Changed: Added fine gray lines around sub-graphs 
Changed: Increased sizes of all fonts on all graphs 
Changed: On "Configure catalysis report" page, changed "tables" label to "contingency tables" 
Changed: Increased default graph width to 900 pixels (because most laptops have better screen resolutions than they did 10 years ago)
Fixed: Bug with shrunken fonts in exported PNG graphs
Fixed: Bug where some graphs erroneously showed useless (and wrong) "n: 0" statistics message 

= 1.6.10 =

Added: On "Describe participant groups" page, questions to build a win-win proposal for each participant group.
Added: Debug page (in Project administration) that shows all project data (for easier problem solving).
Added: On "Translate story forms" page, additional operations (in "Do it" list) to rename or remove a language, systematically replacing or removing all related translations.
Changed: On "Translate story forms" page, improved counts of translated texts to include "hidden" translations (for languages that no longer appear in the "Additional languages" box).
Changed: On "Start story collection" page, improved descriptions of data conflicts (seen after clicking "Check for Data Conflicts").
Changed: Improved error message shown in console when question included in story form does not exist in project.
Changed: On "Build story forms" page, added "NOT FOUND in project" to question-choice listbox to alert user when included question does not exist in project (because it has been renamed or removed).
Changed: Updated text on Node.js site administration page.
Fixed: Bug (in WordPress version) in which choice questions with numerical answers caused mismatches between PHP and Javascript data formats (sorting algorithms have now been improved).
Fixed: Stopped trying to save to clipboard without checking that the context is secure (clipboard access is not allowed when page context is insecure).
Fixed: In WordPress version, added some missing PHP return statements in certain error conditions, which could have (theoretically) caused problems.
Fixed: Confusing error message when granting anonymous survey access without first having created an anonymous user id.
Fixed: Improved handling of situation in which question is null or missing during survey display and story collection.

= 1.6.9 =

Changed: Updated WordPress readme file to comply with WordPress requirements.

= 1.6.8 =

Changed: On the "Describe participant groups" page, added a notes field to each question category (about each group's status, ability, expectations, and feelings).

= 1.6.7 =

Changed: Made "Does not apply" slider label settable and translateable in general (not only for specific questions)

= 1.6.6 =

Added: You can now use display lumping to rename a too-long answer or put aside an answer that was rarely chosen (use with care and respect)
Added: In display lumping, you can comment out a line by placing a semicolon at the beginning of it (helps with trying different schemes)
Added: On the "Print story cards" page, you can now hide non-selected choice-question answers (instead of showing all answers)
Added: On the "Print story cards" page, you can enter a custom text to write between choice-question answers
Added: Printed story cards now have a pound/hashtag sign in front of the story number/index (to make it easier to search for a story by number)
Added: On the "Write annotation questions" page, you can now set the order of questions on the "Annotate stories" page (you can also add headers and choose which columns to display in the table of stories)
Added: On the "Explore patterns" page, added a button to export a (simplified) summary of significant correlations across all choice-question subsets (helps in pattern discovery)
Added: More template questions about participants

Changed: The "Spot-check graphs" page is now called the "Review graphs" page (and the introduction has been tweaked)
Changed: The main-page display of story collections is (hopefully) more intuitive (clicking on the number of stories now leads to the "Review incoming stories" page, and clicking on the number of answers now leads to the "Review graphs" page)
Changed: On the "Explore patterns" page, the export buttons have been moved to the top of the page (before they got in the way of writing observations)
Changed: The threshold for drawing extra-tall contingency charts has been reduced from 11+ to 8+ rows (for better clarity)
Changed: Improved formatting of printed session agendas (collection, sensemaking) and project presentation outline
Changed: Slightly improved wording of some of the page descriptions on section pages

Fixed: A bug where the "anything else?" label was forgotten when adding the story form translation system 
Fixed: A bug where the statistics information reported (in patterns table) was incorrect (in some relatively rare) situations)
Fixed: A bug on section pages (Planning, Collection, etc) where HTML elements from other pages were appearing on top of the little page-type icons
Fixed: A bug on the "Spot check graphs" (now "Review graphs") page where making a selection in one subgraph did not remove a previous selection in another subgraph
Fixed: A bug on the "Annotate stories" page where adding the first answer to a choice question also added an empty-string answer
Fixed: A bug where clicking on the number of stories in a collection on the main/dashboard page did not bring up that collection on the "Review graphs" page
Fixed: A bug where certain carriage-return characters within stories would cause the CSV export to misalign spreadsheet cells 
Fixed: A bug where, in CSV story import, there was no backup default for a missing multi-choice single-column delimiter (it now defaults to a comma)

= 1.6.5 =

Fixed: Bug where code to update legacy data with missing remarkable flags was setting extra flags as well (only affected projects created before v1.4.0)
Fixed: Added explanation of circle colors in clustering during catalysis

= 1.6.4 =

Added: Catalysis option to hide patterns that don't include at least one question asked about stories
Changed: Clarified a few things on the Project admin / Import & Export page 
Fixed: Bug in WordPress version where resetting a project more than once would produce an error
Fixed: Bug where a forward slash in a question's short name would cause the data collected for that question to be invisible (now slashes are not allowed)
Fixed: Bug where story cards html page had title with long messy id instead of short name
Fixed: Bug in csv import that would cause an error (in NF, not in the console) if a data column name was not described in the story form file
Fixed: Bug in csv import where slider with non-default "does not apply" label was being read incorrectly

= 1.6.3 =

Added: Buttons to export all graphs and statistics displayed on "Explore patterns" page (without regard to observations)
Fixed: Bug that was slowing down display of graphs on "Explore patterns" page
Fixed: Bug where more than one forward slash in a question or answer name created spurious subfolders in zipped images

= 1.6.2 =

Added: Option when printing catalysis reports to save observations and interpretations to simple CSV file
Added: Texts below graphs explaining that you can click and drag in the graph to select stories (this is not obvious)
Added: On "Explore patterns" page, new "things you can do" option to show survey questions for selected pattern
Fixed: Bug where you might have seen a "pattern is null" message on the "Explore patterns" page
Fixed: Bug where not enough space was being allocated to upper-right labels in table (contingency chart) images

= 1.6.1 =

Fixed: Bug (introduced in last update) that made it impossible to create the first story collection in a project
Fixed: Several bugs related to multi-user data conflicts
Fixed: Bug where leading/trailing white-space characters were allowed in fixed-answer lists, but display lumping and filtering systems assumed none

= 1.6.0 =

Added: Duplicate button to make copies of most items in lists
Added: Data conflict check when updating "snapshot" story form in story collection (to avoid confusion and data loss)
Added: More buttons providing quick access to relevant help pages
Added: On "Spot-check graphs" page, ability to show stories from multiple collections at once
Added: Copy-to-clipboard button on all popup text dialogs
Added: Option to print story cards in multiple columns
Changed: Removed annoying "Please click the close button" popup (by improving data-entry validation system)
Changed: Made "Start story collection" page easier to use and understand
Changed: Improved help on updating "snaphot" story forms in existing collections
Fixed: Made survey text question responsive to screen size (multiplying specified percent width by 4x on mobile, 3x on tablets, 2x on laptops)
Fixed: Bug where special character in survey URL caused link on "Start story collection" page to not work
Fixed: Bug where radio-button or boolean answer showed only on last story entered on form (though data was correctly stored)

= 1.5.24 =

Fixed: Bug where stories appeared out of order in survey form. 

= 1.5.23 = 

Fixed: Bug I thought I had fixed long ago, in the "chooser" boxes where you add questions to a story form. Showing the question texts broke the associations. Removed them.

= 1.5.22 =

Fixed: I forgot to save one file (package.json) with the new version number in the previous release. That's all.

= 1.5.21 =

Added: Import option for multi-choice delimited questions with write-in answers in the same column.
Added: On "Write questions about stories/participants" pages, when import options are showing, button to directly access import guide.
Added: On "Start story collection" page, button to directly access help on what can be changed in a story form linked to a non-empty story collection.
Changed: Improved import guide and help on updating story forms.

= 1.5.20 =

Added: Spot-check graphs page now has buttons to show selected stories (or random sample) in pop-up window for copying and pasting elsewhere.
Added: Spot-check graphs page can now show answers to questions about stories (in a simple format) for copying and pasting elsewhere.
Added: Additional warnings to alert the user of read-only mode, in case they edit fields without realizing they are not logged in to an account with editing privileges.

= 1.5.19 =

Added: Icons that show the actitivies on each page (manage, plan, enter, review, journal, export). Can be turned off in project options.
Added: Tips at the bottom of the screen. Can be turned off in project options.
Added: Page (in Planning) to help you observe and reflect on a story-sharing conversation.
Added: Page (in Planning) to help you build and print a project privacy policy. 
Added: Journaling pages for reflections at the end of each project phase.
Added: In Planning, added a few more questions about participant groups (these new questions are not linked to the recommendations system).
Fixed: Bug where a question type was being erroneously required for elicitation questions. (It exists there but is not important.)

= 1.5.18 =

Added: Validation check to make sure that all questions have types.
Added: Validation check to make sure that questions of types that require answer lists (select, radiobuttons, checkboxes) have answer lists. 
Added: For validation support, if you are editing a list item and you click a page-change button, a message will appear asking you to close the currently open item first. (NF needs you to do this so it can run its validation checks.)
Added: Global error pop-up that shows the same message as is posted to the development console (for those who don't know about or can't find the development console).
Changed: Improved error reporting when questions that should have but are missing answer lists are imported from CSV.
Changed: Improved error message in survey itself when a question that requires an answer list has no answer list. 
Changed: NF's HTML cleanup process has always interpreted a single angle bracket (<) as the start of an HTML tag (and showed an error if there is no closing bracket). This is a problem for texts like "<25" (an age bracket). Now NF just prints out the < and lets you figure out if it's an incomplete HTML tag. 

= 1.5.17 =

Fixed: Broken link on several help pages.

= 1.5.16 =

Added: Icons for (nearly) every button.
Changed: Simplified header at top of all pages.
Changed: Simplified and reorganized all section pages (Planning, Collection, etc).
Changed: Removed View and Edit buttons under all "GridWithItemPanel" list tables. Now all items in lists can be edited live, without separate view-only step.
Changed: Renamed "Design, generate, or import story forms" page to "Build story forms."
Changed: When editing story forms, can now see question texts as well as short names.
Changed: Improved validation of short-name fields in questions (eliciting, about stories, about participants, annotation), story forms, story collections, and catalysis reports.
Fixed: Bug where activity lists in printed agendas for story-collecting sessions and sensemaking sessions were not properly sorted.
Fixed: Error where survey introduction text did not wrap correctly.

= 1.5.15 =

Changed: Dealt more gracefully with situation in which multi-choice question (checkboxes) was changed to single-choice question (select) after data was collected. Was choking on wrong data type during story export.

= 1.5.14 =

Fixed: Bug in printing story cards where story-form question-answers were not appearing.

= 1.5.13 =

Fixed: Bug where choose-questions-for-story-form widget was not matching up questions correctly if question short names had extra (leading or trailing) blank spaces. (Now any extra blank spaces are trimmed off.)
Fixed: Bug where extra (empty) lines in choice-question available-answers lists were creating malformed survey HTML, causing the error "Something went wrong loading the survey questionnaire from the server." (Blank lines are now being trimmed out correctly.) 

= 1.5.12 =

Fixed: Bug where the texts of edited stories did not appear correctly in the "Show story texts for copying" popup window on the "Explore Patterns" page.
Fixed: Bug where annotations might not match existing stories correctly during import and bulk changes.

= 1.5.11 = 

Fixed: Improved error handling for empty (no-name) questions. Was choking on them during export.

= 1.5.10 =

Fixed: Bug where write-in answers were missing from the display of submitted stories and answers (which survey-takers can use to save a local copy of what they said).

= 1.5.9 =

Added: Brief introductory text (with link to WWS book) to home page
Added: Section links to home page (on right, below story collections table, for better accessibility) 
Changed: Moved page descriptions from popup tooltips to texts below page links; shown by default but can be turned off in project admin options
Changed: Improved page descriptions to explain what each page is for and why you would want to use it
Changed: Section pages (Planning, Collection, etc) now start with graphical icons that echo the home-page diagram (better continuity)
Changed: Hid upper-right page navigation buttons (previous, next) in situations in which they had been disabled (gray)
Changed: Made all links have a highlighted box when hovered over (for better accessibility)
Changed: Consolidated all color designations in main CSS file into CSS vars (to make it easier to tweak colors)
Changed: Tweaked some colors to make interface a bit calmer
Changed: Removed hard-coded copy of CSS definitions for SVG-PNG conversion (now read directly from DOM); should reduce errors while changing CSS
Changed: Default font from "Arial, Helvetica" to "Helvetica, Arial" (looks better?)
Fixed: "Explore patterns" page now handles legacy case where observation exists but "remarkable" flag is not set
Fixed: Bug where version number was not updated in place that makes correct version appear on Project admininstration page

= 1.5.8 =

Added: Bulk annotation import from CSV file
Fixed: Bug where question links to new story form were not being correctly created (causing it to be impossible to add questions to form)
Fixed: Formatting mistakes in help system

= 1.5.7 =

Changed: In Node.js version, added logout link to choose-project page
Fixed: Bug (in WordPress version only) where setting and then deleting read-access permission role/id would allow anonymous read permission

= 1.5.6 =

Changed: Added "start here" label to home-page diagram, so beginners have a hint at what to click on first
Changed: Revamped help system to (a) clarify interactions between pages and (b) add previous-next links between help pages
Changed: In story cards, added bold tags so word processors will show selected answers even if style information is lost
Changed: While looking at stories in "Review incoming stories" can now see raw JSON story data
Fixed: Bug where survey could refuse to save story because it seemed to have no name (though it did)
Fixed: Bug where question name with leading or trailing space did not match choice made in story form (now extra spaces are trimmed out)
Fixed: Bug where "Active on web?" column on "Start story collection" page showed "checked" for all story collections (instead of yes or no)
Fixed: Bug where instructions on "Create project story elements" page were out of synch with changed clustering-diagram interface

= 1.5.5 =

Fixed: Critical bug in WordPress PHP code that could cause new NarraFirma installations to show a blank screen instead of the setup page

= 1.5.4 =

Fixed: Small bug in display lumping code that could cause a lumped count to be off when somebody chose and then un-chose an answer

= 1.5.3 =

Added: Option to set custom graph height as well as width

= 1.5.2 = 

Changed: Improved usability of clustering interface (used in planning and catalysis)
Fixed: Improved error message when JSON was expected but HTML was received (the HTML could be an error message; now it is shown)
Fixed: Small (probably invisible) bug where id for write-in fields was not given story id prefix

= 1.5.1 = 

Fixed: Bug where catalysis report graphs did not print (list comparison was set backwards, sorry)

= 1.5.0 =

Added (survey): Multi-lingual surveys (partipant can choose language; choice is saved for graphing)
Added (survey): Option to embed introductory video (streaming or mp4)
Added (survey): Story collection date question (generated or imported)
Added (survey): For all question types, option to allow write-in answer (for "other" answers or follow-up questions)
Added (survey): For "select" question type, option to show full list box instead of drop-down list 
Added (survey): For "select" question type, option to set no-choice text (e.g., "-- select --")
Added (survey): For "boolean" question type, option to set yes/no texts
Added (survey): For "text" question type, option to set width of textbox (in percentage units)
Added (survey): For "radio buttons" and "check boxes" question types, option to include image links to show below answers

Added (catalysis): Ability to change annotation questions while answering them (to build answer lists that emerge from reading stories)
Added (catalysis): Templates for annotation questions
Added (catalysis, sensemaking): Real-time display lumping (merging of similar answers) in catalysis graphs and statistics
Added (catalysis, sensemaking): Ability to filter stories by story length
Added (catalysis, sensemaking): Ability to filter stories by searching for specific pieces of text

Added (usability): Option to set project nickname, which shows on pages and reports within project
Added (usability): Buttons to hide or show advanced and import options for questions, story forms, observations
Added (usability): Improved text-box widths throughout the pages, so shorter texts have shorter text boxes
Added (usability): Better explanation/labeling of cluster order in catalysis clustering
Added (usability): Ability to "archive" (hide) WordPress projects

Changed (catalysis): Moved annotation facility from collection to catalysis; improved annotation process
Changed (usability): Added "choosers" to improve process of adding questions to story forms and changing question order
Changed (usability): Shortened length of text boxes for shorter entry fields (e.g., names, labels)
Changed (usability): Reduced number of entry fields that appear in situations where they don't apply
Changed (usability): Application now checks that your question short name is unique (instead of asking you to check it yourself)
Changed (usability): Navigation buttons now say "Previous page" and "Next page" (to make it more clear that you are going to a page, not doing something)
Changed (usability): Revamped WordPress launch/options page 
Changed (stability): Changed almost all "var" variables to "const" or "let" variables

Fixed (catalysis): Bug where missing custom graph size for catalysis report could result in printed graphs with zero height
Fixed (catalysis): Bug where no-answer answers for boolean and checkbox questions were being graphed as no or false instead of no-answer
Fixed (sensemaking): Bug where generated questions (e.g., Eliciting question) still appeared in story cards when their check boxes were unchecked
Fixed (sensemaking): Bug where story filter with && combination did not work when printing story cards
Fixed (usability): Issue where last few lines of home-page right-side links could pop over to bottom left
Fixed (usability): Many small CSS element spacing awkwardnesses
Fixed (stability): Bug where application did not load under WordPress when installed on Bedrock server
Fixed (stability): Updated Mann-Whitney U test for two improvements in scipy code from which it was derived

To read about previous changes, see the NarraFirma blog.

== Upgrade Notice ==

= 1.6.13 =

This minor upgrade fixes a versioning mistake and updates the GitHub readme page.

= 1.6.12 =

This minor upgrade improves page loading, clarifies the home and section pages, and updates NF to better match the new WWS books.

= 1.6.11 =

This minor (but visible) upgrade makes several changes to the formatting of various graphs for better readability. 

= 1.6.10 =

This minor upgrade adds win-win proposal questions to the "Describe participant groups" page, improves the translation page, and fixes some edge-case bugs.

= 1.6.9 =

This minor upgrade updates the WordPress readme file to comply with WordPress requirements.

= 1.6.8 = 

Ths minor upgrade adds fields for open-ended notes on each category of questions about participant groups.

= 1.6.7 =

This minor upgrade adds a bit more functionality to the story-form building and translation facility.

= 1.6.6 =

This minor upgrade adds some useful functions and fixes some small bugs.

= 1.6.5 =

This minor upgrade fixes a little bug that applies to older projects.

= 1.6.4 =

This minor upgrade adds a viewing option for catalysis and fixes several small bugs.

= 1.6.3 =

This minor upgrade adds bulk graph export and fixes a few bugs.

= 1.6.2 =

This minor upgrade adds a few quality-of-life options and fixes a few small bugs.

= 1.6.1 =

This essential upgrade fixes bugs related to creating story collections, managing multi-user interactions, and using display lumping.

= 1.6.0 =

This major upgrade improves handling of data conflicts, adds item duplication and multi-column story cards, and removes the horrid "Please click the close button" popup.

= 1.5.24 =

This essential upgrade fixes a bug in which stories are shown out of order on the survey form.

= 1.5.23 = 

This essential upgrade fixes a bug I thought I had fixed a long time ago. I stupidly thought it would be nice if, when adding questions to a story form, you could see the long as well as short names. Doing this broke the assignments. I thought I had fixed the problem! I hadn't. Now it is fixed.

= 1.5.22 =

This minor upgrade just fixes a non-matching release number in one place. That's all.

= 1.5.21 =

This minor upgrade adds a new import option (for multi-choice data with intermingled write-in answers) and improves help for data import and changes to story forms.

= 1.5.20 =

This minor upgrade adds two things: more noticeable warnings when you have read-only access to a project; and a bit more information on the "spot-check graphs" page.

= 1.5.19 =

This minor upgrade adds more note-taking pages and improves the new-user experience with page-type icons and tips.

= 1.5.18 =

This minor upgrade helps NF deal more gracefully with information users sometimes forget to provide. It also improves general error reporting.

= 1.5.17 =

This tiny upgrade fixes several broken links on help pages.

= 1.5.16 =
This minor upgrade makes many small improvements to clarity and usability.

= 1.5.15 =
This minor upgrade deals more gracefully with a situation in which a multi-choice question (checkboxes) was changed to a single-choice question (select) after data was collected.

= 1.5.14 =
This minor upgrade fixes a bug in printing story cards where story-form question-answers were not appearing.

= 1.5.13 =
This minor upgrade fixes two tiny bugs you might have run into if you had extra (blank) leading or trailing spaces in your question short names, or if you had extra (empty) lines in your available-answers lists. NF now deals more elegantly with both situations.

= 1.5.12 =
This minor upgrade fixes two bugs: (a) the texts of edited stories did not appear correctly in the "Show story texts for copying" popup on the "Explore Patterns" page, and (b) annotation import and bulk change might not work correctly for edited stories.

= 1.5.11 =
This tiny upgrade improves error handling for empty (no-name) questions. The application was choking on them during export.

= 1.5.10 =
This minor upgrade fixes a small bug in which write-in survey answers were being left out of the "this is what you said" copy-and-paste display.

= 1.5.9 =
This minor "clarity" upgrade makes various small improvements to page descriptions, links, buttons, colors, and fonts. (Note: If you do not like the new page descriptions, you can hide them on the project options screen.)

= 1.5.8 =
This minor but (yes, again) critical upgrade fixes a bug where the buttons to add questions to a newly created story form did not work. It also adds CSV import for annotations.

= 1.5.7 =
This minor but critical upgrade fixes a bug (in the WordPress version of NF only) where entering and then deleting a user id or role in the "read access" field for a project caused NF to allow anonymous users to view project pages.

= 1.5.6 =
This minor but critical upgrade fixes a bug where the survey erroneously believed entered stories had no names. It also fixes a few smaller bugs and improves the help system.

= 1.5.5 =
This minor but critical upgrade fixes a bug in the WordPress PHP code that could cause new NarraFirma installations to show a blank screen instead of the setup page.

= 1.5.4 = 
This minor upgrade fixes a small bug in the display lumping system. (A lumped count could be off when somebody chose and then un-chose an answer.)

= 1.5.3 =
This minor upgrade adds the option to set the catalysis graph height as well as width (onscreen and in the printed report).

= 1.5.2 =
This minor upgrade makes the clustering process (used in planning and catalysis) a little easier. It also fixes a few small bugs.

= 1.5.1 = 
This minor upgrade fixes one tiny but important bug (catalysis report graphs did not print).

= 1.5.0 =
This major upgrade adds new features for surveying (e.g., write-in answers, multi-lingual surveys) and catalysis (e.g., display lumping, better support for qualitative analysis).

= 1.4.2 =
This minor upgrade makes some usability changes, improves survey usability and accessibility, and fixes a few small bugs. 
 
= 1.4.1 =
This minor upgrade fixes a bug in contingency diagram drawing, plus a few other small fixes.

= 1.4.0 =
This somewhat-major upgrade adds a new type of graph (correlation map) and makes several process/workflow improvements to the catalysis process.

= 1.3.3 =
This minor update provides a few more usability and capability improvements for the catalysis process.

= 1.3.2 =
This is a quick fix for a bug that causes SVG files not to be saved to a ZIP file.

= 1.3.1 = 
This tiny upgrade fixes one nagging problem with the drawing of count labels on contingency charts.

= 1.3.0 =
This major upgrade improves the catalysis process, with many improvements to the interface, graphs, and report creation.

= 1.2.6 =
This critical upgrade fixes a longstanding bug we just noticed in how histograms are drawn. We apologize for never having noticed this before.

= 1.2.5 =
This minor upgrade adds a few more options for narrative catalysis.

= 1.2.4 =
This upgrade improves support for narrative catalysis. It adds several features that help you go through the process more easily.

= 1.2.3 = 
This is a critical upgrade. Please apply it right away. It fixes a bug we introduced in version 1.2.0, in which exporting a project snapshot "with stories" did not actually export any stories. We apologize for the mistake. There is also a fix for a bug in the Mann-Whitney U test (some blank values were being erroneously counted). The update also improves error handling for projects with large numbers of questions.

= 1.2.2 = 
This minor upgrade copies a few buttons (important to importing data) to some more useful places. It also fixes a few annoying bugs.

= 1.2.1 =
This minor upgrade adds the option to graph multi-choice questions against themselves, to look for patterns in coincidences of answers. It also improves a few visual details and fixes a bug in the observations-only catalysis report.

= 1.2.0 =
This higly recommended upgrade improves catalysis reports and story cards, and provides many more import options. It also includes many usability improvements and small bug fixes. 

= 1.1.0 = 
This upgrade adds two new ways to get your data out of NarraFirma: in the survey, a summary of submitted stories participants can copy and keep; and in the application, an HTML project report that summarizes everything you typed into NarraFirma (for use in other software).

= 1.0.2 =
This minor upgrade improves your ability to control messages in the story form (especially useful for non-English surveys). It also adds a "notes" fields to each question, so you can keep track of your reasons to use particular questions.

= 1.0.1 = 
This upgrade fixes a small bug in the NarraFirma interface. It also improves the screenshots shown in the WordPress plugins directory.

= 1.0.0 =
This highly recommended upgrade improves customization of surveys and reports, plus better support for narrative catalysis (finding and exploring patterns). It also includes many usability improvements and small bug fixes. 


== Donations ==

We have spent a lot of time developing NarraFirma. We appreciate donations, and will use them to keep working on it. You can donate at [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DGVVDT2D49QA8).

== Need some help? ==

I offer training in the use of NarraFirma and consulting for PNI projects. If you are interested, check out my web site at [cfkurtz.com](cfkurtz.com), or send me a note at cfkurtz at cfkurtz dot com.

