emscripten-core / emscripten-core/emscripten

Website does not show lists properly

Open
#21,145 10 comments 0 reactions 0 assignees View on GitHub
docs good first bug help wanted
Dominant language
C++
Stars
27.6k
Forks
3.6k
Avg merge
1d 1h
Merged PRs (30d)
105

Description

For example, right under `The optimization level you should use depends mostly on the current stage of development:` on the [optimizing code](https://raw.githubusercontent.com/emscripten-core/emscripten/main/site/source/docs/optimizing/Optimizing-Code.rst) page we have this bulleted list:

```
- When first porting code, run *emcc* on your code using the default settings (without optimization). Check that your code works and :ref:`debug ` and fix any issues before continuing.
- Build with lower optimization levels during development for a shorter compile/test iteration cycle (``-O0`` or ``-O1``).
- Build with ``-O2`` to get a well-optimized build.
[..]
```

However, it does not show up as a list. I just see a paragraph for each of those. That is, there are no bullet points and the items are not indented by those bullet point markers (that should exist but do not).

I see this on both Firefox and Chrome, so it doesn't seem to be a browser issue. I also see that the HTML seems fine:
```html


  • When first porting code, run emcc on your code using the default settings (without optimization). Check that your code works and debug and fix any issues before continuing.


  • Build with lower optimization levels during development for a shorter compile/test iteration cycle (-O0 or -O1).


  • Build with -O2 to get a well-optimized build.


  • Building with -O3 or -Os can produce an ever better build than -O2, and are worth considering for release builds. -O3 builds are even more optimized than -O2, but at the cost of significantly longer compilation time and potentially larger code size. -Os is similar in increasing compile times, but focuses on reducing code size while doing additional optimization. It’s worth trying these different optimization options to see what works best for your application.


  • Other optimizations are discussed in the following sections.



```

Using the devtools inspector I found we have `list-style: none` enabled in our CSS for some reason. Removing that "fixes" the issue, but then I see ugly unstyled dots for the bullet points, and they are not properly indented, so clearly that's not the right fix (which would be far beyond my CSS skills).

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.