This 2-hour tutorial explains the basic principles of progressive disclosure and includes a shoot-out between two tools that offer various levels of support for implementing progressive disclosure in web-based help systems: Adobe RoboHelp and MadCap Flare.
This slideshow will show you how to use microblogging (e.g. Twitter or Yammer) in a business environment.
This information is based on a series of blog posts available in German language at http://conception-blog.com/einsatzgebiete-von-microblogging-in-unternehmen-teil-1-von-4/2009
The whole point of a good GUI (Graphical User Interface) is being able to understand what is going on without reading every single detail. That is why we prefer big red crosses to say "Don't do that you oaf!" instead of a line of text that says "I think you may want to reconsider your options."
Since a lot of Dukane projectors are used with Powerpoints, I thought this simple "survial guide" might be useful.
The company that created this guide made it clear anyone cold post and share this.
I do want to add I dont know anything about the addtional services they offer and mention in this document.
I am sharing it for those who might find the Powerpoint tips useful
Bill McIntosh
Mentimeter is a tool that allows teachers to create interactive presentations for students to respond to questions in real-time using devices. Students can join the presentation using a code provided by the teacher. The teacher can create quizzes or polls within the presentation by adding multiple choice or open-ended questions. Mentimeter tracks and displays the results of student responses. This allows the teacher to instantly gauge class understanding of concepts during the lesson.
The document provides principles and guidelines for designing effective user interfaces (UIs). It discusses the importance of clarity, keeping users in control, direct manipulation, strong visual hierarchies, highlighting without determining with color, progressive disclosure, helping users inline, designing for the zero state, solving existing problems, invisible design, and ensuring interfaces are actually used. The overall message is that UIs should be intuitive, minimize cognitive load, and maximize usability.
Design...
In 3 sentences:
This document discusses the concept of design through examples like Tesla Motors and kites. It defines design as a problem-solving method that links creativity and innovation to meet human needs. The document also outlines various design disciplines and distinguishes design from art, noting that while art communicates design, design must convey information and be utilitarian.
This slideshow will show you how to use microblogging (e.g. Twitter or Yammer) in a business environment.
This information is based on a series of blog posts available in German language at http://conception-blog.com/einsatzgebiete-von-microblogging-in-unternehmen-teil-1-von-4/2009
The whole point of a good GUI (Graphical User Interface) is being able to understand what is going on without reading every single detail. That is why we prefer big red crosses to say "Don't do that you oaf!" instead of a line of text that says "I think you may want to reconsider your options."
Since a lot of Dukane projectors are used with Powerpoints, I thought this simple "survial guide" might be useful.
The company that created this guide made it clear anyone cold post and share this.
I do want to add I dont know anything about the addtional services they offer and mention in this document.
I am sharing it for those who might find the Powerpoint tips useful
Bill McIntosh
Mentimeter is a tool that allows teachers to create interactive presentations for students to respond to questions in real-time using devices. Students can join the presentation using a code provided by the teacher. The teacher can create quizzes or polls within the presentation by adding multiple choice or open-ended questions. Mentimeter tracks and displays the results of student responses. This allows the teacher to instantly gauge class understanding of concepts during the lesson.
The document provides principles and guidelines for designing effective user interfaces (UIs). It discusses the importance of clarity, keeping users in control, direct manipulation, strong visual hierarchies, highlighting without determining with color, progressive disclosure, helping users inline, designing for the zero state, solving existing problems, invisible design, and ensuring interfaces are actually used. The overall message is that UIs should be intuitive, minimize cognitive load, and maximize usability.
Design...
In 3 sentences:
This document discusses the concept of design through examples like Tesla Motors and kites. It defines design as a problem-solving method that links creativity and innovation to meet human needs. The document also outlines various design disciplines and distinguishes design from art, noting that while art communicates design, design must convey information and be utilitarian.
14 timeless rules for creating intuitive web appsDev Technosys
A web app that’s difficult to figure out, unintuitive, or inefficient is not going to win many hearts. But designing a user-friendly interface is hard. On top of the usual design problems like picking the right colors and creating a proper content structure, you need to also be aware of the bigger picture.
To know more:- https://devtechnosys.ae/
1) When designing a web app, follow common patterns and conventions that users are already familiar with to help them intuitively understand the interface.
2) Group related elements together and keep the interface clean and minimalistic to avoid overwhelming users.
3) Plan the user experience carefully before development by creating wireframes and focusing on essential user flows.
Usability of web application.
@ Kindly Follow my Instagram Page to discuss about your mental health problems-
-----> https://instagram.com/mentality_streak?utm_medium=copy_link
@ Appreciate my work:
-----> behance.net/burhanahmed1
Thank-you !
The document provides 10 guidelines for improving the usability of web applications:
1. Maintain a consistent user interface across pages with standardized elements.
2. Guide users through the application and make the desired actions obvious.
3. Make interactive elements like buttons and links large and prominent.
It then provides examples and explanations for each guideline. The guidelines focus on reducing confusion, providing feedback, streamlining inputs, and creating a clear visual structure to help users intuitively understand and easily accomplish their goals within the application.
The document discusses how to design user manuals that effectively answer the questions users typically have. It identifies four main questions users seek to answer: 1) Why should I care? (about basic program theory and usefulness), 2) What is it? (simple descriptions of interface elements), 3) How do I do it? (step-by-step instructions for tasks), and 4) Why did it do that? (explanations for unexpected program behaviors). The author recommends addressing the first two questions in online help and the latter two in paper manuals, as users prefer short answers online and longer procedural information in print.
I am glad to present you my 9 web rules guide, which is focused on programmers with no notions about UX and explains 9 essential aspects of web usability to take into account in any web development.
I'm very grateful to have done this project with the support of Dani Amo, whom I want to thank very much.
I hope you enjoy it!
Making simple, elegant solutions is HARD and often invisible. These are some of the most common things I hear come out of people’s mouths when heading for a bad UX decision.
The document describes a resource management tool (RMT) developed by Scopic to allow project supervisors to coordinate employee assignments based on skills and availability. The tool also coordinates internal trainings. An essential part is the employee profile module where employees input personal details. The task is to improve the usability of the tool, specifically the employee profile section. Recommendations include simplifying interactions, improving visual organization and accessibility, adding loading indicators, and streamlining filters and tables. Sketches are provided of redesigned profile and training tabs/pages.
Essay On Importance Of Reading Habits. Online assignment writing service.Diana Jordan
The document discusses the themes of friendship and war in the novel A Separate Peace by John Knowles. It provides examples of how the friendship between the main characters Gene and Phineas changes and strains as their competitiveness and jealousy increases. Their friendship represents the inner war they experience with each other as Gene feels inferior to Phineas and wants to be more like him. The themes of friendship and inner war are crucial to understanding the story.
The document provides procedures for inspecting and maintaining computer networks, including:
1. Creating an equipment maintenance schedule to guide personnel on proper maintenance procedures.
2. Developing a maintenance checklist to assess if maintenance is implemented as planned and record results for action.
3. The checklist outlines specific maintenance tasks like updating antivirus software, emptying recycle bins, disk cleanup, defragmenting drives, and configuring startup programs. Regular maintenance helps ensure efficient network performance.
The document discusses usability and design in web and graphic design. It argues that usability and accessibility should not undermine design. Some ways to improve usability without compromising design are to make hyperlinks and buttons large enough to click, use meaningful page titles and headers, maintain consistency in colors, language and conventions, provide feedback to users, and minimize registration barriers and memory loads on users. The document also recommends following Nielsen's 10 usability heuristics to prioritize visibility, match real world expectations, minimize errors, and emphasize recognition over recall.
Web usability a complete list of ux ui best practicesOlatunji Adetunji
This document discusses a website called SEO Web Analyst that provides various online marketing tools. It summarizes the user experience design process and research that went into developing the site, including user testing and several redesigns. The site aims to help digital marketers and small businesses leverage the internet to generate leads and sales. Key services mentioned include SEO, social media, blogging, and lead management tools. The document encourages readers to follow the site's social media accounts for updates on its planned launch before October.
This document provides information on problem solving skills for digital devices. It includes how to perform basic computer functions like starting and shutting down a computer. It also covers how to force close unresponsive programs, update apps and software, and check the internet connection. The goal is to help develop problem solving abilities for issues encountered when using digital tools and to understand that computers are not magical but can be understood through learning basic troubleshooting steps. The module aims to provide a more proactive approach to digital problems.
All things considered, as a bundle, social media applications are flawed, nor are they static. Like most technologies, these remain imperfect and are dependent upon future developments.
The document provides instructions for manually cleaning an infected computer. It begins with introducing the author's background and credentials in computer security. It then describes common signs of an infected computer, such as slow performance and unexpected browser windows. The instructions involve using Task Manager to diagnose problematic processes, disabling startup items, uninstalling applications, and deleting residual files and folders. The process is outlined in multiple parts, with explanations and screenshots provided at each step. Finally, the document recommends performing a scan with standalone antivirus software to verify that the computer is fully cleaned.
This document discusses principles for designing intuitive graphical user interfaces (GUIs). It emphasizes that GUIs should be simple, intuitive and minimize user effort. Key principles include catering designs for both occasional and frequent users, providing feedback for user actions, hiding complexity through progressive disclosure, and using passive elements like checkboxes instead of active buttons when possible. Extensive user testing is also emphasized to catch usability issues.
This document discusses principles for designing intuitive graphical user interfaces (GUIs). It emphasizes that GUIs should be simple, intuitive and minimize user effort. Key principles include catering designs for both occasional and frequent users, providing feedback for user actions, hiding complexity through progressive disclosure, and using passive elements like checkboxes instead of active buttons when possible. Extensive user testing is also emphasized to catch usability issues.
The document introduces Windows Technical Preview, an early pre-release build of the next version of Windows. It discusses four key ways this preview differs from previous releases: it is a subset of the full build, bits are released earlier in development, it expects more user feedback, and it uses ongoing development-feedback cycles. It then explains how to enroll in the Windows Insider Program to access the preview builds and provides an overview of new features in the Technical Preview like the return of the Start menu and windowed apps.
The document introduces Windows Technical Preview, an early pre-release build of the next version of Windows. It discusses four key ways this preview differs from previous releases: it is a subset of the full build, bits are released earlier in development, it expects more user feedback, and it uses ongoing development-feedback cycles. It then explains how to enroll in the Windows Insider Program to access the preview builds and provides an overview of new features in the Technical Preview like the return of the Start menu and windowed apps.
Windows 10 Technical Preview - http://f2suporte.blogspot.comWlademir RS
The document introduces Windows Technical Preview, an early pre-release build of the next version of Windows. It discusses four key ways this preview differs from previous releases: it is a subset of the full build, bits are released earlier in development, it expects more user feedback, and it uses ongoing development-feedback cycles. It then explains how to enroll in the Windows Insider Program to access the preview builds and provides an overview of new features in the Technical Preview like the return of the Start menu and windowed apps.
Simple explanation of XSLT - what it is, what it does and how it can help you in creating well-structured content. No tutorial, just the basic concepts.
Faster than Agile - Proposal for Lavacon 2015Jang F.M. Graat
This is my second proposal for the LavaCon conference to be held in New Orleans in October 2015. The first version of this talk will be delivered at DITA/CMS NA in Chicago in April.
More Related Content
Similar to Progressive Disclosure - Putting the User in Control
14 timeless rules for creating intuitive web appsDev Technosys
A web app that’s difficult to figure out, unintuitive, or inefficient is not going to win many hearts. But designing a user-friendly interface is hard. On top of the usual design problems like picking the right colors and creating a proper content structure, you need to also be aware of the bigger picture.
To know more:- https://devtechnosys.ae/
1) When designing a web app, follow common patterns and conventions that users are already familiar with to help them intuitively understand the interface.
2) Group related elements together and keep the interface clean and minimalistic to avoid overwhelming users.
3) Plan the user experience carefully before development by creating wireframes and focusing on essential user flows.
Usability of web application.
@ Kindly Follow my Instagram Page to discuss about your mental health problems-
-----> https://instagram.com/mentality_streak?utm_medium=copy_link
@ Appreciate my work:
-----> behance.net/burhanahmed1
Thank-you !
The document provides 10 guidelines for improving the usability of web applications:
1. Maintain a consistent user interface across pages with standardized elements.
2. Guide users through the application and make the desired actions obvious.
3. Make interactive elements like buttons and links large and prominent.
It then provides examples and explanations for each guideline. The guidelines focus on reducing confusion, providing feedback, streamlining inputs, and creating a clear visual structure to help users intuitively understand and easily accomplish their goals within the application.
The document discusses how to design user manuals that effectively answer the questions users typically have. It identifies four main questions users seek to answer: 1) Why should I care? (about basic program theory and usefulness), 2) What is it? (simple descriptions of interface elements), 3) How do I do it? (step-by-step instructions for tasks), and 4) Why did it do that? (explanations for unexpected program behaviors). The author recommends addressing the first two questions in online help and the latter two in paper manuals, as users prefer short answers online and longer procedural information in print.
I am glad to present you my 9 web rules guide, which is focused on programmers with no notions about UX and explains 9 essential aspects of web usability to take into account in any web development.
I'm very grateful to have done this project with the support of Dani Amo, whom I want to thank very much.
I hope you enjoy it!
Making simple, elegant solutions is HARD and often invisible. These are some of the most common things I hear come out of people’s mouths when heading for a bad UX decision.
The document describes a resource management tool (RMT) developed by Scopic to allow project supervisors to coordinate employee assignments based on skills and availability. The tool also coordinates internal trainings. An essential part is the employee profile module where employees input personal details. The task is to improve the usability of the tool, specifically the employee profile section. Recommendations include simplifying interactions, improving visual organization and accessibility, adding loading indicators, and streamlining filters and tables. Sketches are provided of redesigned profile and training tabs/pages.
Essay On Importance Of Reading Habits. Online assignment writing service.Diana Jordan
The document discusses the themes of friendship and war in the novel A Separate Peace by John Knowles. It provides examples of how the friendship between the main characters Gene and Phineas changes and strains as their competitiveness and jealousy increases. Their friendship represents the inner war they experience with each other as Gene feels inferior to Phineas and wants to be more like him. The themes of friendship and inner war are crucial to understanding the story.
The document provides procedures for inspecting and maintaining computer networks, including:
1. Creating an equipment maintenance schedule to guide personnel on proper maintenance procedures.
2. Developing a maintenance checklist to assess if maintenance is implemented as planned and record results for action.
3. The checklist outlines specific maintenance tasks like updating antivirus software, emptying recycle bins, disk cleanup, defragmenting drives, and configuring startup programs. Regular maintenance helps ensure efficient network performance.
The document discusses usability and design in web and graphic design. It argues that usability and accessibility should not undermine design. Some ways to improve usability without compromising design are to make hyperlinks and buttons large enough to click, use meaningful page titles and headers, maintain consistency in colors, language and conventions, provide feedback to users, and minimize registration barriers and memory loads on users. The document also recommends following Nielsen's 10 usability heuristics to prioritize visibility, match real world expectations, minimize errors, and emphasize recognition over recall.
Web usability a complete list of ux ui best practicesOlatunji Adetunji
This document discusses a website called SEO Web Analyst that provides various online marketing tools. It summarizes the user experience design process and research that went into developing the site, including user testing and several redesigns. The site aims to help digital marketers and small businesses leverage the internet to generate leads and sales. Key services mentioned include SEO, social media, blogging, and lead management tools. The document encourages readers to follow the site's social media accounts for updates on its planned launch before October.
This document provides information on problem solving skills for digital devices. It includes how to perform basic computer functions like starting and shutting down a computer. It also covers how to force close unresponsive programs, update apps and software, and check the internet connection. The goal is to help develop problem solving abilities for issues encountered when using digital tools and to understand that computers are not magical but can be understood through learning basic troubleshooting steps. The module aims to provide a more proactive approach to digital problems.
All things considered, as a bundle, social media applications are flawed, nor are they static. Like most technologies, these remain imperfect and are dependent upon future developments.
The document provides instructions for manually cleaning an infected computer. It begins with introducing the author's background and credentials in computer security. It then describes common signs of an infected computer, such as slow performance and unexpected browser windows. The instructions involve using Task Manager to diagnose problematic processes, disabling startup items, uninstalling applications, and deleting residual files and folders. The process is outlined in multiple parts, with explanations and screenshots provided at each step. Finally, the document recommends performing a scan with standalone antivirus software to verify that the computer is fully cleaned.
This document discusses principles for designing intuitive graphical user interfaces (GUIs). It emphasizes that GUIs should be simple, intuitive and minimize user effort. Key principles include catering designs for both occasional and frequent users, providing feedback for user actions, hiding complexity through progressive disclosure, and using passive elements like checkboxes instead of active buttons when possible. Extensive user testing is also emphasized to catch usability issues.
This document discusses principles for designing intuitive graphical user interfaces (GUIs). It emphasizes that GUIs should be simple, intuitive and minimize user effort. Key principles include catering designs for both occasional and frequent users, providing feedback for user actions, hiding complexity through progressive disclosure, and using passive elements like checkboxes instead of active buttons when possible. Extensive user testing is also emphasized to catch usability issues.
The document introduces Windows Technical Preview, an early pre-release build of the next version of Windows. It discusses four key ways this preview differs from previous releases: it is a subset of the full build, bits are released earlier in development, it expects more user feedback, and it uses ongoing development-feedback cycles. It then explains how to enroll in the Windows Insider Program to access the preview builds and provides an overview of new features in the Technical Preview like the return of the Start menu and windowed apps.
The document introduces Windows Technical Preview, an early pre-release build of the next version of Windows. It discusses four key ways this preview differs from previous releases: it is a subset of the full build, bits are released earlier in development, it expects more user feedback, and it uses ongoing development-feedback cycles. It then explains how to enroll in the Windows Insider Program to access the preview builds and provides an overview of new features in the Technical Preview like the return of the Start menu and windowed apps.
Windows 10 Technical Preview - http://f2suporte.blogspot.comWlademir RS
The document introduces Windows Technical Preview, an early pre-release build of the next version of Windows. It discusses four key ways this preview differs from previous releases: it is a subset of the full build, bits are released earlier in development, it expects more user feedback, and it uses ongoing development-feedback cycles. It then explains how to enroll in the Windows Insider Program to access the preview builds and provides an overview of new features in the Technical Preview like the return of the Start menu and windowed apps.
Similar to Progressive Disclosure - Putting the User in Control (20)
Simple explanation of XSLT - what it is, what it does and how it can help you in creating well-structured content. No tutorial, just the basic concepts.
Faster than Agile - Proposal for Lavacon 2015Jang F.M. Graat
This is my second proposal for the LavaCon conference to be held in New Orleans in October 2015. The first version of this talk will be delivered at DITA/CMS NA in Chicago in April.
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.
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.
From user assistance to user guidance: Information appsJang F.M. Graat
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.
Minimalism in technical documentation ultimately leads to using interactive procedures. This presentation shows why that is the case, and what well-designed interactive procedures can do to bring down the cost of training, the risk in relying on the goodwill and good memory of service staff and the unreliability of debriefing at the end of a tiring working day.
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 disclosureJang 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.
XPath-based transformations in structured FrameMakerJang 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.
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).
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 FrameMakerJang 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 FrameMakerJang 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
Spezialisierung ist Alleinstellungsmerkmal von DITA und damit das Wichtigste, was es in der technischen Redaktion in den letzten Jahrzehnten gegeben hat. Dieses Tutorial zeigt, warum Spezialisierung wichtig ist, was es genau bedeutet und wie Sie es erfolgreich umsetzen.
Nur der Nutzer weiss, was der Nutzer noch nicht weiss - Progressive DisclosureJang 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 rickshawJang 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 itJang F.M. Graat
This presentation was delivered at the STC Summit 2005 in Seattle. It shows how I implemented a website for the TransAlpine Chapter without a webmaster having to do all the stupid work (uploading stuff, taking it down, etc.). We received a Pacesetter Award for the coolest website in all of STC.
How to become a trainer - and make lots of $$$Jang F.M. Graat
This presentation was delivered at the STC Summit 2005 in Seattle. Jobs for technical authors were hard to find, and I tried to show people what you can do with your technical communication skills if you also know how to explain stuff to a live audience. Sorry that the gradient applied to the background does not show on SlideShare.
Getting your hands dirty - How tech authors may be able to survive in the mac...Jang F.M. Graat
This presentation was held at the STC Summit 2005 in Seattle. It shows how technical authors, hit by the offshoring of tech comms, can find plenty of work in the machinery business. After all, that business domain is less likely to be offshored and there are many more small machinery companies than global software corporations.
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.
AI-Powered Food Delivery Transforming App Development in Saudi Arabia.pdfTechgropse Pvt.Ltd.
In this blog post, we'll delve into the intersection of AI and app development in Saudi Arabia, focusing on the food delivery sector. We'll explore how AI is revolutionizing the way Saudi consumers order food, how restaurants manage their operations, and how delivery partners navigate the bustling streets of cities like Riyadh, Jeddah, and Dammam. Through real-world case studies, we'll showcase how leading Saudi food delivery apps are leveraging AI to redefine convenience, personalization, and efficiency.
In the rapidly evolving landscape of technologies, XML continues to play a vital role in structuring, storing, and transporting data across diverse systems. The recent advancements in artificial intelligence (AI) present new methodologies for enhancing XML development workflows, introducing efficiency, automation, and intelligent capabilities. This presentation will outline the scope and perspective of utilizing AI in XML development. The potential benefits and the possible pitfalls will be highlighted, providing a balanced view of the subject.
We will explore the capabilities of AI in understanding XML markup languages and autonomously creating structured XML content. Additionally, we will examine the capacity of AI to enrich plain text with appropriate XML markup. Practical examples and methodological guidelines will be provided to elucidate how AI can be effectively prompted to interpret and generate accurate XML markup.
Further emphasis will be placed on the role of AI in developing XSLT, or schemas such as XSD and Schematron. We will address the techniques and strategies adopted to create prompts for generating code, explaining code, or refactoring the code, and the results achieved.
The discussion will extend to how AI can be used to transform XML content. In particular, the focus will be on the use of AI XPath extension functions in XSLT, Schematron, Schematron Quick Fixes, or for XML content refactoring.
The presentation aims to deliver a comprehensive overview of AI usage in XML development, providing attendees with the necessary knowledge to make informed decisions. Whether you’re at the early stages of adopting AI or considering integrating it in advanced XML development, this presentation will cover all levels of expertise.
By highlighting the potential advantages and challenges of integrating AI with XML development tools and languages, the presentation seeks to inspire thoughtful conversation around the future of XML development. We’ll not only delve into the technical aspects of AI-powered XML development but also discuss practical implications and possible future directions.
Driving Business Innovation: Latest Generative AI Advancements & Success StorySafe Software
Are you ready to revolutionize how you handle data? Join us for a webinar where we’ll bring you up to speed with the latest advancements in Generative AI technology and discover how leveraging FME with tools from giants like Google Gemini, Amazon, and Microsoft OpenAI can supercharge your workflow efficiency.
During the hour, we’ll take you through:
Guest Speaker Segment with Hannah Barrington: Dive into the world of dynamic real estate marketing with Hannah, the Marketing Manager at Workspace Group. Hear firsthand how their team generates engaging descriptions for thousands of office units by integrating diverse data sources—from PDF floorplans to web pages—using FME transformers, like OpenAIVisionConnector and AnthropicVisionConnector. This use case will show you how GenAI can streamline content creation for marketing across the board.
Ollama Use Case: Learn how Scenario Specialist Dmitri Bagh has utilized Ollama within FME to input data, create custom models, and enhance security protocols. This segment will include demos to illustrate the full capabilities of FME in AI-driven processes.
Custom AI Models: Discover how to leverage FME to build personalized AI models using your data. Whether it’s populating a model with local data for added security or integrating public AI tools, find out how FME facilitates a versatile and secure approach to AI.
We’ll wrap up with a live Q&A session where you can engage with our experts on your specific use cases, and learn more about optimizing your data workflows with AI.
This webinar is ideal for professionals seeking to harness the power of AI within their data management systems while ensuring high levels of customization and security. Whether you're a novice or an expert, gain actionable insights and strategies to elevate your data processes. Join us to see how FME and AI can revolutionize how you work with data!
For the full video of this presentation, please visit: https://www.edge-ai-vision.com/2024/06/building-and-scaling-ai-applications-with-the-nx-ai-manager-a-presentation-from-network-optix/
Robin van Emden, Senior Director of Data Science at Network Optix, presents the “Building and Scaling AI Applications with the Nx AI Manager,” tutorial at the May 2024 Embedded Vision Summit.
In this presentation, van Emden covers the basics of scaling edge AI solutions using the Nx tool kit. He emphasizes the process of developing AI models and deploying them globally. He also showcases the conversion of AI models and the creation of effective edge AI pipelines, with a focus on pre-processing, model conversion, selecting the appropriate inference engine for the target hardware and post-processing.
van Emden shows how Nx can simplify the developer’s life and facilitate a rapid transition from concept to production-ready applications.He provides valuable insights into developing scalable and efficient edge AI solutions, with a strong focus on practical implementation.
Infrastructure Challenges in Scaling RAG with Custom AI modelsZilliz
Building Retrieval-Augmented Generation (RAG) systems with open-source and custom AI models is a complex task. This talk explores the challenges in productionizing RAG systems, including retrieval performance, response synthesis, and evaluation. We’ll discuss how to leverage open-source models like text embeddings, language models, and custom fine-tuned models to enhance RAG performance. Additionally, we’ll cover how BentoML can help orchestrate and scale these AI components efficiently, ensuring seamless deployment and management of RAG systems in the cloud.
Ivanti’s Patch Tuesday breakdown goes beyond patching your applications and brings you the intelligence and guidance needed to prioritize where to focus your attention first. Catch early analysis on our Ivanti blog, then join industry expert Chris Goettl for the Patch Tuesday Webinar Event. There we’ll do a deep dive into each of the bulletins and give guidance on the risks associated with the newly-identified vulnerabilities.
Taking AI to the Next Level in Manufacturing.pdfssuserfac0301
Read Taking AI to the Next Level in Manufacturing to gain insights on AI adoption in the manufacturing industry, such as:
1. How quickly AI is being implemented in manufacturing.
2. Which barriers stand in the way of AI adoption.
3. How data quality and governance form the backbone of AI.
4. Organizational processes and structures that may inhibit effective AI adoption.
6. Ideas and approaches to help build your organization's AI strategy.
Climate Impact of Software Testing at Nordic Testing DaysKari Kakkonen
My slides at Nordic Testing Days 6.6.2024
Climate impact / sustainability of software testing discussed on the talk. ICT and testing must carry their part of global responsibility to help with the climat warming. We can minimize the carbon footprint but we can also have a carbon handprint, a positive impact on the climate. Quality characteristics can be added with sustainability, and then measured continuously. Test environments can be used less, and in smaller scale and on demand. Test techniques can be used in optimizing or minimizing number of tests. Test automation can be used to speed up testing.
AI 101: An Introduction to the Basics and Impact of Artificial IntelligenceIndexBug
Imagine a world where machines not only perform tasks but also learn, adapt, and make decisions. This is the promise of Artificial Intelligence (AI), a technology that's not just enhancing our lives but revolutionizing entire industries.
Have you ever been confused by the myriad of choices offered by AWS for hosting a website or an API?
Lambda, Elastic Beanstalk, Lightsail, Amplify, S3 (and more!) can each host websites + APIs. But which one should we choose?
Which one is cheapest? Which one is fastest? Which one will scale to meet our needs?
Join me in this session as we dive into each AWS hosting service to determine which one is best for your scenario and explain why!
How to Get CNIC Information System with Paksim Ga.pptxdanishmna97
Pakdata Cf is a groundbreaking system designed to streamline and facilitate access to CNIC information. This innovative platform leverages advanced technology to provide users with efficient and secure access to their CNIC details.
Full-RAG: A modern architecture for hyper-personalizationZilliz
Mike Del Balso, CEO & Co-Founder at Tecton, presents "Full RAG," a novel approach to AI recommendation systems, aiming to push beyond the limitations of traditional models through a deep integration of contextual insights and real-time data, leveraging the Retrieval-Augmented Generation architecture. This talk will outline Full RAG's potential to significantly enhance personalization, address engineering challenges such as data management and model training, and introduce data enrichment with reranking as a key solution. Attendees will gain crucial insights into the importance of hyperpersonalization in AI, the capabilities of Full RAG for advanced personalization, and strategies for managing complex data integrations for deploying cutting-edge AI solutions.
Removing Uninteresting Bytes in Software FuzzingAftab Hussain
Imagine a world where software fuzzing, the process of mutating bytes in test seeds to uncover hidden and erroneous program behaviors, becomes faster and more effective. A lot depends on the initial seeds, which can significantly dictate the trajectory of a fuzzing campaign, particularly in terms of how long it takes to uncover interesting behaviour in your code. We introduce DIAR, a technique designed to speedup fuzzing campaigns by pinpointing and eliminating those uninteresting bytes in the seeds. Picture this: instead of wasting valuable resources on meaningless mutations in large, bloated seeds, DIAR removes the unnecessary bytes, streamlining the entire process.
In this work, we equipped AFL, a popular fuzzer, with DIAR and examined two critical Linux libraries -- Libxml's xmllint, a tool for parsing xml documents, and Binutil's readelf, an essential debugging and security analysis command-line tool used to display detailed information about ELF (Executable and Linkable Format). Our preliminary results show that AFL+DIAR does not only discover new paths more quickly but also achieves higher coverage overall. This work thus showcases how starting with lean and optimized seeds can lead to faster, more comprehensive fuzzing campaigns -- and DIAR helps you find such seeds.
- These are slides of the talk given at IEEE International Conference on Software Testing Verification and Validation Workshop, ICSTW 2022.
Cosa hanno in comune un mattoncino Lego e la backdoor XZ?Speck&Tech
ABSTRACT: A prima vista, un mattoncino Lego e la backdoor XZ potrebbero avere in comune il fatto di essere entrambi blocchi di costruzione, o dipendenze di progetti creativi e software. La realtà è che un mattoncino Lego e il caso della backdoor XZ hanno molto di più di tutto ciò in comune.
Partecipate alla presentazione per immergervi in una storia di interoperabilità, standard e formati aperti, per poi discutere del ruolo importante che i contributori hanno in una comunità open source sostenibile.
BIO: Sostenitrice del software libero e dei formati standard e aperti. È stata un membro attivo dei progetti Fedora e openSUSE e ha co-fondato l'Associazione LibreItalia dove è stata coinvolta in diversi eventi, migrazioni e formazione relativi a LibreOffice. In precedenza ha lavorato a migrazioni e corsi di formazione su LibreOffice per diverse amministrazioni pubbliche e privati. Da gennaio 2020 lavora in SUSE come Software Release Engineer per Uyuni e SUSE Manager e quando non segue la sua passione per i computer e per Geeko coltiva la sua curiosità per l'astronomia (da cui deriva il suo nickname deneb_alpha).
Let's Integrate MuleSoft RPA, COMPOSER, APM with AWS IDP along with Slackshyamraj55
Discover the seamless integration of RPA (Robotic Process Automation), COMPOSER, and APM with AWS IDP enhanced with Slack notifications. Explore how these technologies converge to streamline workflows, optimize performance, and ensure secure access, all while leveraging the power of AWS IDP and real-time communication via Slack notifications.
2. Who’s Talking ?
• Jang F.M. Graat
• Tech Comms
• Structured Frame
• DITA, XSLT, JS, CSS
• RoboHelp, MadCap
• Minimalist
• Philosopher
2
After studying Physics, Psychology and Philosophy it was time for me to get a paid job. Lady
Luck put me on a fast track into the high-tech computer industry, where I embarked on a
career in technical communication that took me around the globe many times. I have taught
myself all I need to know and I specialize in teaching techie stuff to not-so-techie audiences.
3. Progressive Disclosure
Some Everyday Examples
3
Progressive disclosure is not very new, but in the technical communication domain it is not
widely used yet. But we all know the principles, which may become clear by looking at some
everyday examples we will all know, but might not recognize as being progressive disclosure
techniques.
4. Getting Started
4
The first example is literally when we get started in our daily jobs. Well, most of us get
started this way (some keep running all night long).
5. 5
I like to keep my desktop pretty clean. No shortcuts to dozens of programs or files, as I do
not need most of them all the time. My desktop expresses my tendency to minimalism: only
show me the info I need right now. After Windows has started, this is what I see. A minimal
set of options to choose from. To start an application in Windows, I click on the Start button.
6. 6
The Start menu shows me the most used applications in a short list. Next to the list are some
other areas that I might want to explore, but let’s stick with the applications for the moment.
I can start any of these by clicking on the application name.
7. 7
If I want to open an application that is not in the most-used list, there is always the option
view the full list of applications via the All Programs entry at the bottom.
8. 8
But even this list may become very long and to prevent a lot of scrolling and searching, many
applications are organized in separate folders.
9. 9
Clicking on one of the folders reveals its content. There may be nested folders, so the
process continues until I have found what I am looking for.
10. 10
If I did not find what I was looking for, or changed my mind, I can still return to the previous
view via the “Back” option at the bottom. This might seem trivial but is an important aspect of
progressive disclosure: you should always offer the user a way back.
11. 11
One more detail of progressive disclosure in the Windows Start menu is the feature that
keeps a list of recently opened files. If the application has such a list, the Start menu includes
it and offers a direct way into the list by hovering over the arrow to the right.
12. 12
From here, I can open a document in the application with one click. The whole process shows
how the options that are shown are controlled by me, the user. At every click, another part of
the available options are revealed.
13. Booking a Train Ticket
13
We can see good examples of progressive disclosure on the web, too. The website I will show
you offers train tickets via the internet. The design had to enable people to interact with the
selling software in more or less the same way that they would when purchasing a ticket from
a counter with a human being to interpret what they want.
14. 14
After entering my point of departure, destination and travel dates, the Deutsche Bahn website
shows me a list of available train connections. It immediately includes pricing information
when available, plus number of transfers and total travel time. For most purposes, this
information is sufficient to make a decision and move toward booking the train ticket.
15. 15
If I want to see the route and how much transfer time I have between trains, I can click on the
arrow in front of the indicated train schedule. This opens a section on the page that was
previously hidden. Here I have details about each of the trains available. The information that
was already visible is not replaced, and there is always the option to hide the extra info again.
16. Embedded Assistance
16
Progressive disclosure gets more interesting in areas where the user might not completely
know what they are looking for. Early attempts to create so-called Wizards were not always
succesful (who ever found Clippy or the cute but stupid little dog in MS Office useful ?). There
are some examples where integration between the software, documentation of that software
and user assistance have been implemented in just the right way.
17. 17
This is my MacBook Air desktop. The menu bar shows symbols for basic services, such as the
WiFi connection. The symbol itself shows whether I have a connection and how strong the
signal is. If there is a problem with the internet, there will be an exclamation mark on the
symbol.
18. 18
If I want to do something about the WiFi connection, I can open the menu via the same
symbol. Apart from joining another network or switching my WiFi off, I can also open the
Network Preferences page in the System Preferences.
19. 19
On the Network Preferences page, I can see all network connections with their status, plus a
limited amount of information that I might be looking for. There are some general options
that I can switch on or off here, and for an option that might not be immediately clear there is
a short text to explain what the option will achieve. If I am looking for technical details about
the connection, I can click on the Advanced button near the bottom.
20. 20
This pulls down a panel with multiple pages, each of which has a lot of technical information
available. The pages allow making changes and do not offer a lot of extra explanations, as
people handling these settings should know what they are doing. Making the pages look
more technical does keep newbies from making any changes here. Clicking Cancel or OK
makes the panel move up again and returns to the Network Preferences screen.
21. 21
For the non-techies, a wizard or assistant is included. Clicking the button Assist me brings
up a question which type of assistant the user needs, as there may be various reasons why
the Network Preferences were opened in the first place. Note that if there is a problem with
the connection, clicking the failed network icon allows jumping straight into the Diagnostics
wizard.
22. 22
If I choose to set up a new network, the assistant shows me basic information and asks me to
supply a name. The buttons Go Back and Continue are always available. I always have a way
to return to the previous step, which is very important in progressive disclosure.
23. 23
The dialog that opens via the More Info button shows a short description of the parameter
that is required in this step of the process. The window of the Network Setup Assistant is not
hidden or changed: the panel slides down out of the window’s title bar and slides up again
when clicking OK. Nothing in this process should scare the newbie users or give them the
impression that they have done something that cannot be undone.
24. 24
Steps that involve a choice between various options are shown in a language that does not
contain too many techie words, or explains those words where needed. Each step in the
Network Setup Assistant covers one single choice or one single entry. And there is always a
button to show More Info. This is progressive disclosure at its best.
25. Minimalism
Main Principles
25
The paradigm that lies at the basis of progressive disclosure is minimalism. Without redoing
my presentation about minimalism at past tcworld events, I will briefly indicate the main
principles of minimalism. Those principles should be kept in the back of your mind always,
even when you are not working on progressive disclosure.
26. Action-Oriented
26
First principle: your user assistance should focus on doing things. Users are not browsing
your help system because they enjoy doing it and have nothing better to do. Users who call
up the user assistance have a problem that they need to solve, and normally they are in a
hurry. Don’t explain how a feature works if the user does not need to have that knowledge to
succesfully use the feature. I don’t know how a combustion engine works but I can still drive
a car.
27. Support Error Recovery
27
A user may not know that they have made an error until it is too late. You should include
enough information so that the user can confirm there was no error (e.g. showing a step
result) and indicate what to do when they have discovered something is wrong. A basic
technique in Progressive Disclosure that rests on this principle is always providing a way to
go back to the previous step.
28. Reading-to-do
28
This ties in with the first principle: users do not open the user assistance to kill the time, they
read the instructions to solve a problem and get ahead with their work. An assistant that
takes the user out of their own documents or tasks and merely wants to educate the user
based on an abstract example is useless to most users. Wherever you can, allow the user to
perform steps and return to your assistant for more information after doing so.
29. Dynamic HTML
HTML, CSS, DOM, JavaScript
29
Good Progressive Disclosure takes a lot of work to implement, and you probably need to do it
in close cooperation with the software developers of the application you are documenting. In
this tutorial, we are going to look at the basic techniques you can use without depending on
the developers’ time and cooperation. The technical components for this level of progressive
disclosure are HTML, CSS, DOM and JavaScript. Let’s look at each of them and then at what
the combination of these techniques can achieve.
30. HTML
30
The first technology that is required is HTML, HyperText Markup Language. Defined in the
early days of internet, when there was no World-Wide Web yet. HTML allowed the WWW to
come into existence, as it established a standard platform to display information and to
create hyperlinks that take you from one document to another (wherever that may be). The
above picture is NOT the inventor of the world-wide-web, Mr Tim Berners-Lee.
31. 31
HTML should be familiar to everyone in this audience. Basically, each element is wrapped in
tags that determine the formatting in a browser. The above example is what we will be using
throughout most of this tutorial. It shows a task with a number of steps and substeps.
32. 32
This is what the HTML looks like in my Firefox browser. Nothing special, but then we have not
added any fancy stuff to it yet, and there are no hyperlinks (as we do not need them here).
33. Cascading Style Sheet
33
The next component we need to make things interactive is a CSS. The name derives from the
top-down manner in which styles are defined. Properties for the entire page can be changed
for lower-level element types and even for individual elements on the page. The element
inherits the properties from the higher-level element but can override them (and pass them
down to its own children).
34. 34
The HTML page can be linked to a CSS that describes the formatting properties of particular
elements. In the CSS, there are various ways to address particular sets of elements, such as a
list item inside an ordered list (ol li). In the above example, each list item gets the left margin
of 20px. When the list item is in an ordered list it will have 10px padding at the top, whereas
the top padding is 0px for list items in an unordered list.
35. 35
The result of this CSS with the same HTML (well, we did put the link to the CSS in) in the same
browser is this. The browser takes the properties that are defined in the CSS to override the
default formatting properties for the HTML elements it finds.
36. Document Object Model
36
The DOM describes the organization of elements in your document on an abstract level. It
allows the browser to find all elements in a page and know which element is a child or parent
or sibling of another. The DOM is a universal roadmap for a structured document and allows
software to find their way around the contents of actual documents.
37. 37
Bringing HTML and CSS together taking the DOM into account. The CSS can pass properties
for particular elements in the document via their element tags, their location in the hierarchy,
their class attribute and/or their id attributes. This makes for a wide variety of formatting
that can be relatively easy controlled and assigned.
38. 38
The code shown on the previous page, viewed in a browser. The buttons in the menu bar are
activated or deactivated depending on where you are in my website. The language buttons
take you to the same page in another language. All styling is defined in the CSS.
39. JavaScript
39
JavaScript was developed to add interactivity to HTML pages. With JavaScript, contents of a
page can be changed without loading another page. Many properties of elements of the page
can be addressed and changed and actions can be linked to objects on the screen. This gives
us the interactivity we need to implement Progressive Disclosure.
40. 40
The JavaScript code can either be linked to the HTML page or embedded in a <script>
element. There is no functional difference between the two. The above code shows how a
piece of the HTML page is used as a trigger, and another piece is shown or hidden when the
trigger is clicked. Also, the text that serves as the trigger is changed by the JavaScript.
41. Drop-Down Content
41
The page shown in a browser. Clicking on “Show paragraph” makes the drop-down content
appear and changes the text of that paragraph. Clicking the paragraph again reverses the
action. Of course, nesting is an option as well: content in the hidden text may be used as a
trigger to show another piece of content, such as an image. Also, icons or images can be
used as triggers to reveal hidden content or hide it again.
42. Layered Content
42
With CSS3, layers were introduced. Basically, the 2D world of the screen turned into 3D at
that moment, as sections of the webpage were given an optional depth position index.
Placing a layer on top of others but making it hidden allows a trigger to make it appear. Don’t
forget to include a method to make it disappear again.
43. Making it Work
in Adobe RoboHelp HTML 10
43
Now that we have seen the basic principles at work in Progressive Disclosure (showing and
hiding content without leaving the page), let’s see how this can be implemented using Adobe
RoboHelp HTML. The tutorial includes a live demo, but this PDF includes screenshots of the
stages instead.
44. 44
Drop-Down Text
RoboHelp offers drop-down text since a long time. This was part of DHTML, an unofficial
extension on early HTML using JavaScript to make it work. With a little effort, you can get
around some of the shortcomings of this implementation and make it look like the goal we
set out to achieve.
45. 45
enter the always-visible text
RoboHelp HTML allows you to enter Drop-Down text in a small editor window. This is easiest
done when the disclosable text is not there yet. So we start with a topic with only the steps
that are shown when the page will be loaded.
46. 46
select the hotspot text
and create the drop-down
Select the step text and choose Create Drop-down Hotspot and Text from the DHTML menu.
47. 47
enter the drop-down text
A small editor window appears in which you can enter the text to be shown or hidden when
the trigger is clicked. The editor allows most of the actions you would do in the main editor
window, so you can insert images, links to other pages, and insert a nested drop-down text.
48. 48
click outside mini-editor
to hide the drop-down text
Click outside the mini-editor to close it. A disadvantage is that the drop-down text is no
longer visible in your source. The styling sort of indicates it, but might also be applied
manually or indicate a glossary term, a pop-up link or expanding text. It takes several clicks
to see the hidden content in your source material.
49. 49
drop-down text can be nested
It is possible to enter multiple levels of drop-down text. In the mini-editor, select the word(s)
that should work as the trigger and choose the Create Drop-down Hotspot and Text
command again. As far as I can tell, there is no limit to the nesting levels (but your users may
not like all the clicking).
50. 50
not only text can drop down
The mini-editor allows most functions that are normally available, so you can insert an image
instead of text (or use both).
51. 51
resulting WebHelp in a browser
The resulting WebHelp shows like this. The first and second step each have their substeps
hidden. Clicking the step opens and closes its substeps.
52. 52
resulting WebHelp in a browser
The drop-down text appears immediately after the paragraph that contains the trigger. In
this case, the image appears between the substeps. There is no way to change this in
RoboHelp.
53. 53
Triggers and Targets
RoboHelp has another method that should be covered here: triggers and targets. The names
were maybe not chosen very wisely, but let’s see how the implementation was done and how
it can help us achieve the goal of progressive disclosure.
54. 54
add target and trigger images
Start by adding the target (which must be an image or a table) to your source. Also add a
trigger (which must be an image) to the text line. I chose to add a small question mark at the
end of the first substep.
55. 55
select the trigger image
Selecting an image makes the so-called cable drum appear. The drum is green, meaning it is
not connected to a target yet.
56. 56
pull a link to the target
Drag the mouse from the cable drum to the target. When a valid target is reached, its
bounding box is shown in green. The target is selected when releasing the mouse.
57. 57
select the show/hide effect
Choose one of the available effects for the target appearance. I suggest NEVER using anything
other than Show/Hide. Your help system is not created for entertainment but for usefulness.
58. 58
ready to build the output
The target is marked as being connected to a trigger. Now we can build the WebHelp again.
59. 59
resulting WebHelp in browser
The resulting WebHelp page in a browser. The empty space is the space taken up by the still
invisible target.
60. 60
clicking the trigger makes
the target appear/disappear
Clicking the trigger image makes the target appear. Clicking again makes it disappear.
61. 61
Useless for my Goal
Since the target takes up space even when it is hidden, this feature is useless for progressive
disclosure. If RoboHelp would support layers, I could position the target on top of other
content so that there would not be empty space. But layers are not supported. Also, I cannot
use words or sentences as triggers, and I cannot use anything but images or tables as
targets.
62. 62
Perfecting the Appearance
Instead of words or entire sentences behaving like the hotspots, I wanted to use a number of
small icons. I could have chosen Wingdings or Zapf Dingbats, but I don’t want to run the risk
that an unavailable font causes garbage on the screen in your browser. Also, I want to apply
some background coloring and padding to the drop-down text to make it stand out.
63. Images ≠ Text
63
In RoboHelp, I can only use text as the hotspot for drop-down content. Images can only be
used as triggers for targets, and we’ve seen that this feature is useless for our goal. So how
do I get over this seemingly impossible dilemma?
64. 64
select icon image plus space
To change the drop-down hotspot into an image, insert the image but make sure to select
some text as well (otherwise, the Insert Drop-down Hotspot and Text command remains
disabled). A space in front of the image is all it takes to make it work.
65. 65
The mini-editor also allows formatting of the text that will be revealed, to make it stand out
from the surrounding text. All normal formatting options are available. This shows how to
add background color (shading) and padding to the drop-down text.
67. 67
Using Pop-ups
RoboHelp offers various ways of creating pop-up elements. These may be useful for
progressive disclosure as they do not take the user off the page - which is one of the
defining principles of progressive disclosure.
68. 68
Select a piece of text (use the trick with the space plus an icon image again) and select “Text-
only Pop-up” from the Insert menu. Pros: entering the text is done on the spot. Cons: no
images, no styling, no influence on anything except the text.
69. 69
The result is not overwhelmingly satisfying, but as noted you have no influence on the styling
(except if you to some heavy-duty CSS tweaking).
70. 70
The only other option is to first put the text (including the images, styling etc.) in a new topic
(to which you have to apply another master page to get rid of all kinds of auto-insertions by
RoboHelp - you may also have to define a separate CSS for this type of topic). Then create a
hyperlink to a pop-up. Optionally, you can set the size for the pop-up explicitly (but that
takes a lot of trial and error).
71. 71
Without the heavy-duty CSS work, the result, again, is not something that makes me very
happy. I seriously miss the layering techniques in RoboHelp. You could perhaps bring those
in via the CSS backdoor but that level of tweaking is beyond the scope of this tutorial.
72. Making it Work
in MadCap Flare 9
72
Note: the output shown in some of the following slides was created using a trial version of
MadCap Flare 9. The trial randomly changes characters in the output. This is not a bug in the
software or an effect of the techniques I have used.
74. 74
enter the always-visible text
MadCap Flare offers the same Drop-down text option as RoboHelp HTML. To use this option,
I first create the text that should always appear on the page. These are the main procedure
steps.
75. 75
select the drop-down hotspot
Before adding substeps, I have to create a drop-down text placeholder for them. Select the
text that should become the trigger for the drop-down text to appear. Then make sure the
Insert ribbon is shown and select Drop-Down Text in the Text section of this ribbon. NOTE: it
has to be a <p> to work. You cannot create a Drop-Down Text when selecting a <li> or a
single word.
76. 76
Unlike RoboHelp HTML, the editor that appears does not allow entering the drop-down text
itself. It only allows selecting part of the already selected text as the drop-down hotspot. This
does make the dialog just a little superfluous. Just click OK to insert both the hotspot and the
drop-down placeholder text.
77. 77
drop-down text placeholder is added
MadCap Flare adds a so-called toggler image in front of the selected hotspot text and makes
the selected text appear as a clickable link. The drop-down placeholder text is shown directly
below the paragraph that holds the hotspot. This paragraph can now be edited.
78. 78
edit the drop-down text
The paragraph can be changed into anything, such as a bullet list or a complete section.
79. 79
build the primary output
Once the drop-down text is finished, select the Project ribbon and click Build Primary to
generate output.
80. 80
If the Build did not generate any errors, click View Output to see the resulting page in your
browser.
81. 81
resulting WebHelp in a browser
The first step with substeps in a drop-down section shows up like this. Both the toggler
image and the step text are clickable and make the drop-down text appear or disappear.
82. 82
resulting WebHelp in a browser
The toggler image is replaced by another one that shows the hidden content is now shown.
83. 83
Using Togglers
Instead of using the standard Drop-Down Text method, which has its limitations, MadCap
also offers a more intelligent way of changing the visibility of items on the screen. This is
done by inserting Togglers and connecting them to named elements.
84. 84
enter the target text for the toggler first
When using togglers, the destination for the toggler has to be available beforehand. So I
enter the substeps in step 2 first.
85. 85
set a name (identifier) for the target
The toggler is connected to the target by an identifier, which has to be set before I can link to
it. Select the entire element that should be shown or hidden, make sure the Home ribbon is
visible, and select the Name option in the Attributes section of the ribbon.
86. 86
Give the element an intelligible name, so that you will be able to find it later, when linking the
right toggler to the right target.
87. 87
flag symbols indicate named elements
The unordered list with substeps is now named. This is shown by a flag symbol (which does
not appear in the output).
88. 88
set the location to insert the toggler
I want to add the toggler at the end of the step, so I place the cursor there. Make sure the
Insert ribbon is visible and select the Toggler function in the Text section of the ribbon.
89. 89
The Toggler mechanism inserts a pretty stupid text “Click Me!” and allows you to point to the
named target that should be shown or hidden when the toggler is clicked. Do not worry
about the text at this point, as it remains editable and we will replace it with an image in the
end. Click OK to insert both the toggler image and toggler text and link it with the named
target. The properties of the named target are set accordingly.
90. 90
replace “Click Me!” but leave one space
To replace the stupid “Click Me!” toggler text with an image, you have to take a little care.
Selecting the entire text and then inserting an image (replacing the selected text) removes
the toggler as well. You can either insert the image first and then remove the text or remove
the text but leave at least one space before inserting the image.
91. 91
insert the icon image in the toggler
The image is now shown next to the toggler image. Switch to the Project ribbon to generate
the Primary Build again.
92. 92
resulting WebHelp in a browser
The resulting page in my browser. Both the toggler image and my own image are shown at
the end of the step.
93. 93
resulting WebHelp in a browser
Clicking either the toggler image or my own image (or the space inbetween) makes the
hidden text visible. Note that with this mechanism, the hidden text does not have to be
immediately below the toggler, as is the case with Drop-Down Text.
94. 94
Toggler hotspots and targets can be nested, as shown in the above example. Each element
that shows a flag is a potential target.
95. 95
Each toggler can be connected to one or more targets. This allows having one global “Show/
hide all substeps”, or allowing the user to select their expertise level with just one click.
97. 97
Perfecting the Appearance
Even though the automatic toggler images are not completely off the mark, they are all the
same. I want to use the image to indicate the type of information to be disclosed. So I added
my own icons. This makes the togger images obsolete - so I need to make them go away.
98. 98
edit the Master Stylesheet
The automatic toggler images must be removed in the Master CSS. This can be opened via
the Project ribbon.
99. 99
Scroll down the Styles list and select the “MadCap | toggler” class. The properties are shown
to the right (choose “Show Assorted Relevant Properties” above the list). Make sure both the
“mc-open-image” and the “mc-closed-image” are set to (none). Save the style sheet and
rebuild the target to see the effect of this change.
100. 100
resulting WebHelp in a browser
This is the resulting page in my browser. Note that the toggler image for the drop-down text
is not changed, only the one for the toggler hotspot has been removed. My image now
functions as the hotspot.
101. 101
resulting WebHelp in a browser
Clicking the hotspot image makes the target element visible. Clicking it again hides the
target element. The element can be anywhere on the page, as the toggler is linked to the
target via identification.
102. Conclusions
Pros, Cons and Feature Requests
102
My conclusions are based on this trial in making progressive disclosure work only. For all
other purposes, there may be other lists of strengths and weaknesses. Also, I must note that I
have slightly more experience in using RoboHelp than I have in using MadCap Flare.
103. Drop-down text editing
Multi-screen target builds
Control over positioning
Pop-ups
Triggers and targets
Layers instead of pop-ups
103
RoboHelp HTML 10
105. Questions ?
www.writeless.eu
www.jang.nl
jang@jang.nl
4everJang
blogs.jang.nl
105
If you need more info, advice, or training on any of the aspects covered in this tutorial, feel
free to contact me. I offer in-house training and I do projects covering all aspects of bringing
valuable information to users in a minimalist paradigm - maximizing the usefulness.