Greg DeVore

By: Greg DeVore on October 5th, 2016

Print/Save as PDF

Condense Your Documentation with Foldable Sections

  

 

 

 

About a year ago, we started grappling with the problem of long articles. Sometimes, a short article just wouldn't cut it--you need a lengthy onboarding guide or a long procedure that has a lot of content. The question became, "how can one best present lengthy content to the end user?"

 Endless_content.gif

Because if articles are too long, they force the reader to endlessly scroll down the page. All of that scrolling can be confusing, and readers can quickly lose track of what they are even looking at. So we wanted to fix that.

One option was to split the article up into multiple articles in a manual. This approach would let a reader finish an article, and then hit next. The problem we saw was that, often times, readers would either land in the middle of a lengthy process (from searching a keyword the knowledge base and clicking on an article), or they would get lost somewhere in the process and lose track of where they were.

So, after a lot of discussion, we opted to go with the concept of foldable sections in an article. What this allows you to do is write a very long article, such as an onboarding guide, but make each section of it just show up as a heading/title in the article. When a reader clicks on the heading/title, the section expands to show content below it.

Foldable_Section.gif

Foldable sections allow you to present very complex, or lengthy information, in a more digestible format. Your readers can more easily arrive at exactly what they need, but also not lose themselves in the bigger scheme of things. 

Only in ScreenSteps 4

Foldable sections are a new feature in the ScreenSteps 4 article editor. They work both inside of ScreenSteps articles and inside of Zendesk Help Center (when you publish to Zendesk from ScreenSteps).  

Reduce Article Count

So far, the feedback from customers has been really great. Check out this example from one of our customers,  BambooHR. Toward the bottom of that article, you can see the foldable sections in action. It's easy to see how foldable sections can help reduce the total number of articles by condensing information.

The real advantage is that it lets you present complex information in a simplier, easier to read format. It is perfect for an onboarding guide, for a training document explaining different aspects of your system, or for lengthy procedures that people need to follow. 

We also use them for FAQ type pages. For example, we have a list of CSS customizations that you can make to your ScreenSteps site, and each customization is a foldable section. By having the foldable sections, we can make the listing of possible customizations very short, and then all you have to do is click on the title to quickly see the CSS you need to copy into your site for that customization. 

So, if you haven't tried out foldable sections yet, then I suggest you check it out. I think you will find it's a great way to present complex information to your customers, and make it easier for them to understand and implement.

Learn How to Create an Engaging and Effective Live Salesforce Training  Your attendees and your boss will thank you Download Now

About Greg DeVore

CEO of ScreenSteps