From Fedora Project Wiki
(create Change proposal for Jekyll4)
 
m (finish Jekyll4 Change proposal)
Line 33: Line 33:
** Update existing packages:
** Update existing packages:
*** rubygem-jekyll: 4.0.0
*** rubygem-jekyll: 4.0.0
*** rubygem-jekyll-asciidoc: 3.0.0
*** rubygem-jekyll-sass-converter: 2.0.0
*** rubygem-jekyll-sass-converter: 2.0.0
*** rubygem-minima: 2.5.1
*** rubygem-minima: 2.5.1
Line 41: Line 42:
*** rubygem-stringex
*** rubygem-stringex
*** rubygem-test-unit
*** rubygem-test-unit
It might also be necessary to update other packages as soon as new versions targeting Jekyll 4 are released (for example, jekyll-feed, jekyll-seo-tag, jekyll-toc, jekyll-watch gems).


* Other developers:  
* Other developers:  
Line 65: Line 68:
I've prepared a [https://copr.fedorainfracloud.org/coprs/decathorpe/jekyll4/ COPR repository]
I've prepared a [https://copr.fedorainfracloud.org/coprs/decathorpe/jekyll4/ COPR repository]
with a first draft of all packages that are necessary for upgrading Jekyll to
with a first draft of all packages that are necessary for upgrading Jekyll to
versions 4.0.0 and later, but the packages are still a "work in progress".
versions 4.0.0 and later, but the packages are still a "work in progress" and
not necessarily complete yet.


* Update jekyll to version 4.0.0
* Update jekyll to version 4.0.0
Line 96: Line 100:
TBD
TBD


[[Category:ChangePageIncomplete]]
[[Category:ChangeReadyForWrangler]]
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
<!-- The Wrangler announces the Change to the devel-announce list and changes the category to Category:ChangeAnnounced (no action required) -->
<!-- After review, the Wrangler will move your page to Category:ChangeReadyForFesco... if it still needs more work it will move back to Category:ChangePageIncomplete-->
 
[[Category:SelfContainedChange]]
[[Category:SelfContainedChange]]

Revision as of 13:17, 31 August 2019

Jekyll 4

Summary

This Change will bring the latest version of Jekyll, 4.0.0 (or later), to fedora. It includes minor backwards-incompatible changes, but also brings a lot of clean-ups and bug fixes compared to the 3.8 branch.

Owner

Current status

  • Targeted release: Fedora 32
  • Last updated: 2019-08-31
  • Tracker bug: <will be assigned by the Wrangler>
  • Release notes tracker: <will be assigned by the Wrangler>

Detailed Description

I will update the Jekyll static page generator to version 4.0.0 (or later), which will also include new versions of some Jekyll plugins / components and other rubygem dependencies.

Benefit to Fedora

The Jekyll stack in fedora 32 will be the latest and greatest.

Scope

  • Proposal owners:
    • Update existing packages:
      • rubygem-jekyll: 4.0.0
      • rubygem-jekyll-asciidoc: 3.0.0
      • rubygem-jekyll-sass-converter: 2.0.0
      • rubygem-minima: 2.5.1
    • Package new dependencies:
      • rubygem-kramdown-parser-gfm
      • rubygem-kramdown-syntax-coderay
      • rubygem-sassc (DONE)
      • rubygem-stringex
      • rubygem-test-unit

It might also be necessary to update other packages as soon as new versions targeting Jekyll 4 are released (for example, jekyll-feed, jekyll-seo-tag, jekyll-toc, jekyll-watch gems).

  • Other developers:
    • Update existing packages not owned by me:
      • rubygem-kramdown: 2.1.0
  • Release engineering: N/A
  • Policies and guidelines: N/A (not a System Wide Change)
  • Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

Jekyll 4 includes some minor backwards-incompatible changes which made new features possible, as outlined in the upstream announcement and release notes. Some themes might not yet be compatible with Jekyll 4.0.0+, but the default theme (minima) will be updated to a compatible version.

How To Test

I've prepared a COPR repository with a first draft of all packages that are necessary for upgrading Jekyll to versions 4.0.0 and later, but the packages are still a "work in progress" and not necessarily complete yet.

  • Update jekyll to version 4.0.0
  • Try to create a new jekyll site, try to build an existing site, etc.

User Experience

In general, the new release should be noticably faster than the 3.8 branch of Jekyll, and brings only minor backwards-incompatible changes that will probably not affect most users.

Dependencies

N/A (not a System Wide Change)

Contingency Plan

  • Contingency mechanism: N/A (not a System Wide Change)
  • Contingency deadline: N/A (not a System Wide Change)
  • Blocks release? N/A (not a System Wide Change)
  • Blocks product? N/A

Documentation

Release Notes

TBD