Skip to main content

Home/ DITA XML/ Contents contributed and discussions participated by Jason Owen

Contents contributed and discussions participated by Jason Owen

1More

DITA Community Resources - 1 views

  •  
    Samples for DITA files and plugins.
4More

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...
  • On the minus side, HTML content models have evolved well past the internal models that DITA assimilated in 1999, which causes these limitations: Web authors often organize content in patterns that DITA’s content model won’t allow. You can’t always author in DITA “as if it were HTML.” HTML5 has added elements for which there are no equivalent base forms in DITA. Normally, domain specialization in DITA can help rectify this mismatch, but because HTML5 is a “Living Standard” and can add or drop elements as it evolves, an ongoing tension remains between the two formats. Entering values for DITA’s various metadata structures is perhaps harder than it should be for light editing environments.
9More

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...
  • the impulse to end up with Louis XIV, with decoration, and extras, and so forth, is something you always have to struggle against.
  • do like the term “learner.” “User” is passive, to me—you’ve been handed something, use it—whereas I think what people are doing is much more actively a matter of ownership and appropriation and coming to control a new tool in a new environment. And it is a matter of learning. It’s a matter of problem-solving. Besides being cumbersomely long—you could call them “problem-solvers….”
  • eally just a fundamental truth about learning. People need to act. We are, after all, talking about skill learning. We’re not talking about pondering abstract concepts or definitions or conceptual information, declarative information. It’s mostly skill learning and you learn skills by doing.
  • I would say that brevity is more a consequence of minimalism than a principle of minimalism. If you go back to what I was saying earlier about trying to facilitate the learner’s initiative and goals and aspirations and impede them less, you will most likely end up with a briefer design, or it might be layered. I was alluding earlier to David Farkas’s contribution to minimalism in the book Beyond the Nurnberg Funnel which had to do with layered designs. This was a way in his work of getting the information design out of the learner’s way, making the information layered so that it was available on demand, but not necessarily an impediment if the learner didn’t choose to look at it at that time.
  • we realized these people did have goals and they were experts, but they weren’t experts with the Displaywriter or the IBM PC. They were experts in office work, and they knew a lot about work practices, and processes, and objectives, and quality standards, and they knew more than we did. And we came to see that prior knowledge as an important resource that needed to be leveraged in the design of information, the design of training materials, and the design of user interfaces.
  •  
    "Minimalism Revisited: An Interview with John Carroll"
1More

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.
1More

DITA-related Software Tools - 0 views

  •  
    "IBM Information Architecture Workbench"
4More

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...
  • Known as scenario-based or solutions-oriented information, this content speaks to real goals and real work rather than trivial button pushing.
1More

dita-users : Message: Re: [dita-users] Specialization or heavy use of conref? - 0 views

  •  
    Eliot Kimber gives a list of the benefits and costs of specialization.
3More

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.
    • Jason Owen
       
      i.e., a task is user-oriented while a procedure is product-oriented.
  • 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.
1 - 20 of 134 Next › Last »
Showing 20 items per page