From user assistance to user guidance: Information apps

•

0 likes•1,398 views

Minimalism in technical documentation ultimately leads to using interactive procedures. The advantages of moving control from the user's head to a connected device are countless. But there has to be an easier way of building these so-called information apps (or procedure apps). This presentation shows how the implicit flowchart the designers have in their minds when writing a procedure can be made explicit in a graphical interface, which produces the HTML5 code. Easy design, easy error correction, no more reasons to not use procedures instead of relying on service manuals, training service staff, and the absence of stress on the work floor, where safety-critical procedures are required.

Services

From UA to UG
Information Apps
Jang F.M. Graat
Amsterdam
© 2014 - JANG Communication - Amsterdam, Netherlands

© 2014 - JANG Communication - Amsterdam, Netherlands
who's talking ?
Jang F.M. Graat
Psychology, Philosophy
25+ years Tech Comm
self-taught professional
DITA, XSLT, JS, PHP, AJAX
addicted to challenge

© 2014 - JANG Communication - Amsterdam, Netherlands
what is this tutorial about ?
user assistance
user guidance
business intelligence
information apps
procedure apps

© 2014 - JANG Communication - Amsterdam, Netherlands
rules of minimalism
only what users need
action-oriented
support error recovery

© 2014 - JANG Communication - Amsterdam, Netherlands
optimizing user assistance
printed manual
help file
context-sensitive help
user analysis/personas
progressive disclosure
embedded help

© 2014 - JANG Communication - Amsterdam, Netherlands
optimizing production
topic-based authoring
single-sourcing
automated transforms
conditional content
personalizing info
feedback mechanisms

© 2014 - JANG Communication - Amsterdam, Netherlands
what is the real problem?
interpretations differ
overestimating skills
conditional/optional items
outdated knowledge
agile development

© 2014 - JANG Communication - Amsterdam, Netherlands
optimizing the work
user & task analysis
procedure leads the user
reduce learning curve
standardize the work
basis for planning

© 2014 - JANG Communication - Amsterdam, Netherlands
procedural knowledge
operating manuals
online tutorials
training courses
learning from colleagues
learning by trial and error

© 2014 - JANG Communication - Amsterdam, Netherlands
implicit assumptions
people follow rules
all products are identical
all workers are equal
there is no time pressure
the sun is always shining

© 2014 - JANG Communication - Amsterdam, Netherlands
procedures in real life
cutting corners
skipping steps
local circumstances
emergency situations
full/reliable reporting ?

© 2014 - JANG Communication - Amsterdam, Netherlands
modern technology
interactive media
dynamic content
only show applicable steps
usage & input tracking
automatically collect data

© 2014 - JANG Communication - Amsterdam, Netherlands
progressive disclosure
true minimalist info
show info step by step
force sign-offs
avoid skipping steps
track performance

© 2014 - JANG Communication - Amsterdam, Netherlands
only show applicable steps
allowing user input
highlight choice
hide non-applicable steps
reveal only next step
reset states on changes

© 2014 - JANG Communication - Amsterdam, Netherlands
other input types & sources
html5 input elements
sanity checks on input
using other data sources
hidden input methods
check device specs/settings

© 2014 - JANG Communication - Amsterdam, Netherlands
quite a challenge

© 2014 - JANG Communication - Amsterdam, Netherlands
keeping track of steps
like programming
check all possible paths
exponential complexity
“spaghetti code”
very hard to maintain

© 2014 - JANG Communication - Amsterdam, Netherlands
creating flowcharts

© 2014 - JANG Communication - Amsterdam, Netherlands
basic nodes
start
process
decision
yes/no
multiple choices
end

© 2014 - JANG Communication - Amsterdam, Netherlands
start : first step
<div id=“step1”>
<p class="mybutton"
onClick=“showStep(next);”>
Start
</p>
</div>

© 2014 - JANG Communication - Amsterdam, Netherlands
process : step with sign-off
<div id=“step2”>
<title>Do something</title>
<p class="mybutton"
onClick=“showStep(next);”>
OK
</p>
</div>

© 2014 - JANG Communication - Amsterdam, Netherlands
decision : choices
<step id=“step3”>
<title>Does it work ?</title>
<p class=“mybutton”
onClick=“showStep(A)”>Yes</p>
<p class=“mybutton”
onClick=“showStep(B)”>No</p>
</step>

© 2014 - JANG Communication - Amsterdam, Netherlands
end : no further actions
<div id=“step10”>
<title>You are done.</title>
</div>

© 2014 - JANG Communication - Amsterdam, Netherlands
transformation
!
<title>Replacing the oil</title>
<body>
<div class=“context”>
<p>Checking the oil level will prevent serious !
! damage and does not require tools.</p>
</div>
<div class=“procedure”>
<div class=“step” id="step1">
<p class=“cmd”>Remove the oil inlet cap</p>
<p class=“info”>The oil inlet cap is on the bottom !
! right side of the engine.</p>
</div>
<div class=“step” id="step2">
<p class=“cmd”>Remove dipstick.</p>
</div>
<div class=“step” id="step3">
<p class=“cmd”>What is the bike model?</p>
<table>
<tr>
<td>Softail</td>
<td>Continue with step 4</td>
</tr>
<tr>
<td>FSCWC</td>
<td>Continue with step 5</td>
</tr>
</table>
</div>!

© 2014 - JANG Communication - Amsterdam, Netherlands
time for a demo !

© 2014 - JANG Communication - Amsterdam, Netherlands
optimizing the business
product improvement
predictive maintenance
service staff planning
equipment optimization
service staff education
customer training

© 2014 - JANG Communication - Amsterdam, Netherlands
how to get the data
usability research
customer feedback
helpdesk history
service staff reports
surveys

© 2014 - JANG Communication - Amsterdam, Netherlands
<DIB>
app building blocks

© 2014 - JANG Communication - Amsterdam, Netherlands
one server connects all

© 2014 - JANG Communication - Amsterdam, Netherlands
capturing/reusing data

© 2014 - JANG Communication - Amsterdam, Netherlands
questions ?
Jang F.M. Graat
Amsterdam, NL
jang@jang.nl
@4everJang
www.jang.nl

This document discusses Lean UX and validation techniques for products. Some key points include: - Lean UX focuses on user-centered, agile, data-driven and hypothesis-driven approaches to product design. - Various validation techniques are described such as landing page tests, prototype testing, guerrilla user tests, and A/B testing to gather feedback and validate hypotheses. - An MVP or minimum viable product should be both minimum and viable, providing a small whole product to validate rather than an incomplete large product. Metrics like retention, revenue, and conversion can provide insights but require careful analysis.

Out of-control

Jang F.M. Graat

To survive in the new world of information, we must abandon outdated ideas of authority and control over content. Instead, we should create and treat content as small "info-animals" living freely in a knowledge ecosystem, as trying to tightly control their movements will cause them to die rather than thrive. The talk aims to radically change the perspective on content management by viewing content as living entities in an open ecosystem rather than static objects to be strictly managed.

Faster than Agile - Proposal for Lavacon 2015

Jang F.M. Graat

Flowcharting DITA

Jang F.M. Graat

The document discusses flowcharting procedures in DITA (Darwin Information Typing Architecture). It describes converting traditional flowcharts to a DITA task format using elements like <context>, <step>, and <choices>. This allows nesting child tasks within steps and avoiding trouble tables. The presentation encourages driving DITA beyond current uses by fully leveraging its capabilities for interactive media and nested procedures.

Training technical workforce faster, safer - with virtual interactive software.

Heartwood

This document discusses using 3D interactive simulations and guides to reduce training costs and errors. It outlines issues with current training approaches like classroom training being costly and e-learning being passive. Virtual simulations and guides can bridge this gap by making training engaging, accessible anywhere and scalable. Examples are provided of industries using virtual reality for certification, maintenance training and reducing training time. A process for piloting these solutions is described involving identifying problems, creating a business case and seeking funding.

How poka yoke systems can be implemented

greendot management solution

Poka Yoke is a Japanese term meaning "mistake-proofing" or "error-proofing". It is a quality control method used to eliminate or prevent mistakes or errors during manufacturing processes. The goal of Poka Yoke is to make it impossible or at least very difficult to make mistakes, thus improving efficiency and reducing defects. This can be achieved through various means, such as designing products or processes that are self-checking, using warning signals or alarms, or providing clear instructions for operators. By implementing Poka Yoke, organizations can improve the quality of their products and reduce the time and cost associated with fixing mistakes

From push to pull in IT by Faurecia

Institut Lean France

Agile4 com method-uk_v3.675

all2com

The document describes SAP Screen Personas, a tool that improves user productivity on SAP systems. It does this by enabling customization of SAP screens through features like rearranging elements, hiding unnecessary fields, merging screens, and automating common steps. The document provides examples of customers who used Screen Personas to simplify processes, reduce training times, and increase efficiency. It also discusses how projected improvements in productivity, training costs, and data quality from using Screen Personas can fund the implementation project.

eDRG Innovative Reporting & Dashboarding - Business Values

eDRG2014

eDRG is a powerful reporting and dashboarding tool that integrates with the EMC Documentum platform. It allows users to create customizable reports and dashboards in an interactive format. Reports can be generated on demand, scheduled, or event-based. eDRG features include powerful querying, trend analysis, integration with Documentum security and objects, and output in multiple formats. It provides a unified dashboard interface and customizable reports to improve users' decision making and management abilities.

Progressive Web Apps 1. keynote

Abdelrahman Omran

Sap education knoa

Marcelo C. Rolandelli

The document describes SAP User Experience Management (UEM) by Knoa, which provides visibility into SAP system usage. It allows understanding who is using the system, what they are doing, where they are working from, why they are experiencing issues, and when tasks are being done. This helps optimize workforce productivity, reduce complexities, and align business and technology. Knoa offers metrics on errors, response times, utilization, and user workflows to improve adoption, support, training and business processes. Dashboards provide role-based reporting and tools to actively monitor KPIs, user performance, and impact by location.

Arrk Group | Putting The User First | June 2015

arrkgroup

The document discusses the concept of putting the user first in digital product design. It argues that traditionally, developers and business owners' preconceptions lead design rather than determining users' requirements through interviews, observations, and testing. The user first methodology includes developing personas, experiential mapping, paper and digital prototyping, and analytics to involve users throughout the design process. This approach aims to better meet users' needs and mitigate risks of project failure compared to approaches not informed by users. The document provides an agenda for the discussion and examples of how user research methods are applied.

Bridging the gap between business and technology - Behaviour Driven Developme...

Eugenio Minardi

This document discusses Behavior Driven Development (BDD) with Drupal. BDD is an agile methodology that promotes communication and collaboration through writing scenarios that describe application behaviors. The scenarios are used to automate testing and provide documentation. BDD helps bridge communication gaps between business and technical teams. When using BDD with Drupal, tools like Behat and Mink allow writing tests in the Gherkin language that can test Drupal functionality and behaviors.

SAP Presentation to Augmented Reality Marketing Conference Dublin 2015 sap

ARMarketing.org

This document discusses augmented reality and wearable technology solutions from SAP. It provides an introduction and history of SAP's work in this area since 2010. It then describes some current standard augmented reality solutions available from SAP, and shows demos of these solutions, including applications for warehouse picking and field service technicians. The document discusses the benefits customers have experienced from these solutions, such as improved efficiency, productivity and hands-free use. Architecture diagrams and screenshots of the solutions are also provided.

[Webinar Slides] Put an End to Manual Data Processing

AIIM International

This document summarizes a presentation on putting an end to manual data processing. It introduces the speaker, George Dunn, president of Cre8 Independent Consultants. Dunn has extensive experience in business process improvement, workflow, and paperless technologies planning. The presentation addresses challenges with manual processes, including providing poor customer service and errors. It also discusses challenges to removing paper, such as staff resistance to change and a lack of management initiatives. The presentation argues for developing an enterprise-level business case and mandates to support process improvements and deployment of new technologies.

Peter Verstraeten (Proceedix): Digital Work Instructions and Inspections Powe...

AugmentedWorldExpo

A talk from the Work Track at AWE USA 2018 - the World's #1 XR Conference & Expo in Santa Clara, California May 30- June 1, 2018. Peter Verstraeten (Proceedix): Digital Work Instructions and Inspections Powered by Proceedix Proceedix is a Software as a Service-based central platform to manage enterprise procedures, work instructions and inspections in an easy way, while making the remote execution paperless and mobile. http://AugmentedWorldExpo.com

Online Tours and travel

Amit Patil

This document is a project report submitted by Amit Ajit Patil to the University of Mumbai for their B.Sc. in Information Technology degree. The report details the development of an online tours and travels system for Prafulla Tours and Travels in Andheri, Mumbai. The current manual system used by Prafulla Tours has several limitations including a lack of online booking and coordination between branches. The proposed online system will address these limitations by allowing online booking, integrating all business processes, and providing quick access to information for administrators and customers. The report covers planning, design, and development phases including feasibility analysis, requirements gathering, system design diagrams, database structure, and test plans.

Pm unit 1,2,3,4,5,6

WE-IT TUTORIALS

Unit-I Conventional Software Management: The waterfall model, conventional software Management performance. Evolution of Software Economics: Software Economics, pragmatic software cost estimation. Improving Software Economics: Reducing Software product size, improving software processes, improving team effectiveness, improving automation, Achieving required quality, peer inspections. 10 Lectures Unit-II The old way and the new: The principles of conventional software Engineering, principles of modern software management, transitioning to an iterative process. Life cycle phases: Engineering and production stages, inception, Elaboration, construction, transition phases. Artifacts of the process: The artifact sets, Management artifacts, Engineering artifacts, programmatic artifacts. Model based software architectures: A Management perspective and technical perspective. 10 Lectures Unit-III Work Flows of the process: Software process workflows, Iteration workflows. Checkpoints of the process: Major mile stones, Minor Milestones, Periodic status assessments. Iterative Process Planning: Work breakdown structures, planning guidelines, cost and schedule estimating, Iteration planning process, Pragmatic planning. 10 Lectures Unit-IV Project Organizations and Responsibilities: Line-of-Business Organizations, Project Organizations, evolution of Organizations. Process Automation: Automation Building blocks, The Project Environment. 10 Lectures Unit-V Project Control and Process instrumentation: The seven core Metrics, Management indicators, quality indicators, life cycle expectations, pragmatic Software Metrics, Metrics automation. Tailoring the Process: Process discriminants. 10 Lectures Unit-VI Future Software Project Management: Modern Project Profiles, Next generation Software economics, modern process transitions. 10 Lectures

Are service workers draining my battery? [Talk at AmsterdamJS 2017]

Ivano Malavolta

This document summarizes an experiment conducted to measure the energy consumption of progressive web apps (PWAs) on different mobile devices and network conditions. The experiment tested 7 popular PWAs on high-end and low-end Android devices over both WiFi and 2G networks. It found that PWAs consumed significantly more energy on low-end devices and over 2G networks. While service workers did not significantly impact energy usage, individual PWAs and usage conditions did influence energy consumption to varying degrees. A manual review of the service workers found no clear trends in how they were implemented across the tested PWAs.

2. Rebalancing Support and Innovation_SAP UEM by KNOA_Erik Figueredo

Sing Yee Khoo

Effective Instrumentation Strategies for Data-driven Product Management

Pawan Kumar Adda

Everyone wants to drive product decisions based on data. But that is the end goal, an intent. This goal needs a strategy and sustainable execution plan that would empower the companies and its employees to become data informed while making decisions. Enter Product Instrumentation. In this session, we will explore what is product instrumentation, why it is needed, and how you can get started with it.

5 Best Practices for Application-aware Network Performance Management (AANPM)...

Enterprise Management Associates

Application-aware Network Performance Management (AANPM) practices and products provide detailed insights into exactly who is using which resources, what quality of experience is taking place, and where to look when things go wrong. Such information can significantly improve planning, monitoring, and troubleshooting efforts. But which are the best options when it comes to planning out an AANPM strategy? Which sources of data offer the most cost-efficient results? How can complex, widely distributed networks be accommodated, particularly when users are far removed from the application servers? And where is the best place to start? These slides will reveal: *Key goals and objectives of AANPM *Choosing the right sources of AANPM data *Achieving true end-to-end AANPM, from core to remote site including the access layer *AANPM features and capabilities having the broadest impact and delivering the most value

Sustainable Test Automation: Collaborate within Team

SQALab

This document discusses challenges with test automation and best practices for sustainable test automation. It recommends addressing manual testing efforts, long feedback times, and operational blindness. Test automation should be treated as an activity that is part of the definition of done and not everything needs to be automated. Risk management is important and the Pareto principle applies. Test cases need maintenance over time. Data management techniques include independent test data, external storage, and microservices. Embrace microservices, learn about data virtualization, and make test automation part of the CI/CD pipeline. BDD, page objects, and separating framework, page and test layers are advised.

Sustainable Test Automation: Collaborate within Team

Berk Dülger

This document discusses challenges with test automation and best practices for sustainable test automation. It addresses issues like long feedback times, changing requirements, and technical debt. It recommends treating automation as a defined activity, focusing on high risk areas, and getting rid of old test cases. The document also discusses practices like continuous testing, risk management, microservices, and data virtualization. It emphasizes cross-disciplinary collaboration and having developers, testers, and analysts work together using techniques like behavior-driven development.

OpenSpan Webinar Sept. 17th with Donna Fluss, DMG Consulting - Desktop Analyt...

Frank Wagman

DMG Consulting's Donna Fluss Discusses Desktop Automation and Analytics - Opt...

OpenSpan

Desktop Automation and Analytics have become hot topics in technology discussions in the contact center marketplace over the last two years. As companies realize the impact that improved agent performance can have on the customer experience, it is critical to understand what this solution is – and what it is not. View this presentation by Donna Fluss – founder of DMG Consulting and industry expert – that covers desktop automation and analytics and how companies are utilizing this technology to drive revenue, agent performance and the customer experience cross–industry.

Orchestration, Automation and Virtualisation - Maturity Model

CSUC - Consorci de Serveis Universitaris de Catalunya

This document introduces an Orchestration, Automation and Virtualization (OAV) Maturity Model. The model aims to help organizations measure their current OAV capabilities and identify areas for improvement. It establishes five levels of maturity: Sit, Crawl, Walk, Run, and Energize. These levels are defined across four dimensions: People & Organization, Vision & Strategy, Processes & Services, and Architecture & Technology. The document encourages organizations to use a provided survey to assess their current maturity levels, and to re-assess over time to track their progress in advancing OAV capabilities.

XSLT for Authors

Jang F.M. Graat

Minimalism to the MAX

Jang F.M. Graat

Similar to From user assistance to user guidance: Information apps

SAP Screen Personas - February 2014

Peter Spielvogel

eDRG Innovative Reporting & Dashboarding - Business Values

eDRG2014

Progressive Web Apps 1. keynote

Abdelrahman Omran

Sap education knoa

Marcelo C. Rolandelli

Arrk Group | Putting The User First | June 2015

arrkgroup

Bridging the gap between business and technology - Behaviour Driven Developme...

Eugenio Minardi

SAP Presentation to Augmented Reality Marketing Conference Dublin 2015 sap

ARMarketing.org

[Webinar Slides] Put an End to Manual Data Processing

AIIM International

Peter Verstraeten (Proceedix): Digital Work Instructions and Inspections Powe...

AugmentedWorldExpo

Online Tours and travel

Amit Patil

Pm unit 1,2,3,4,5,6

WE-IT TUTORIALS

Are service workers draining my battery? [Talk at AmsterdamJS 2017]

Ivano Malavolta

2. Rebalancing Support and Innovation_SAP UEM by KNOA_Erik Figueredo

Sing Yee Khoo

Effective Instrumentation Strategies for Data-driven Product Management

Pawan Kumar Adda

5 Best Practices for Application-aware Network Performance Management (AANPM)...

Enterprise Management Associates

Sustainable Test Automation: Collaborate within Team

SQALab

Sustainable Test Automation: Collaborate within Team

Berk Dülger

OpenSpan Webinar Sept. 17th with Donna Fluss, DMG Consulting - Desktop Analyt...

Frank Wagman

DMG Consulting's Donna Fluss Discusses Desktop Automation and Analytics - Opt...

OpenSpan

Orchestration, Automation and Virtualisation - Maturity Model

CSUC - Consorci de Serveis Universitaris de Catalunya

Similar to From user assistance to user guidance: Information apps (20)

SAP Screen Personas - February 2014

eDRG Innovative Reporting & Dashboarding - Business Values

Progressive Web Apps 1. keynote

Sap education knoa

Arrk Group | Putting The User First | June 2015

Bridging the gap between business and technology - Behaviour Driven Developme...

SAP Presentation to Augmented Reality Marketing Conference Dublin 2015 sap

[Webinar Slides] Put an End to Manual Data Processing

Peter Verstraeten (Proceedix): Digital Work Instructions and Inspections Powe...

Online Tours and travel

Pm unit 1,2,3,4,5,6

Are service workers draining my battery? [Talk at AmsterdamJS 2017]

2. Rebalancing Support and Innovation_SAP UEM by KNOA_Erik Figueredo

Effective Instrumentation Strategies for Data-driven Product Management

5 Best Practices for Application-aware Network Performance Management (AANPM)...

Sustainable Test Automation: Collaborate within Team

OpenSpan Webinar Sept. 17th with Donna Fluss, DMG Consulting - Desktop Analyt...

DMG Consulting's Donna Fluss Discusses Desktop Automation and Analytics - Opt...

Orchestration, Automation and Virtualisation - Maturity Model

More from Jang F.M. Graat

XSLT for Authors

Jang F.M. Graat

Minimalism to the MAX

Jang F.M. Graat

Dynamic links using (meta)data

Jang F.M. Graat

Creating links in technical content greatly supports the user experience, but as technical content evolves, such links are getting harder to handle. Creating static links that are resolved while building the output will not work out in the end, as content creation is moving into the agile world. This is where a new paradigm is required, which enables authors to create semantically defined links, which will be resolved by querying the database of available topics, during runtime. This revolutionises the way we think about cross-references and hyperlinks.

Maximising the effect of progressive disclosure

Jang F.M. Graat

Minimalism in technical documentation states that we should only deliver info that the user needs. But how can we know what each individual user already knows (and does not need)? The answer is: we cannot. And this is why we should use progressive disclosure techniques to optimize the help we offer to our customers, so that each individual customer can decide for himself whether more info is needed or not, and on which aspects more info is needed. There is one important catch: Implementing progressive disclosure can be a lot of work and be too costly to do. The solution to this budgetary problem is to use a well-defined structure in your content (preferably DITA) and an XSLT that automatically adds the required hooks and handles (triggers and targets) to make progressive disclosure work.

Progressive Disclosure - Putting the User in Control

Jang F.M. Graat

XPath-based transformations in structured FrameMaker

Jang F.M. Graat

XSLT allows you to transform the structure of XML files into anything you need. As structured FrameMaker is not exactly XML but follows the same structured design, the capabilities of XSLT within the FrameMaker environment can be very useful. The FrameSLT plug-in produced by West Street Consulting offers this functionality at a very low price. This presentation gives an introduction to what the tool can do, and what it means to do transformations of structure in technical documents.

Driving DITA off the Map

Jang F.M. Graat

Publications in DITA are handled via dita maps. Even with conditions and DITAVAL options, these are inherently static and bound to an old book type paradigm. In this presentation I am trying to outline a new paradigm, where the disclosure of information is made truly dynamic. Doing away with maps or at least with one single top-level map that defines all content. Having a dynamic information disclosure layer in place may prepare our technical content for the fast-moving world of today (which will move even faster tomorrow).

Rethinking Version Control for Agile Content

Jang F.M. Graat

The document discusses the need for more dynamic and personalized approaches to version control and documentation. It argues that traditional one-dimensional version control is no longer suitable given modular, reusable content and varied delivery formats. It proposes taking cues from component-based production to manage interdependent information elements. Key aspects include minimizing change impacts using "Form Fit Function" rules and intelligently disclosing only relevant information based on a user's specific configuration. The goal is "liquid information delivery" that dynamically adapts information to fit each user's individual needs.

Advanced techniques for conversion to structured FrameMaker

Jang F.M. Graat

This document summarizes Jang F.M. Graat's presentation on advanced techniques for converting unstructured FrameMaker documents to structured FrameMaker. The presentation covers pre-processing techniques like optimizing format tags and handling text insets to prepare for conversion. It also discusses building conversion tables, post-processing like importing EDDs and optimizing structure, and techniques for handling conversion failures.

Create your own $35 CMS in Structured FrameMaker

Jang F.M. Graat

The document describes how to create a $35 content management system (CMS) using Adobe FrameMaker. It involves 4 steps: 1) Create reusable modules using InsetPlus to element-level link content, 2) Create a CMS by organizing modules and metadata in repository files, 3) Enable cross-references between modules using XRef Wizard, and 4) Create publications by compiling modules from the repositories into books and resolving cross-references. The CMS allows managing content modularly while reusing and consistently publishing it across multiple languages.

Dita Spezialisierung - Wie machen Sie es, und warum Sie es machen sollen.

Jang F.M. Graat

Nur der Nutzer weiss, was der Nutzer noch nicht weiss - Progressive Disclosure

Jang F.M. Graat

Diese Präsentation zeigt, wie Minimalismus in technische Dokumentation letztendlich zu eine Technik führt, die sich auf English "Progressive Disclosure" nennt und am Besten als "fortschreitende Offenlegung" übersetzt werden kann. Warum Progressive Disclosure wichtig ist und wie es handmässig oder auch automatisiert gemacht wird (falls die Inhalte in einer vernünftig strukturierten Form vorliegen).

Changing the engine without stopping the rickshaw

Jang F.M. Graat

This presentation is a reworked version of a joint presentation with a customer at TCWorld in Germany 2012. It shows how the transition from unstructured documentation to the modern world of structured, XML-based and topic-oriented authoring can be made smooth, without interfering with the publication chain. This presentation describes a project that was done using FrameMaker 10 with its built-in ExtendScript toolkit. It shows how being able to mix unstructured and structured content, including a DITA-type conref mechanism, can be used to keep the system running while the materials are converted and pushed into a repository for reuse one by one. This flattens the legacy documentation hurdle that may keep companies from moving to modern authoring practices.

How I killed the webmaster - and got away with it

Jang F.M. Graat

How to become a trainer - and make lots of $$$

Jang F.M. Graat

Getting your hands dirty - How tech authors may be able to survive in the mac...

Jang F.M. Graat

CADD: What can DITA learn from CAD?

Jang F.M. Graat

Computer-aided design (CAD) software uses hierarchies, assemblies, and reusable components to optimize design and manufacturing. Content authoring systems like DITA can learn from CAD approaches to improve reuse, change management, and production of technical documentation. CAD uses bills of materials (BOMs) that list all required parts to guide production; DITA can similarly use maps, topics, and relationships between them as the basis for manuals.

Modular documentation in Structured FrameMaker

Jang F.M. Graat

Bite back - Survival Techniques for Technical Authors

Jang F.M. Graat

Does one size really fit all ?

Jang F.M. Graat

More from Jang F.M. Graat (20)

XSLT for Authors

Minimalism to the MAX

Dynamic links using (meta)data

Maximising the effect of progressive disclosure

Progressive Disclosure - Putting the User in Control

XPath-based transformations in structured FrameMaker

Driving DITA off the Map

Rethinking Version Control for Agile Content

Advanced techniques for conversion to structured FrameMaker

Create your own $35 CMS in Structured FrameMaker

Dita Spezialisierung - Wie machen Sie es, und warum Sie es machen sollen.

Nur der Nutzer weiss, was der Nutzer noch nicht weiss - Progressive Disclosure

Changing the engine without stopping the rickshaw

How I killed the webmaster - and got away with it

How to become a trainer - and make lots of $$$

Getting your hands dirty - How tech authors may be able to survive in the mac...

CADD: What can DITA learn from CAD?

Modular documentation in Structured FrameMaker

Bite back - Survival Techniques for Technical Authors

Does one size really fit all ?

Recently uploaded

The Fraud Examiner’s Report – What the Certified Fraud Examiner Should Know

Godwin Emmanuel Oyedokun MBA MSc PhD FCA FCTI FCNA CFE FFAR

Understanding Love Compatibility or Synastry: Why It Matters

AstroForYou

Best Web Development Frameworks in 2024

growthgrids

Best Web Development Frameworks: In 2024, the landscape of web development frameworks is diverse, with different frameworks excelling in various aspects such as 1. React, 2. Jquery, 3. MySQL, and 4. ASP.NET. With a strategic blend of manual testing and cutting-edge automated tools, we guarantee a flawless user experience. Partner with Growth Grids and elevate your software quality to new heights. Contact Us :- Email: [business@growthgrids.com] Phone: [+91-9773356002] Website : https://growthgrids.com

Solar powered Security Camera- Sun In One

John McHale

Exceptional Landscape Architecture Services in Melbourne

Outdoor Home Decor Company

Landscape Architect Melbourne specializes in designing stunning, sustainable outdoor spaces that blend creativity with functionality. From lush gardens to innovative urban landscapes, they transform environments into aesthetically pleasing, eco-friendly havens. Their expertise ensures each project harmonizes with its surroundings, enhancing Melbourne's unique urban character while promoting environmental stewardship.

3 Examples of new capital gains taxes in Canada

Lakshay Gandhi

Stay informed about capital gains taxes in Canada with our detailed guide featuring three illustrative examples. Learn what capital gains taxes are and how they work, including how much you pay based on federal and provincial rates. Understand the combined tax rates to see your overall tax liability. Examine specific scenarios with capital gains of $500k and $1M, both before and after recent tax changes. These examples highlight the impact of new regulations and help you navigate your tax obligations effectively. Optimize your financial planning with these essential insights! 💼 Dive into the intricacies of capital gains taxes in Canada with this insightful video! Learn through three detailed examples how these taxes work and how recent changes might impact you. ❓ What are capital gains taxes? Understand the basics of capital gains taxes and why they matter for your investments. 💸 How much taxes do I pay? Discover how the amount of tax you owe is calculated based on your capital gains. 📊 Federal tax rates: Explore the federal tax rates applicable to capital gains in Canada. 🏢 Provincial tax rates: Learn about the varying provincial tax rates and how they affect your overall tax bill. ⚖️ Combined tax rates: See how federal and provincial tax rates combine to determine your total tax obligation. 💵 Example 1 – Capital gains $500k: Examine a scenario where $500,000 in capital gains is taxed. 💰 Example 2 – Capital gains of $1M before the changes: Understand how a $1 million capital gain was taxed before recent changes. 🆕 Example 3 – Capital gains of $1M after the changes: Analyze the tax implications for a $1 million capital gain after the latest tax reforms. 🎉 Conclusion: Summarize the key points and takeaways to help you navigate capital gains taxes effectively. #CapitalGainsTax #Taxation #CanadianTax #InvestmentTax #TaxRates #FinancialPlanning #TaxReform #CapitalGains #TaxExamples 💼💸📊🏢⚖️💵💰🆕

Electrical Testing Lab Services in Dubai.pdf

sandeepmetsuae

The best Social Media Spy Apps for Catching Your Unfaithful Wife.pdf

tonytkelly6

Expert Tips for Pruning Your Plants.pdf.

Local Gardeners

Siddhivinayak temple timings Houston, TX

gaurisiddhivinayakte

Best Immigration Consultants in Amritsar- SAGA Studies

SAGA Studies

eBrand Promotion Full Service Digital Agency Company Profile

ChimaOrjiOkpi

eBrandpromotion.com is Nigeria’s leading Web Design/development and Digital marketing agency. We’ve helped 600+ clients in 24 countries achieve growth revenue of over $160+ Million USD in 12 Years. Whether you’re a Startup or the Unicorn in your industry, we can help your business/organization grow online. Thinking of taking your business online with a professionally designed world-class website or mobile application? At eBrand, we don’t just design beautiful mobile responsive websites/apps, we can guarantee that you will get tangible results or we refund your money…

Enhance Your Home with Professional Painting Services

Perfect Industrial

By refining the layout and replacing furnishings, people can more effectively enjoy themselves in their home environment. If you want to enhance the visual appeal of your home, then residential painting services are at your service. We take responsibility for transforming your dull spaces into vibrant ones. This PPT unveils the difference that professional painters make in elevating the look of your home.

Generate Revenue with Contact Center Business Model Strategy

RNayak3

Biomass Briquettes A Sustainable Solution for Energy and Waste Management..pptx

ECOSTAN Biofuel Pvt Ltd

Biomass briquettes are an innovative and environmentally beneficial alternative to traditional fossil fuels, providing a long-term solution for energy production and waste management. These compact, high-energy density briquettes are made from organic materials such as agricultural wastes, wood chips, and other biomass waste, and are intended to reduce environmental effect while satisfying energy demands efficiently.

Discover How Long Do Aluminum Gutters Last?

SteveRiddle8

How Long Does Vinyl Siding Last and What Impacts Its Life Expectancy?

Alexa Bale

The majority of siding industry insiders assert that vinyl has a 20–40-year lifespan. Although this lifetime indicates an increase over earlier siding types, the average life expectancy is heavily dependent on outside factors. Vinyl siding needs to be carefully maintained, especially after a weather event. Dive into ppt to know How Long Does Vinyl Siding Last and What Impacts Its Life Expectancy.

Top 10 Challenges That Every Web Designer Face on A Daily Basis.pptx

e-Definers Technology

In today’s fast-moving digital world, building websites is super important for how well a business does online. But, because things keep changing with technology and what people expect, teams who make websites often run into big problems. These problems can slow down their work and stop them from making really good websites. Let us see what the best website designers in Delhi have to say – https://www.edtech.in/services/website-designing-development-company-delhi.htm

How Live-In Care Benefits Chronic Disease Management.pdf

KenWaterhouse

DOJO Training room | Training DOJO PPT

Himanshu

Recently uploaded (20)

The Fraud Examiner’s Report – What the Certified Fraud Examiner Should Know

Understanding Love Compatibility or Synastry: Why It Matters

Best Web Development Frameworks in 2024

Solar powered Security Camera- Sun In One

Exceptional Landscape Architecture Services in Melbourne

3 Examples of new capital gains taxes in Canada

Electrical Testing Lab Services in Dubai.pdf

The best Social Media Spy Apps for Catching Your Unfaithful Wife.pdf

Expert Tips for Pruning Your Plants.pdf.

Siddhivinayak temple timings Houston, TX

Best Immigration Consultants in Amritsar- SAGA Studies

eBrand Promotion Full Service Digital Agency Company Profile

Enhance Your Home with Professional Painting Services

Generate Revenue with Contact Center Business Model Strategy

Biomass Briquettes A Sustainable Solution for Energy and Waste Management..pptx

Discover How Long Do Aluminum Gutters Last?

How Long Does Vinyl Siding Last and What Impacts Its Life Expectancy?

Top 10 Challenges That Every Web Designer Face on A Daily Basis.pptx

How Live-In Care Benefits Chronic Disease Management.pdf

DOJO Training room | Training DOJO PPT

From user assistance to user guidance: Information apps

2. © 2014 - JANG Communication - Amsterdam, Netherlands who's talking ? Jang F.M. Graat Psychology, Philosophy 25+ years Tech Comm self-taught professional DITA, XSLT, JS, PHP, AJAX addicted to challenge

4. user assistance

9. user guidance

14. let’s become modern

18. © 2014 - JANG Communication - Amsterdam, Netherlands other input types & sources html5 input elements sanity checks on input using other data sources hidden input methods check device specs/settings

19. modeling procedures

26. © 2014 - JANG Communication - Amsterdam, Netherlands decision : choices <step id=“step3”> <title>Does it work ?</title> <p class=“mybutton” onClick=“showStep(A)”>Yes</p> <p class=“mybutton” onClick=“showStep(B)”>No</p> </step>

28. © 2014 - JANG Communication - Amsterdam, Netherlands transformation ! <title>Replacing the oil</title> <body> <div class=“context”> <p>Checking the oil level will prevent serious ! ! damage and does not require tools.</p> </div> <div class=“procedure”> <div class=“step” id="step1"> <p class=“cmd”>Remove the oil inlet cap</p> <p class=“info”>The oil inlet cap is on the bottom ! ! right side of the engine.</p> </div> <div class=“step” id="step2"> <p class=“cmd”>Remove dipstick.</p> </div> <div class=“step” id="step3"> <p class=“cmd”>What is the bike model?</p> <table> <tr> <td>Softail</td> <td>Continue with step 4</td> </tr> <tr> <td>FSCWC</td> <td>Continue with step 5</td> </tr> </table> </div>!

30. business intelligence

31. © 2014 - JANG Communication - Amsterdam, Netherlands optimizing the business product improvement predictive maintenance service staff planning equipment optimization service staff education customer training

33. UA UG BI

From user assistance to user guidance: Information apps

Recommended

Recommended

More Related Content

Similar to From user assistance to user guidance: Information apps

Similar to From user assistance to user guidance: Information apps (20)

More from Jang F.M. Graat

More from Jang F.M. Graat (20)

Recently uploaded

Recently uploaded (20)

From user assistance to user guidance: Information apps