topic Re: Code boxes in documentation are not displayed properly in Intel® oneAPI Math Kernel Library

Code boxes in documentation are not displayed properly

Vishnu — Mon, 03 Aug 2020 15:37:06 GMT

The attached screenshot shows the problem. The code boxes do not display the code.

Re: Code boxes in documentation are not displayed properly

Gennady_F_Intel — Wed, 05 Aug 2020 02:38:11 GMT

Do you see the problem with some specific routine description or everywhere?

Re: Code boxes in documentation are not displayed properly

Vishnu — Wed, 05 Aug 2020 05:09:25 GMT

Everywhere. All code boxes are stretched-out much more that required.

Re: Code boxes in documentation are not displayed properly

Gennady_F_Intel — Wed, 05 Aug 2020 07:51:12 GMT

hmm, I don't see the problem on my end: win10, Chrome (Version 84.0.4147.105 (Official Build) (64-bit)).

Re: Code boxes in documentation are not displayed properly

Vishnu — Wed, 05 Aug 2020 08:31:46 GMT

I am pretty sure this is an issue with the HTML in the website, because I reported it to webcompat, and they tested it with a few other browsers and found the same issue. Take a look:

https://github.com/webcompat/web-bugs/issues/56159

Re: Code boxes in documentation are not displayed properly

mecej4 — Thu, 06 Aug 2020 08:38:23 GMT

Gennady, I see the problem that Vishnu reported with all the browsers that I have: Edge, Firefox, Chrome and Opera. Please open the link

https://software.intel.com/content/www/us/en/develop/documentation/mkl-developer-reference-c/top/blas-and-sparse-blas-routines/blas-routines/blas-level-3-routines/cblas-symm.html#cblas-symm

and scroll down to the code box after "Description". You will see the code box almost empty, with only a few characters near the left edge of the box.

Re: Code boxes in documentation are not displayed properly

Gennady_F_Intel — Thu, 06 Aug 2020 09:50:34 GMT

thanks, mecej4! That's strange, it works on my side, but I asked my team to check the issue and they confirmed the same issue as you and Vishnu reported. We will ask our technical writers to check the problem on their side.

Re:Code boxes in documentation are not displayed p...

Gennady_F_Intel — Fri, 07 Aug 2020 03:22:58 GMT

here is what I hear from our IT persons: they are aware of this issue and they recommend "If users are still experiencing the issue, please ask them to clear cache and verify the issue is persistent. "

Re: Re:Code boxes in documentation are not displayed p...

Vishnu — Fri, 07 Aug 2020 06:11:28 GMT

I tried that. It does not seem to change anything, and the issue does persist.

Also, folks who've never opened this website before have reported this issue, so it is unlikely that is the cause.

Re: Re:Code boxes in documentation are not displayed p...

mecej4 — Fri, 07 Aug 2020 10:37:55 GMT

I always clear cache after logging into the Intel site, and that does not resolve the issue. The problem regarding the MKL documentation is still very much present.

Re: Re:Code boxes in documentation are not displayed p...

Ruqiu_C_Intel — Tue, 11 Aug 2020 04:12:58 GMT

It's work well in Chrome and IE on Windows 10

Re: Re:Code boxes in documentation are not displayed p...

Vishnu — Tue, 11 Aug 2020 08:16:36 GMT

Maybe try clearing your cache?

But either way, lots of people have independently verified that this problem exists, so I hope that is not still in question. It would be really nice if the folks in-charge of maintaining the documentation website could look into why this is happening.

Re: Re:Code boxes in documentation are not displayed p...

mecej4 — Tue, 11 Aug 2020 10:57:25 GMT

@Ruqiu_C_Intel :

May be for you, but for many of us, including me (I just checked after clearing cache and refreshing page on Chrome, Edge and Opera), it is still a major problem.

Re: Re:Code boxes in documentation are not displayed p...

Khang_N_Intel — Tue, 11 Aug 2020 23:47:17 GMT

I don't see any problem with the link mentioned above. However, I do see problem with link:

https://software.intel.com/content/www/us/en/develop/documentation/vtune-cookbook/top/configuration-recipes/profiling-hardware-without-sampling-drivers.html

on both explorer and chrome.

Re: Re:Code boxes in documentation are not displayed p...

Vishnu — Wed, 12 Aug 2020 06:15:45 GMT

The issue seems to be fixed now, with all code-boxes displaying properly for me. @mecej4 Can you check if it is okay for you too? If so, then there was something fixed by the folks maintaining the website.

Re: Re:Code boxes in documentation are not displayed p...

mecej4 — Wed, 12 Aug 2020 10:12:50 GMT

Yes, the problems have gone away and we appear to be back to normal again.

Thanks to the people who got the problem taken care of.

Re:Code boxes in documentation are not displayed p...

Gennady_F_Intel — Wed, 12 Aug 2020 11:54:06 GMT

This issue has been resolved and we will no longer respond to this thread. If you require additional assistance from Intel, please start a new thread. Any further interaction in this thread will be considered community only

Re: Re:Code boxes in documentation are not displayed p...

mecej4 — Sun, 30 Aug 2020 14:31:52 GMT

The problem is back again today (30 August 2020). See, for example, https://software.intel.com/content/www/us/en/develop/documentation/mkl-developer-reference-fortran/top/blas-and-sparse-blas-routines/sparse-blas-level-2-and-level-3-routines/routines-and-supported-operations.html

and look at the text in the box after "computing the vector product between a sparse matrix and a dense vector".

The problem can be seen in Chrome and Edge on Windows.