apache / apache/airflow

Missing documentation in old versions after removing docs from the stable version

Open
#47,610 7 comments 0 reactions 0 assignees View on GitHub
kind:bug kind:documentation
Dominant language
Python
Stars
46.9k
Forks
17.8k
Avg merge
2d 10h
Merged PRs (30d)
483

Description

### What do you see as an issue?

After removing documentation from the stable version it is removed from old versions also and links in old version end up being broken. Current relevant example:

- [deprecated code from providers](#44559) have been removed. Documenation have been removed from the stable version.
- documentation in old version (it is still relevant there) has been removed, e.g. [MsSqlOperator](https://airflow.apache.org/docs/apache-airflow-providers-microsoft-mssql/stable/_api/airflow/providers/microsoft/mssql/operators/mssql/index.html#airflow.providers.microsoft.mssql.operators.mssql.MsSqlOperator)
- links leading to pages in old versions also broken, see links to operators (`MySqlOperator`, `PostgresOperator`, `MsSqlOperator` etc.) in [operators](https://airflow.apache.org/docs/apache-airflow/2.9.0/core-concepts/operators.html)

### Solving the problem

Documentation removed in the stable version should not be removed from old versions.

### Anything else

_No response_

### Are you willing to submit PR?

- [ ] Yes I am willing to submit a PR!

### Code of Conduct

- [x] I agree to follow this project's [Code of Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md)

Contributor guide

Open the contributing guide

Research direction

Start by comparing the stable and 2.9.0 documentation for MsSqlOperator and the operators page, including the links to MySqlOperator and PostgresOperator. Trace how documentation is retained across versions; done means documentation still relevant to an old version and its links remain available after removal from stable.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.