--- title: One Reason Nobody Uses Your Salesforce Documentation description: Break up long articles that cover a few topics and/or tasks, into mini articles that answer one specific question. image: https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/84e74f5f-3405-4466-9178-320897cec338_display.png --- [![ScreenSteps](https://sf.screensteps.com/hubfs/2025/2025%20Logo/Full%20Logo/SVG/ScreenSteps-Logo-BlackGreen_2025.svg "ScreenSteps")](https://www.screensteps.com/) [Salesforce Training Consulting](https://www.screensteps.com/consulting/salesforce-training) [Learn about ScreenSteps](https://www.screensteps.com/salesforce) ## [A Salesforce Admin's Resource](https://sf.screensteps.com) ### See better results from your live Salesforce training # One Reason Nobody Uses Your Salesforce Documentation - [Tweet](https://twitter.com/share) Posted by [Jonathan DeVore](https://sf.screensteps.com/author/jonathan-devore) February 12, 2014 at 1:00 PM Even though you documented everything with pictures, annotations, and clear text, a common situation you will find is that end users don't reference your documentation. All of that time invested in creating a knowledge base, yet you continue to waste time fielding the same questions about how to do something in Salesforce (or you get crummy results because folks aren't following directions). One reason might be that your articles are too long, making it difficult to find relevant information or see important details. To solve this problem, I recommend breaking up long articles that cover a few topics and/or tasks, into mini articles that each answer one specific question. ## Articles shouldn't be too long This is not an everlasting truth - but it is best practice the majority of the time. Here's an example of an article from my [Salesforce knowledge base](http://docs.screenstepslive.com/s/4639) that was too long. When I wrote it, I figured I would cover adding, removing, and reorganizing the tabs in the top navigation of Salesforce. But after I read through it, I realized it covered too much. ### How to Add, Remove, and Arrange Tabs (objects) in top navigation #### Click the + button [![](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/dc4d735c-81a3-41bd-9e1c-25caeea71088_display.png)](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/dc4d735c-81a3-41bd-9e1c-25caeea71088.png) #### Click Customize My Tabs [![](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/025cfb57-8fc9-49ce-bd09-b6079e1d12c6_display.png)](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/025cfb57-8fc9-49ce-bd09-b6079e1d12c6.png) #### Add the tab 1. Click the tab you want to add 2. Click the add arrow 3. Click save [![](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/26e508f8-e569-48e7-a161-8fd3909aab80_display.png)](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/26e508f8-e569-48e7-a161-8fd3909aab80.png) #### Remove tabs 1. Click the tab you want to remove 2. Click the remove arrow 3. Click save [![](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/84e74f5f-3405-4466-9178-320897cec338_display.png)](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/84e74f5f-3405-4466-9178-320897cec338.png) #### Move tab location If you want to rearrange where the tabs show up along the top navigation, you can do that in the customize my tabs menu. [![](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/037f3917-8dc8-46cf-8821-489633a4e5a5_display.png)](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/037f3917-8dc8-46cf-8821-489633a4e5a5.png) #### Move the tab up or down 1. Select the tab 2. Click up or down 3. Click Save [![](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/cdadce0a-f2a6-429a-b12c-b4e6e72cb003_display.png)](https://s3.amazonaws.com/screensteps_live/images/docs/176463/1/rendered/cdadce0a-f2a6-429a-b12c-b4e6e72cb003.png) The article is too long, a little confusing, and if an end user wanted to see just how to rearrange the tabs (not add or remove tabs), he/she would have to read through a lot of information that wasn't pertinent - which means he/she may never find the content. The result is that the end user will either ask me how to do it, or not do it at all. ## Break the article up I decided that this one article should really be three separate, shorter, more specific articles. So I broke them up into the following articles: - [How to **add** **tabs** to the top navigation](http://docs.screenstepslive.com/s/4639/m/17162/l/172838-how-to-add-more-tabs-objects-to-the-top-navigation) - [How to **remove** **tabs** from the top navigation](http://docs.screenstepslive.com/s/4639/m/17162/l/176403-how-to-remove-tabs-from-the-top-navigation) - [How to **rearrange** **tabs** in the top navigation](http://docs.screenstepslive.com/s/4639/m/17162/l/176404-how-to-change-the-order-of-tabs-in-the-top-navigation) Below is a short video that shows how I did it using ScreenSteps. All I have to do is drag and drop the steps to new articles and my knowledge base is instantly updated. So if your articles are getting a little long, think about breaking them up into miniature articles, each answering one specific question. ## The key to useful documentation The key to making documentation useful is to make it answer end users' questions - the more specific you can be, the better. In the past, documentation has been pretty general or all encompassing because it took too long to write a lot of little articles. But that's no longer the case. Writing documentation is easy, so write as much of it as you can, be as specific as you can, and your end users will reference it much more often. [![Subscribe to our Salesforce training blog](https://no-cache.hubspot.com/cta/default/120141/3468e7b0-231a-4d5f-b0df-47b40006bec9.png)](https://cta-redirect.hubspot.com/cta/redirect/120141/3468e7b0-231a-4d5f-b0df-47b40006bec9) - [Tweet](https://twitter.com/share) Topics: [Salesforce documentation tips](https://sf.screensteps.com/topic/salesforce-documentation-tips) ### Get Salesforce training tips and case studies delivered to your email inbox [![Learn How to Create an Engaging and Effective Live Salesforce Training Your attendees and your boss will thank you Download Now](https://no-cache.hubspot.com/cta/default/120141/d6dcd78e-c439-4766-b03f-a75d58b5e4b6.png)](https://cta-redirect.hubspot.com/cta/redirect/120141/d6dcd78e-c439-4766-b03f-a75d58b5e4b6) ### Recent Posts ### Posts by Topic - [Salesforce documentation tips (28)](https://sf.screensteps.com/topic/salesforce-documentation-tips) - [Live Training (22)](https://sf.screensteps.com/topic/live-training) - [Salesforce adoption (14)](https://sf.screensteps.com/topic/salesforce-adoption) - [Training Events (5)](https://sf.screensteps.com/topic/training-events) - [Training (4)](https://sf.screensteps.com/topic/training) - [Onboarding (2)](https://sf.screensteps.com/topic/onboarding) - [Teaching (2)](https://sf.screensteps.com/topic/teaching) - [Documentation (1)](https://sf.screensteps.com/topic/documentation) - [Learning (1)](https://sf.screensteps.com/topic/learning) - [Software Documentation Tips (1)](https://sf.screensteps.com/topic/software-documentation-tips) - [Webinar (1)](https://sf.screensteps.com/topic/webinar) [see all](https://sf.screensteps.com/one-reason-nobody-uses-your-salesforce-documentation#) ### Learn - [Webinars, Ebooks and Courses](https://www.screensteps.com/learning-resources) - [Company Blog](https://blog.screensteps.com) - [Docs that Rock Site](http://docs.bluemangolearning.com) - [Salesforce Adoption Blog](https://sf.screensteps.com) - [Additional Articles](https://www.screensteps.com/articles) ### Product - [Integrations](https://www.screensteps.com/integrations) - [Case Studies](https://www.screensteps.com/case-studies) - [API](http://help.screensteps.com/m/screenstepslive-api) - [Pricing](https://www.screensteps.com/pricing) ### Support - [Documentation](http://help.screensteps.com/) - [Forums](http://support.bluemangolearning.com/forums) - [Contact Support](https://www.screensteps.com/contact) - [Downloads](https://www.screensteps.com/downloads) ### About Us - [About Us](https://www.screensteps.com/contact) [![twitter](https://sf.screensteps.com/hs-fs/file-311419439-png/images/icons/twitter_icon.png)](https://twitter.com/screensteps)[![facebook](https://sf.screensteps.com/hs-fs/file-311421369-png/images/icons/fb_icon.png)](https://www.facebook.com/ScreenSteps) - Copyright @2014 Blue Mango Learning Systems, LLC - [Terms of Service](https://sf.screensteps.com/tos) - [Privacy Policy](https://sf.screensteps.com/privacy)