Hi Chris!
I would like to present a thought experiment for you. I can't finish the entire experiment in this email and will supply the rest in the coming days. Please know I am not saying this is the way things *should* be done, but to present a process which may prove to be quite powerful for all the documentation team, whether content creator, designer, programmer. If it isn't, then by all means don't adopt it. But I think you will like what I have to propose. Just hear me out and then discuss and we can go from there?
It seems that I was fairly close to what is defined at
http://docs.joomla.org/Doc_Campers_Start_Here
So let me present this and see what you all think. This process will not exclude what you have already done, but may help empower all involved as a means of communicating about very specific scenarios. Scenarios and goals help communicate. Implementations and features do not always shed light on what the user is trying to do.
Please check out these articles at cooper.com:
http://www.cooper.com/insights/journal_ ... nas_1.html
http://www.cooper.com/insights/journal_ ... _user.html
In fact I would recommend going through all the articles about personas at this website, but the above ones should be a good starting point for our purposes.
In particular it says:
"Write documentation in a way that helps your users achieve their goals, instead of simply cataloging all of the product's features."
For this exercise (and this is just for exploration, not to direct), I'm going to use my list of roles that I presented earlier:
- Joomla Developers
- Template Designers
- Extension Programmers
- Website Administrators
- Website Owners
- Content Creators
- Content Consumers
Now, let's translate these into personas!
Caveat: I don't pretend to know what all of these personas for Joomla tends to be like, so I'm completely making this up from thin air. Please feel free to change this as you see fit.
Personas are meant to be archetypes, they need not be exact, but they should be specific, although they should not be edge-cases. That is, even though they are specific, they are not alienating a number of other instances of personas within a similar role. Other personas may coincide with the same goals as the archetype, but perhaps for different reasons.
So let's go down the list:
================
Joomla Developer:
================
Chester is a 35-year-old programmer, he has a BS degree in comp sci and has worked for Honeywell for the past 5 years. He is well versed in these languages:
- Java
- PHP
- C/C++
- SQL
- javascript/HTML
He's a big believer in open source software and even though he may write proprietary code on his job, he likes to spend about 10 hours a week contributing to Joomla's code base. He is a part of the Joomla security team and is responsible for evaluating code and looking for security weaknesses.
Those ten hours he spends tends to look like this:
[fill in the blanks]
Chester needs access to Joomla documentation to see how other aspects of the code base works. He is most likely going to search on the following terms in the dev.joomla.org search field:
[fill in the blanks]
The most important GOALS for Chester in using Joomla documentation is:
[fill in the blanks]
The most important GOALS for Chester in writing Joomla documentation is:
[fill in the blanks]
Chester's most trying frustration with documentation in the past has been:
[fill in the blanks]
Chester would like to see the following things changed in the Joomla documentation:
[fill in the blanks]
================
Template Designer:
================
Kate is a 32-year-old web designer. She has a BA in fine arts and has had her own business in graphic design and web design for the past 10 years. Kate is fairly conversant in HTML and CSS and keeps up on cross-browser issues. She taught herself HTML and CSS and isn't afraid of looking at web page source code to discover new ways of designing with HTML/CSS. Kate loves the idea of using Joomla, because she isn't a programmer, and has no interest in learning how to program, although she can cut and paste javascripts into the head of her HTML files.
Kate recognizes that offering flat HTML websites are no longer a viable solution for many of the clients who hire her to create their websites. She is thrilled that Joomla offers interactive functionality for which she has no capability to program on her own.
Kate is quite keen to use Joomla, as it allows her to evaluate an extension before presenting it to a client. In the past, Kate has hired a few programmers who could never deliver what she needed. By using Joomla, she is able to bypass the anguish of hiring a programmer, and not knowing if the programmer will leave her in the lurch.
As intrepid as Kate is, she has had a hard time understanding how to set up a website once the basic Joomla package has been installed. She would like to see one-stop documentation on how to create her own templates at the Joomla documentation site, as well as how to use Joomla's admin backend. She would love to have a content creator tutorial she can direct her clients to so she doesn't have to spend a lot of time training them on how to use the CMS aspects of Joomla.
She likes the idea of having a vanilla template to design from so she customize it for different clients easily and quickly. Kate wishes she could find a forum on the site that is focused to web designers, just like there is a site on the forum for developers. Right now, she can only search keywords and often the search results are way off target for her needs.
Subsequently, she must spend hours trawling through the forums to get answers, which is monstrously frustrating to her. The vocabulary used in the forums is unfamiliar to Kate and appears to programmer-centric and intimidating. She doesn't know what OOP means, or what a class is unless that's referring to a CSS attribute. It's all so confusing to her.
Once working a little with the default Joomla package she discovers that the engine generates table code which is not W3 compliant, nor is it accessible. Kate has a regular contract with the Department of Health in her state and she must make sure that all her designs are Section 503 compliant, so site visitors with disabilities can access the content. She may lose her contract if she can't make the site available to voice readers that make the site content available to blind visitors. It's imperative that she be able to remove tables and have full control over the presentation of the site's content. But currently there is no documentation that shows her how to turn off tables.
(Little does Kate know, were she to dig long and hard enough that she would be able to turn off tables, but it means she must create template overrides. Kate does not know PHP and has no CLUE what a template override is.) Kate longs for parameters switches in the backend administration that would allow her to do something as simple as turn on or off tables.
When Kate visits the Joomla support sites, she is quite confused where to go find help and would like to see Joomla documentation meet her needs on how to get her job done as quickly as possible. This is her primary documentation "goal." She doesn't need information on how to write CSS or how to create a W3 compliant template. She can do that in her sleep. What she wants to do is understand how to insert classes and ids into the vanilla template so that she can have full control of the presentation of the website content.
She also wants to understand what modules, components and plugins are. Not how they are implemented or programmed, but what they can do to help her to organize her content or offer functionality to her client. She would also love to see different implementations of the same module or component so that she can understand different ways to use them. This is not available in the current Joomla documentation.
In addition, Kate desperately wants to be able to access the stylesheets for her modules and components all from the backend. She would prefer not to have to edit the stylesheet by hand everytime she wants to make a change. She would love it if her stylesheets were fed into a form in the administration backend where she could edit her style sheets, click "Preview" and see the change.
She is overwhelmed with all the code that comprises Joomla, and doesn't understand why there isn't an easier way to access stylesheets, like in Dreamweaver. It would be helpful if there were a Joomla user guide on how to use DW with Joomla, without fear of munging the code and breaking the entire code base.
It would benefit Kate if with every default and third-party component or module that she installed, there was a list of all the style declarations in the HTML included in the documentation of the extension so that she wouldn't have to hunt them all down by setting up the modules and then figuring out every configuration the code would generate so that when her client added content and changed parameters, her template wouldn't break (and make her look bad).
==================
Extension Programmer
==================
Ronin is a 41-year-old programmer. He works for KCP International, a Japanese Language School in Tokyo. He has a degree in computer science and has worked mostly as a network administrator during his working career. The KCP website team recently decided to use Joomla for their site's revamp. Ronin likes to write scripts and code here and there in his free time. He is interested in creating a Joomla component for coverting yen to other currencies so visitors to the KCP website can translate the cost of living in Tokyo into their native currency. The KCP web team would love to have such a component and have welcomed Ronin's contribution.
Ronin has researched the developer's forum at Joomla.org and is becoming acquainted with the Joomla community. One reason he is keen on Joomla is because of the emphasis in translation, as well as the international nature of the Joomla community.
---research for Ronin in progress....
I will continue with the other personas in this post asap, these being for the following roles:
- Website Administrators
- Website Owners
- Content Creators
- Content Consumers
More soon!