core-lightning/doc/contribute-to-core-lightning
Rusty Russell 94a539ee3d Makefile: add CLN_NEXT_VERSION, functions encoding deprecation schedule.
Each feature has a name, and says when deprecation begins and ends.

There's an API coming to allow you to re-enable on a per-feature basis
even if it's ended (as long as it's not been removed from the code ofc!).

Default end is 6 months after deprecation, i.e. we complain about it
at that point, if we can detect its use.

e.g, a standard deprecation in v24.05:

v24.02: allowed
v24.02 with mods: allowed

master after v24.02: allowed unless deprecated APIs disabled.
v24.05: allowed unless deprecated APIs disabled.
v24.08: allowed unless deprecated APIs disabled.

v24.11: allowed unless deprecated APIs disabled, but logs at BROKEN level.

v25.02: allowed only if --i-promise-to-fix-broken-api-user=FEATURE.
v25.05: code is actually removed.

Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2024-01-26 10:30:22 +10:30
..
coding-style-guidelines update new documentation and move to doc/ 2023-07-16 12:59:40 +09:30
code-generation.md Publish code-generation.md (#6948) 2023-12-15 15:10:16 +00:00
coding-style-guidelines.md update new documentation and move to doc/ 2023-07-16 12:59:40 +09:30
contribute-to-core-lightning.md update new documentation and move to doc/ 2023-07-16 12:59:40 +09:30
contributor-workflow.md doc: add a nice explainer about how to update PR branches 2024-01-16 19:00:34 +01:00
docker-images.md doc: Documentation update 2023-12-12 16:31:44 +01:00
release-checklist.md Makefile: add CLN_NEXT_VERSION, functions encoding deprecation schedule. 2024-01-26 10:30:22 +10:30
security-policy.md update new documentation and move to doc/ 2023-07-16 12:59:40 +09:30
testing.md doc: documentation update for hooks and testing 2023-12-15 10:19:14 +10:30