Working notes: the fork's rules in one place
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2 files changed
+15
No files matched your search
+1
@@ -14,6 +14,7 @@ what it is and how to install it is in the
|
|||||||
| [Building](Building) | Requirements, building and running from source — including the mpv piece, without which the app is a downloader rather than a player. |
|
| [Building](Building) | Requirements, building and running from source — including the mpv piece, without which the app is a downloader rather than a player. |
|
||||||
| [Tracking-upstream](Tracking-upstream) | How the fork relates to YTSage, and how a merge from upstream is done. |
|
| [Tracking-upstream](Tracking-upstream) | How the fork relates to YTSage, and how a merge from upstream is done. |
|
||||||
| [Upstream-README](Upstream-README) | YTSage's own README, kept verbatim for reference. |
|
| [Upstream-README](Upstream-README) | YTSage's own README, kept verbatim for reference. |
|
||||||
|
| [Working-notes](Working-notes) | The rules to know before touching the fork, in one place. |
|
||||||
|
|
||||||
## This repository is a fork, and it is treated as one
|
## This repository is a fork, and it is treated as one
|
||||||
|
|
||||||
|
|||||||
+14
@@ -0,0 +1,14 @@
|
|||||||
|
# Working notes
|
||||||
|
|
||||||
|
The rules to know before touching the fork, in one place. Added 2026-10-02 so every
|
||||||
|
wiki in the org has this page. [Tracking-upstream](Tracking-upstream) is the long form.
|
||||||
|
|
||||||
|
1. **The history is never rewritten.** SageTube still merges from `oop7/YTSage`, and a
|
||||||
|
rewrite would change every commit id and break the next merge.
|
||||||
|
2. **Tags up to `v5.3.0b` are upstream's**, inherited with the history. SageTube's own
|
||||||
|
versions continue that line (`v5.5.x`); the version lives in `pyproject.toml`.
|
||||||
|
3. **`upstream` is a real remote pointing at GitHub. Never push to it.**
|
||||||
|
4. **`.github/` and `readme-translations/` are upstream's files.** Leave them where
|
||||||
|
upstream put them, or the next merge conflicts.
|
||||||
|
5. The **mpv** piece is what makes it a player rather than a downloader — see
|
||||||
|
[Building](Building) before declaring a build working.
|
||||||
Reference in new issue
Block a user