Add v3 notes

This commit is contained in:
Alexandre Vicenzi 2023-03-31 23:51:41 +02:00
parent 426452cc82
commit 78a57ba120

View file

@ -1,12 +1,27 @@
# Flex [![Build Status](https://travis-ci.org/alexandrevicenzi/Flex.svg?branch=master)](https://travis-ci.org/alexandrevicenzi/Flex) # Flex
The minimalist [Pelican](http://blog.getpelican.com/) theme. The minimalist [Pelican](http://blog.getpelican.com/) theme.
## Notes ## Flex 3.0 and upcoming breaking changes
- If you have questions open an issue Flex 2.6 will be the last release without breaking changes.
- The theme is not under huge development anymore, it's stable and has a lot of features already
- If you want a [Hugo](https://gohugo.io/) theme check out [Soho](https://github.com/alexandrevicenzi/soho) Flex 3.0 is under development and will introduce breaking changes.
The breaking changes will include:
* Removal of deprecated plugins and integrations
* Removal and renaming of configuration variables
* Removal of Less.js and Gulp.js
* Refactoring of multiple templates
Flex has grown beyond expectation over the last few years and is hard to maintain and accept new features.
You can check the current progress in the `v3` branch.
New features won't be accepted unless submited to `v3` branch, bug fixes will still be accepted in the `master` branch.
Once 2.6 is out, the `v3` branch will be merged into `master`.
## Features ## Features
@ -55,7 +70,7 @@ The minimalist [Pelican](http://blog.getpelican.com/) theme.
The best way to install is over [pelican-themes](https://github.com/getpelican/pelican-themes). The best way to install is over [pelican-themes](https://github.com/getpelican/pelican-themes).
The alternative way is to clone this repository. The `master` branch is stable and is safe to checkout, but I would recommend you to checkout a tag branch. The alternative way is to clone this repository and checkout a tag branch.
## Documentation ## Documentation
@ -73,8 +88,8 @@ The code is available in this project under `docs` folder.
## Contributing ## Contributing
**ALWAYS** open an issue before sending a PR. **ALWAYS** open an issue before sending a PR.
Discuss the problem/feature that you want to code. Discuss the problem/feature that you want to solve.
After discussing, send a PR with your changes. If things make sense, send a PR with your changes.
As always, if you want something that only makes sense to you, fork Flex and create a new theme. As always, if you want something that only makes sense to you, fork Flex and create a new theme.