Contents contributed and discussions participated by Jason Owen
Lightweight DITA SC | OASIS - 0 views
Learning Lightweight DITA Live - YouTube - 0 views
DITA Community Resources - 1 views
List of DITA Optimized Editors - 0 views
Why DITA, especially "for the Web?" | DITA per Day - 1 views
-
Content that is personalized, easily found, appropriately scoped, and pleasant to interact with has a name: Adaptive Content
-
content should adapt to the reader as well as to the device.
-
Among its high points for alignment with direct-to-Web content delivery solutions, DITA provides: Close affinity to Web page writing conventions and length Intentional similarity of inner content markup names (p, ul, ol, dl, etc.) A close match in its title, short description, and body structure to the way most Web CMS tools manage their content. Maps that work so very well for representing collections of content.
- ...1 more annotation...
Minimalism Revisited: An Interview with John Carroll - 0 views
-
people need to act, they need to be engaged
-
they need to struggle
-
The minimalist idea, the way I think of it, is to minimize the extent to which the system and the information get in the way of what the user’s really interested in.
- ...5 more annotations...
Mobile DITA - 1 views
WritersUA - DITA Tutorials - 1 views
No Information Model is Forever - 0 views
-
Each organization has an obligation to reinforce sound technical communication or similar principles by constraining their models. Groups that foster a "free-for-all" by telling writers to use their DITA tools any way they like are actually fostering chaos.
DITA-related Software Tools - 0 views
Minimalism Updated 2012 - 1 views
-
Four Principles of Minimalism Principle One—Focus on an action-oriented approach Principle Two—Ensure you understand the users' world Principle Three—Recognize the importance of troubleshooting information Principle Four—Ensure that users can find the information they need
-
Even when individuals seek to understand how a product works, they intend to use that information to accomplish a task. For that reason, information developers provide procedures in documentation. The more effectively these procedures address real tasks that people want to perform, the more successful they are in meeting user needs.
-
Too often, information developers, isolated from understanding their users, try to compensate by explaining the product interface, leaving the user to figure out how to get results alone.
- ...1 more annotation...
A Task is Not a Procedure | Every Page is Page One - 0 views
-
A task is something a user has to do, a goal they want to attain. A procedure is a set of instructions for manipulating a machine. Manipulating the machine is never the user’s goal in itself. Manipulating the machine may be one of the things the user has to do to accomplish their task, but it is not the task itself. A procedure, therefore, may be part of a task topic, but it is not a task topic in itself.
-
This is what topic-based writing and task topic types should be about, therefore: creating topics that function for the user by consistently and reliably enabling them to accomplish the whole of their real-world tasks. This is about a great deal more than procedures, and there is a great deal more at stake than reuse.