From dca7b0e208b1115d359af801476bf73e5fe74fdc Mon Sep 17 00:00:00 2001 From: Arpita-Jaiswal Date: Thu, 26 May 2022 13:39:15 +0530 Subject: [PATCH 1/4] Explain top-down approach version --- dev/versioning.ftd | 101 +++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 97 insertions(+), 4 deletions(-) diff --git a/dev/versioning.ftd b/dev/versioning.ftd index e4be07ee6..73d74ccd5 100644 --- a/dev/versioning.ftd +++ b/dev/versioning.ftd @@ -28,16 +28,109 @@ lang: txt - package-folder - FPM.ftd + - v0/ - v1/ - - index.ftd - foo.ftd - v2/ - - index.ftd + - index.ftd + - foo.ftd + +-- ft.markdown: + +There are documents like `foo.ftd` and `index.ftd` lies outside any versioned folder +(`v1` and `v2`). These documents become the part of all the versions unless any +versioned folder contains the document with same id. Then that version and all preceding +version would take that document. +Notice that `foo.ftd` exists in `v1` folder, this implies that `v1` has other edition +of `foo.ftd` and all the preceding versions (`v0`) would take this edition of `foo.ftd`. + +The file structure would look like this + +-- ft.code: File structure +lang: txt + +- package-folder + - v0 + - index.ftd (from package root directory) + - foo.ftd (from v1) + - v1 + - index.ftd (from package root directory) + - foo.ftd (from v1) + - v2 + - index.ftd (from package root directory) + - foo.ftd (from package root directory) + + +-- ft.h2: Not include the document till a particular version + +-- ft.code: Not include `foo.ftd` till v1 +lang: txt + +- package-folder + - FPM.ftd + - v0/ + - v1/ + - foo.ftd.delete + - v2/ + - index.ftd + - foo.ftd + +-- ft.markdown: + +Notice that `foo.ftd.delete` is added in the `v1`. This result in not including the `foo.ftd` +for `v1` version and all the preceding versions `v0`. + +The file structure would look like this: + +-- ft.code: File structure +lang: txt + +- package-folder + - v0 + - index.ftd (from package root directory) + - v1 + - index.ftd (from package root directory) + - v2 + - index.ftd (from package root directory) + - foo.ftd (from package root directory) + + +-- ft.h2: Include a document till a particular version + +-- ft.code: Include `foo.ftd` till v1 +lang: txt + +- package-folder + - FPM.ftd + - v0/ + - v1/ + - foo.ftd + - v2/ + - index.ftd + + -- ft.markdown: -Notice that `foo.ftd` does not exist in `v2` folder, since it has not been -edited in v2. +Notice that `foo.ftd` is added in the `v1`. This result in including the `foo.ftd` +for `v1` version and all the preceding versions `v0`. And since it's not part of +package root directory, so it's not part of all succeeding versions `v2` + +The file structure would look like this: + +-- ft.code: File structure +lang: txt + +- package-folder + - v0 + - index.ftd (from package root directory) + - foo.ftd (from v1) + - v1 + - index.ftd (from package root directory) + - foo.ftd (from v1) + - v2 + - index.ftd (from package root directory) + -- ft.h2: `fpm.package` From bd9e45ed6fbc0aa6a4fe6358662386ba11031ce7 Mon Sep 17 00:00:00 2001 From: Arpita-Jaiswal Date: Thu, 26 May 2022 13:48:15 +0530 Subject: [PATCH 2/4] minor --- dev/versioning.ftd | 1 + 1 file changed, 1 insertion(+) diff --git a/dev/versioning.ftd b/dev/versioning.ftd index 73d74ccd5..058c84698 100644 --- a/dev/versioning.ftd +++ b/dev/versioning.ftd @@ -41,6 +41,7 @@ There are documents like `foo.ftd` and `index.ftd` lies outside any versioned fo (`v1` and `v2`). These documents become the part of all the versions unless any versioned folder contains the document with same id. Then that version and all preceding version would take that document. + Notice that `foo.ftd` exists in `v1` folder, this implies that `v1` has other edition of `foo.ftd` and all the preceding versions (`v0`) would take this edition of `foo.ftd`. From 1e939f8208894efc41eb26daa459bdf761d332bb Mon Sep 17 00:00:00 2001 From: Arpita-Jaiswal Date: Thu, 26 May 2022 13:53:21 +0530 Subject: [PATCH 3/4] minor changes in explaination --- dev/versioning.ftd | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/dev/versioning.ftd b/dev/versioning.ftd index 058c84698..568936b1b 100644 --- a/dev/versioning.ftd +++ b/dev/versioning.ftd @@ -39,8 +39,8 @@ lang: txt There are documents like `foo.ftd` and `index.ftd` lies outside any versioned folder (`v1` and `v2`). These documents become the part of all the versions unless any -versioned folder contains the document with same id. Then that version and all preceding -version would take that document. +versioned folder contains the document with same id. This results in overriding of the +document and that version and all preceding version would take the overriding document. Notice that `foo.ftd` exists in `v1` folder, this implies that `v1` has other edition of `foo.ftd` and all the preceding versions (`v0`) would take this edition of `foo.ftd`. From 8b0a385b8515687fdcd6159f0551583468a30b10 Mon Sep 17 00:00:00 2001 From: Arpita-Jaiswal Date: Thu, 26 May 2022 13:55:47 +0530 Subject: [PATCH 4/4] minor changes in explaination --- dev/versioning.ftd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev/versioning.ftd b/dev/versioning.ftd index 568936b1b..5ec4e03d1 100644 --- a/dev/versioning.ftd +++ b/dev/versioning.ftd @@ -40,7 +40,7 @@ lang: txt There are documents like `foo.ftd` and `index.ftd` lies outside any versioned folder (`v1` and `v2`). These documents become the part of all the versions unless any versioned folder contains the document with same id. This results in overriding of the -document and that version and all preceding version would take the overriding document. +document and that version and all preceding version would take the overridden document. Notice that `foo.ftd` exists in `v1` folder, this implies that `v1` has other edition of `foo.ftd` and all the preceding versions (`v0`) would take this edition of `foo.ftd`.