Skip to content
This repository was archived by the owner on Jan 15, 2025. It is now read-only.

Commit 3d47faa

Browse files
author
Eyal
authored
Added tool deprecation schedule (#368)
* bf cli doc header * updated readme.md * update readme.md * minor link fix * powerBI dashboard * powerBI usage stats dashboard * dialog cli spec * fix my readme * reverted readme * added draft * pbi update * bf:luis cli usage update * update usage * LUIS authkey to subscriptionKey * minor spec fixes * updated luis cli usage spec * fix command ordering and camel case * Deprecation schedule doc * point to lifetime policy * add deprecation message
1 parent d6ed93c commit 3d47faa

File tree

2 files changed

+63
-0
lines changed

2 files changed

+63
-0
lines changed

PortingMap.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,13 @@ Commands invoked by BF [New Command] as follows:
2727
| lg | MSLG | TBD |
2828
| dispatch | Dispatch | TBD |
2929

30+
## Deprecation Schedule
3031

32+
Legacy tools shall be maintained for an extended period past the deprecation message in the tool, typically spanning 2 release cycles in order to support easy transition to the new _bf cli_.
33+
34+
See [Tool Lifetime Support Policy](./ToolLifetimeSchedule.md) for detailed timeline.
3135

3236
## See Also
3337

3438
* [BF CLI](https://github.com/microsoft/botframework-cli) main page
39+
* [Tool Lifetime Support Policy](./ToolLifetimeSchedule.md)

ToolLifetimeSchedule.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Tool Lifetime Support Policy
2+
3+
Every Microsoft product has a lifecycle. The lifecycle begins when a product is released and ends when it's no longer supported. Knowing key dates in this lifecycle helps you make informed decisions about when to upgrade or make other changes to your software. This product is governed by Microsoft's [Modern Lifecycle Policy](https://support.microsoft.com/en-us/help/30881/modern-lifecycle-policy).
4+
5+
## What releases qualify for servicing and how do updates effect servicing qualifications?
6+
Customers can choose Long Term Support (LTS) releases or Current releases. LTS releases will receive only critical and compatible fixes throughout their lifecycle. Current releases will receive these same fixes and will also be updated with compatible innovations and features.
7+
8+
Within a release's support lifecycle, systems must remain current on released patch updates.
9+
10+
## Release Schedule
11+
12+
| **Tool** | **Current Version** | **Current Status\*** | **Next Status\*** | **Current to Next Date** |
13+
| ---------- | ------------------- | -------------------- | ----------------- | ------------------------ |
14+
| Chatdown | 1.2.4 | LTS | EOL | June 1, 2020 |
15+
| LuDown | 1.4.0 | LTS | EOL | June 1, 2020 |
16+
| LuisGen | 2.2.1 | LTS | EOL | June 1, 2020 |
17+
| QnAMaker | 1.2.3 | LTS | EOL | June 1, 2020 |
18+
| LUIS (API) | 2.6.2 | LTS | EOL | June 1, 2020 |
19+
| BF | 4.6.0 | Current | -- | -- |
20+
| | | | | |
21+
*See Support Status section below
22+
23+
## Support Status
24+
25+
### EOL: End of Life
26+
27+
- No more fixes of any kind.
28+
- Product is no longer supported.
29+
- Download links may be removed.
30+
- Repository will remain in Read-Only mode for reference (but could be removed eventually).
31+
- Issues cannot be filed any longer
32+
- Exception: Critical security fixes may be applied in discretionary manner.
33+
34+
### LTS: Long Term Support
35+
36+
- Support is restricted to critical security fixes.
37+
- Microsoft may elect to fix specific singular issues to facilitate transition to EOL Status.
38+
- Repository will be locked down to Microsoft critical fixes only.
39+
- Issues can be filed and will be evaluated per above criteria.
40+
41+
### Current: Latest stable release
42+
43+
- All feature work and bug fixes will be applied to this version.
44+
- Minor versions will be applied aligned to SDK release schedule.
45+
- Repository is opened for normal OSS work
46+
- Issues are accepted
47+
48+
### Preview: Future Release
49+
50+
- Work under active development including latest features, some of which are experimental.
51+
- Final release will typically transition to Current.
52+
- Repository may be restricted.
53+
- Issues are accepted
54+
55+
## How do the different support tracks work?
56+
Customers choosing LTS will need the latest patch update installed to qualify for support. If a system is running 1.0 and 1.0.1 has been released, 1.0.1 will need to be installed as a first step. Once a patch update has been installed applications will begin using the update by default. LTS releases will be supported for 2-years after general availability, or for a 12 month Maintenance period after the next LTS release ships, whichever is longer.
57+
58+
In addition to staying current with the latest patch update, customers using Current will need to update as new minor versions are released to stay in support. The latest released minor version will become the minimum serviceable baseline after release. After a 3 month Maintenance period, the previous minor version will no longer be supported. For example, after 1.2 releases systems running version 1.1 will have 3 months to update to 1.2 to remain eligible for support. Applications do not automatically begin using the new minor update.

0 commit comments

Comments
 (0)