Skip to content

Conversation

@simi
Copy link
Contributor

@simi simi commented Jun 22, 2025

During work on some docs changes, I have noticed anchor links are partially broken, since they scroll to content hidden behind navbar.

currently navigating to https://airflow.apache.org/docs/apache-airflow/stable/index.html#workflows-as-code shows

image

with this fix, it scrolls properly

image

I have fixed also missing top padding (due to banner). I wasn't able to find out logic behind loading the banner, but it is fixed 40px in all viewports (seems so). I have added it whenever needed for calculations and made clear comments on what's happening. In case of banner is removed, those number should be recalculated, there is probably no simple automated way currently to do that.

This whole problem could be fixed also by making content own scroll context (instead of fixed navbar), but it will involve a lot of layout changes I'm not brave enough to provide (I wasn't able to find out even basic layout setup). This fixes the problem with minimal code changes.

@potiuk
Copy link
Member

potiuk commented Jun 22, 2025

nice. We need to improve the workflow (or at least documentation) for site layout changes. CC: as discussed recently @mik-laj !

@simi simi marked this pull request as ready for review June 22, 2025 11:19
@uranusjr uranusjr merged commit d8086e6 into apache:main Jun 23, 2025
90 of 95 checks passed
@simi simi deleted the sticky-anchors branch July 21, 2025 09:04
@simi
Copy link
Contributor Author

simi commented Jul 21, 2025

@potiuk was this deployed? I still see the problem.

@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

Not really - it needs to be cherry-picked I think to 3-0-test, because we build documentation from there.

potiuk pushed a commit to potiuk/airflow that referenced this pull request Jul 21, 2025
…ache#52016)

(cherry picked from commit d8086e6)

Co-authored-by: Josef Šimánek <josef.simanek@gmail.com>
potiuk added a commit that referenced this pull request Jul 21, 2025
…2016) (#53581)

(cherry picked from commit d8086e6)

Co-authored-by: Josef Šimánek <josef.simanek@gmail.com>
@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

Cherry-picked here: #53581

@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

Let me try to rebuild the site and see :)

@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

OK. there is just one clarification added in 3.0.3 branch - so I can safely rebuild the docs. Let me try.

@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

Ach .. not that easy... Have to fix an error in our workflow :)

@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

PR to fix the workflow here: #53582

@simi
Copy link
Contributor Author

simi commented Jul 21, 2025

Good luck 🙏.

@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

Seems it works on staging. Rebuilding it on live site.

@potiuk
Copy link
Member

potiuk commented Jul 21, 2025

Nice... It works ! Thank you! I miseed we needed to deploy it :)

@simi
Copy link
Contributor Author

simi commented Jul 21, 2025

I can confirm, all good on my side. 💪

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants