Customization Ribbon and Menus for Company Software

New Here ,
Apr 23, 2021 Apr 23, 2021

Copy link to clipboard

Copied

Does anyone have any experience with documenting company software, where the ribbon and menus can be customized?

Example:

Previously in a topic, I would've documented the navigation something like this:

From the  ribbon, select the Utility tab, then click the Ppr button. The Processor Front End screen (Figure 3) displays.

VeronicaJ_1-1619198685156.png

However, that button may or may not be under that tab, and I have no idea how the client would've customized their ribbon or menu.

 

I've placed a reminder in topics like this:

Reminder! Your menu options vary according to the security settings assigned as well as your assigned role.

 

Has anyone documented this type of thing differently, where it was well received by clients and effective too?

 

For reference, using RH 2020.4.173

Thanks so much in advance for your time!

 

Views

66

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines

correct answers 1 Correct Answer

Adobe Community Professional , Apr 24, 2021 Apr 24, 2021
It's a perennial problem and there isn't a really good answer. At one time you could freely edit Microsoft Office menus and eventually after lots of corporate complaints they made it near impossible. The corporates were having problems with supporting users where as soon as they said go to Menu X and click Y, the response was the option wasn't there. Eventually more customisation is allowed by Microsoft after expert users then protested but it is still more restricted than it was. About all yo...

Likes

Translate

Translate
Adobe Community Professional ,
Apr 24, 2021 Apr 24, 2021

Copy link to clipboard

Copied

It's a perennial problem and there isn't a really good answer. At one time you could freely edit Microsoft Office menus and eventually after lots of corporate complaints they made it near impossible. The corporates were having problems with supporting users where as soon as they said go to Menu X and click Y, the response was the option wasn't there. Eventually more customisation is allowed by Microsoft after expert users then protested but it is still more restricted than it was.

 

About all you can do is preface all topics with something along the lines "your experience may differ".

 

Beyond that? Maybe the options could have a code and the app could have a method of finding where that coded option is. Stand well clear when you suggest that to the developers. 🙂

________________________________________________________
See www.grainge.org for free Authoring and RoboHelp Information

Please use the Blue reply button at the top to help me help you. The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
Apr 25, 2021 Apr 25, 2021

Copy link to clipboard

Copied

I once worked on software where the field names could be customised (I had nightmares about that for months...). The best I came up with was deciding on as generic terms as I could, defining them in the glossary and having an intro topic that described that the users' field names may vary.

 

It was too unwieldy to mention it in every place it would have been relevant. I did include links to the glossary in the key topics that I figured users would be most likely to read as new users, so theoretically they would be familiar with the generic naming convention.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
Apr 25, 2021 Apr 25, 2021

Copy link to clipboard

Copied

Another idea might be to skip the navigation path entirely, and have the step as "Open the xxx screen", and have that link to a topic that describes the default locations of each button and a prominent note that says "your ribbon may be customised" or something.

 

The topic might be:

 

<H1>About the default ribbon

<p>blurb here

<note>Your ribbon may be customised blah blah.

<h2>Dashboard tab

<screenshot of dashboard buttons>

<table listing each button>

<h2>Home tab

<screenshot>

etc.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
Apr 26, 2021 Apr 26, 2021

Copy link to clipboard

Copied

LATEST

The usual way for getting around that is to only describe the "happy path" or "factory settings" views of the software with a prominent mention of the ability to customize.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Resources
RoboHelp Documentation