Contextualized help must be written solely with the user experience in mind. While this may be obvious and seem applicable to all help content, this mindset is especially important when writing contextualized help.
Imagine your user on a journey. He opens a product for the first time. What does he need to know?
Contextualized help is not about giving the user everything he must know, but rather giving the user what he needs at that moment.
Contextualized help can be as simple as “Click here to publish.”
Or it could provide steps to publishing.
Or it could provide the result of taking an action, such as “When you click publish, you’ll get a .zip file”.
Keep in mind the physical “real estate” users will have when viewing contextualized help. Information should be brief and clear.
If you know users will always see your contextualized help on a medium to large screen size, you can include links and “See More” information.
If users may be viewing contextualized help on a tablet or small mobile device, contextualized help should be no more than a few words or phrases.