[oneMKL][Sparse BLAS] Misleading missing text in dark mode in set_matrix_property page

[gajanan-choudhary]

The sparse::set_matrix_property page in the oneMKL Specification appears to be rendered incorrectly in dark mode. See the rendered HTML link.

Here's the light mode view:

and here's the dark mode view:

and here's the dark mode view with text selected (showing text is present, but just appears hidden, maybe the color is off?):

[Rbiessy]

Good catch, I didn't notice it. Pinging @rscohn2 since he mentioned he was planning to look into this kind of issues.

I can reproduce this issue locally. It looks like the issue is due to the new lines using | inside the table. I find it useful to describe the behavior of the property for each format. Maybe we should change this to have a subsection for every property (symmetric, sorted, etc) and inside a table for each format (CSR, COO, etc) if needed? That could make more sense once we support more matrices formats.

[Rbiessy]

Note that I reported another issue directly to Robert. In the provisional spec the Data handles page does not have an arrow on the left to deploy the children pages like init_dense_vector. I can't reproduce that issue locally unfortunately.

[rscohn2]

In the provisional spec the Data handles page does not have an arrow on the left to deploy the children pages like init_dense_vector

It is controlled by

oneAPI-spec/source/index.rst

Line 19 in 6ad4cc5

:maxdepth: 3

There is 1 extra level of nesting in the full spec versus onemkl standalone. I could make the full spec 4 so they render the same. Unlimited causes rendering problems.

I don't know what to do about the rendering problem in the table.

[Rbiessy]

Thanks, increasing the maxdepth to 4 sounds good to me.

I'll just avoid the new lines in tables and push it in #583

[Rbiessy]

There is 1 extra level of nesting in the full spec versus onemkl standalone. I could make the full spec 4 so they render the same. Unlimited causes rendering problems.

@rscohn2 just making sure, are you planning to look into this issue before the 1.4 spec is out?

[Rbiessy]

The dark mode now renders correctly so closing this issue.
Created #598 to continue the discussion with the navigation tree.