Dyalog / Dyalog/documentation-assets

Table of Contents sometimes renders sections with less spacing

Open
#3 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
CSS
Stars
0
Forks
3
Avg merge
6h 37m
Merged PRs (30d)
1

Description

Using the [documentation tools](https://github.com/Dyalog/documentation/tree/main/tools) to render a document (from [83-add-release-notes](https://github.com/Dyalog/documentation/tree/83-add-release-notes)) on my machine the gap between "announcements" and "New and Enhanced Features" is too small. This does not appear when Fi is rendering (using the same Docker setup) on her machine. Need to investigate what exactly the difference is.

Tried again from main branch of documentation project. All sections are rendered too close

![Image](https://github.com/user-attachments/assets/82593d6b-4f58-4aba-8fa9-5980776d395d)

reticent to put extra padding because it renders correctly for others

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the documentation tools linked in the issue and reproduce the rendering from the main branch and the 83-add-release-notes branch using the same Docker setup. Compare the output across the two machines and identify the environmental or stylesheet difference responsible for the section spacing; done means the cause is understood and the spacing renders consistently without unexplained extra padding.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, docker
Domain
design, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.