Actions
Forum Thread Details
  • Replies 15 replies
  • Subscribers 2749 subscribers
  • Views 2855 views
  • Users 0 members are here
Related

Cleaning up table of contents and navigation in RoadTest Reviews

cstanton

Hello,

We've realised that there's some duplication with tables of contents, particularly when it comes to RoadTest Reviews, and with our new Project Articles ( Ho-Ho-Hold on a minute, is that a blog? A new way to submit your project! ).

Verint, as a platform, has a way of inserting 'tables of contents' like this:

image

But there are problems with its formatting and how it works. For RoadTest Reviews as an example, we have an automatic generation of a table of contents which can look like this:

image

This helps to separate the content from the contents list when listing the content on Google, sharing on social media, etc. So we use this method in RoadTest Reviews and Project Articles.

Because we have this, it means that it's a duplicate of the 'insert table of contents' and you can end up with a heading of "table of contents" in this new list, and it becomes a bit cumbersome and confusing, it doesn't make sense to have both. 

So ultimately, we won't.

For Project Articles and RoadTest Reviews we're removing the ability to insert the table of contents from the menu.

Instead? Use headings, marked with the <hx> tags, where 'x' is a number. A lot of members already do this, but I realised we haven't actually pointed this out anywhere.

You can find heading formatting under the Format menu:

image

These menus should always be visible when using the Community from a laptop or desktop, maybe even a tablet. It may not always be visible when using a mobile device.

Thanks for reading!

  • in reply to cstanton

    was the word you meant to use compromised by Verint?

  • in reply to cstanton

    sure, did already for some, need to do more.

  • in reply to shabaz
    shabaz said:
    Any chance we can have a few more styles added for inset types of messages?

    These are nice ideas, I like them! I do not know how easy/possible they are to implement, but I can ask.

  • in reply to gpolder
    gpolder said:

    The upper table of contents doesn't work any more.

    Same for all my other pre verint reviews.

    Thanks for the links.

    I have looked at the HTML markup on the links, and I can see why they no longer work.

    These links at some point used to link to another element on the same page. These have been lost and will no longer work.

    The best approach would now be to remove that table of contents that's inserted at the top, and make sure that the headings are properly sized (H1 to Hx) on the content to populate the new table of contents.

  • in reply to cstanton

    just like here:

    /products/roadtest/rv/roadtest_reviews/254/3ghz_spectrum_analyz

    The upper table of contents doesn't work any more.

    Same for all my other pre verint reviews.

  • in reply to shabaz
    shabaz said:
    I actually can't see where I should click to subscribe for e-mail alerts

    It's always under the 'more' option

    image

    shabaz said:
    I know this is in Verint's pile but in the meantime

    Unfortunately, I'm consistently told this is in Verint's wheelhouse and should be customised by Verint to be an 'out of the box' feature. As you know I do constantly bring this one up with the team, and frustratingly it's simply not on Verint's priority list - as they've told me directly.

  • in reply to shabaz

    The 'new' table of contents which is auto-created from headings is custom from the development team, so I would hope they can change how it behaves without having to raise it with or wait on Verint Slight smile

  • Hi Christopher,

    This isn't directly related, but I really think it's important to raise it here too, since it does affect tutorials and roadtests a lot:

    Any chance we can have a few more styles added for inset types of messages? For instance, Note and Warning boxes are useful. Even a single style for inset content would be awesome, called 'Alert' style perhaps. I think it will really help some types of content. 

    image

    The screenshot below shows another example of a Note box.

    Also, if the code box font size perhaps could be increased by a point or two (or for it to respond to the text size option in the Editor toolbar, so that the author can size it appropriate to the type of content that is in there), that would look a lot better I think (it feels a bit too small currently). The code in the screenshot below looks more readable.

    image

    The code in the screenshot above looks more readable/similar sized to the body text, than in the screenshot below. Also, the code block below looks incomplete without a border and copy button, like in the screenshot above, 

    image

    I know these are quite cosmetic tweaks, but as mentioned the site is behaving well, so even the developers may like to work on the fun artistic/cosmetic stuff for a while, instead of bugs hehe  : )

    Also, the only e-mail notifications I'm getting to this forum post are for comments I write. I'm seeing no notifications to e-mail when anyone else comments. I know this is in Verint's pile but in the meantime if there was a way to change that Reply button to Reply & Subscribe that would be awesome. I actually can't see where I should click to subscribe for e-mail alerts:

    image

  • in reply to Gough Lui

    Same here. Something just feels wrong with the narrow format in conjunction with the limited good usage of the left and right sides. Jive had it spot on, that felt like a good width. Even if it were just 15-20% wider that might feel better (e.g.   can the auto-sizing with HTML 5, i.e. auto adjustment between mobile views and desktop views, simply push out of the way more of the side panes, until the user really stretches the page wide) , or give us control of adding stuff into the columns, because not all articles are going to look readable in a narrow style. I resorted to self-help and deliberately remove header tags in content if I think that automated ToC thing will kick in. I know that's not good either, but what can we do. It feels that something needs to change, and if it can't be a lot due to Verint etc, then some compromise would be good, from my perspective at least a bit more space, and for it to be tested on longer content as well as content where users forget to add headings. Anyway, from a broader perspective, it's awesome that the site is now at a good stage where more focus can be on such tweaks I hope!