@ashmaroli you wrote:
[…] what features or enhancements the community would like to have / see in future versions of Jekyll
Versioned documentation:
-
To browse the docs for any version of Jekyll, on jekyllrb.com.
-
To build versioned docs websites using Jekyll.
Regarding point 1, I’m aware of the jekyll-docs
gem, which supports offline browsing of various versions of the Jekyll docs. But when browsing on the web, it seems to me very odd that those versions of the docs aren’t available online too. Couldn’t the Jekyll docs website simply serve all the sites built by jekyll-docs
, at URLs such as https://jekyllrb.com/4.2.2
?
Point 2 is more general. The lack of direct Jekyll support for building versioned docs seems surprising on GitHub, where the focus is on version control! The versions-jekyll
repo shows how developers can set up versioned docs using Jekyll; perhaps use of GitHub Actions and templates could simplify that approach?
In any case, various themes in other ecosystems do support versioned docs directly. The answer to a relatively recent request for help about support for versioned docs was to migrate the website from the Jekyll-based Just the Docs theme to Read the Docs…