From c56789598a0b05044a7cb7bae5d62a27745668a2 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Tue, 24 Nov 2015 23:34:09 -0800 Subject: [PATCH] Explain in docs that v3 is closed off to new features Refs #18112 [skip sauce] --- CONTRIBUTING.md | 15 ++++++++++++++- README.md | 4 ++++ 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6060c16dbc..ba61925e3b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -116,7 +116,13 @@ When feasible, we aim to report such upstream bugs to the relevant browser vendo ## Feature requests -Feature requests are welcome. But take a moment to find out whether your idea +Feature requests are welcome, but please note that they **must target +[Bootstrap v4](https://github.com/twbs/bootstrap/tree/v4-dev),** because +Bootstrap v3 is now in maintenance mode and is closed off to new features. +This is so that we can focus our efforts on Bootstrap v4, the future of the +framework. + +Before opening a feature request, please take a moment to find out whether your idea fits with the scope and aims of the project. It's up to *you* to make a strong case to convince the project's developers of the merits of this feature. Please provide as much detail and context as possible. @@ -133,6 +139,13 @@ implementing features, refactoring code, porting to a different language), otherwise you risk spending a lot of time working on something that the project's developers might not want to merge into the project. +In particular, **pull requests that add new features to Bootstrap v3 will be +rejected.** Bootstrap v3 is now in maintenance mode and is therefore closed +off to new features, so that we can focus our efforts on Bootstrap v4, the +future of the framework. Pull requests that add new features should target +[Bootstrap v4 (the `v4-dev` git branch)](https://github.com/twbs/bootstrap/tree/v4-dev) +instead, where they will be welcomed and duly considered. + Please adhere to the [coding guidelines](#code-guidelines) used throughout the project (indentation, accurate comments, etc.) and any other requirements (such as test coverage). diff --git a/README.md b/README.md index 5785e92239..79ff31c093 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,8 @@ We provide compiled CSS and JS (`bootstrap.*`), as well as compiled and minified Have a bug or a feature request? Please first read the [issue guidelines](https://github.com/twbs/bootstrap/blob/master/CONTRIBUTING.md#using-the-issue-tracker) and search for existing and closed issues. If your problem or idea is not addressed yet, [please open a new issue](https://github.com/twbs/bootstrap/issues/new). +Note that **feature requests must target [Bootstrap v4](https://github.com/twbs/bootstrap/tree/v4-dev),** because Bootstrap v3 is now in maintenance mode and is closed off to new features. This is so that we can focus our efforts on Bootstrap v4. + ## Documentation @@ -99,6 +101,8 @@ Please read through our [contributing guidelines](https://github.com/twbs/bootst Moreover, if your pull request contains JavaScript patches or features, you must include [relevant unit tests](https://github.com/twbs/bootstrap/tree/master/js/tests). All HTML and CSS should conform to the [Code Guide](https://github.com/mdo/code-guide), maintained by [Mark Otto](https://github.com/mdo). +**Bootstrap v3 is now closed off to new features.** It has gone into maintenance mode so that we can focus our efforts on [Bootstrap v4](https://github.com/twbs/bootstrap/tree/v4-dev), the future of the framework. Pull requests which add new features (rather than fix bugs) should target [Bootstrap v4 (the `v4-dev` git branch)](https://github.com/twbs/bootstrap/tree/v4-dev) instead. + Editor preferences are available in the [editor config](https://github.com/twbs/bootstrap/blob/master/.editorconfig) for easy use in common text editors. Read more and download plugins at . -- 2.47.2