question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Consider deprecating old Leaflet versions docs, and automate publishing

See original GitHub issue

Currently dealing with Leaflet docs causes quite a bit of confusion:

  • Since reference.html is built locally and committed to the repo, we often get PRs on the generated files rather than sources for docs fixes.
  • Updating docs for a release is a quite involved manual process — ideally this would be completely automated.
  • Old version docs might show up in Google search results instead of latest docs.
  • Keeping generated files in the repo (and we have quite a few, including old versions) is a bad practice.

We introduced links to old Leaflet docs back in 2012, when Leaflet was v0.3. Now that it’s way more stable and mature and breaking changes are extremely rare, I think we can drop the old versions and only have one reference docs reflecting the latest version.

Also, now that we’re using GitHub Actions, automating the docs publishing when tagging a release seems quite doable. cc @jonkoops @IvanSanchez

Issue Analytics

  • State:open
  • Created 2 years ago
  • Reactions:1
  • Comments:10 (8 by maintainers)

github_iconTop GitHub Comments

2reactions
Malvozcommented, Jun 18, 2022

There are snapshots of all the reference versions in the Internet Archive’s Wayback Machine:

+1 for deprecating old versions docs.

1reaction
Falke-Designcommented, Jun 17, 2022

I think we should replace it web archiv links or at least suggest that the versions can be found in the web archiv

Read more comments on GitHub >

github_iconTop Results From Across the Web

leaflet.pm-forked - npm Package Health Analysis - Snyk
pm-forked is that it hasn't seen any new versions released to npm in the past 12 months, and could be considered as a...
Read more >
leaflet | Yarn - Package Manager
Important: This documentation covers modern versions of Yarn. For 1.x docs, see classic.yarnpkg.com. Yarn.
Read more >
DKAN Documentation
The automated software builder will download and configure the latest version of DKAN and prepare it for installation.
Read more >
Available CRAN Packages By Name
acled.api, Automated Retrieval of ACLED Conflict Event Data ... aroma.apd, A Probe-Level Data File Format Used by 'aroma.affymetrix' [deprecated].
Read more >
arcgis.gis module | ArcGIS API for Python
The map widget is only supported within a Jupyter Notebook. IE11 is no longer supported. Please use the latest version of Google Chrome,...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found