Skip to content

Commit 161ae8b

Browse files
committed
docs(documentation): Update open questions
1 parent 4255114 commit 161ae8b

File tree

3 files changed

+10
-12
lines changed

3 files changed

+10
-12
lines changed

rfcs/0017-incremental-build.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -165,16 +165,17 @@ The directory structure is flat and efficient. A global `cas/` directory stores
165165

166166
```
167167
.ui5-cache
168-
├── cas/ <-- Global Content-Addressable Store (shared across all projects)
168+
├── cas/ <-- Global Content-Addressable Store (shared across all projects) - actual representation might differ
169169
│ ├── c1c77edc5c689a471b12fe8ba79c51d1 (Content of one file)
170170
│ ├── d41d8cd98f00b204e9899998ecf8427e (Content of another file)
171171
│ └── ... (all other unique file contents)
172172
173173
└── manifests/
174-
├── @ui5/
175-
│ └── sample-app-0.5.0-bb3a3262d893fcb9adf16bff63f.json
176-
├── sap.m-1.142.0-xy3a3262d893fcb9adf16bff63f.json.json
177-
└── sap.ui.core-1.142.0-fh3a3262d893fcb3adf16bff63f.json
174+
├── @ui5/
175+
│ └── sample-app-0.5.0-bb3a3262d893fcb9adf16bff63f.json
176+
└── @openui5/
177+
├── sap.m-1.142.0-xy3a3262d893fcb9adf16bff63f.json.json
178+
└── sap.ui.core-1.142.0-fh3a3262d893fcb3adf16bff63f.json
178179
```
179180

180181
The `cas` directory contains files named by their SHA256 content hash. Each file contains the raw content of a resource produced during a build. Ideally a library like [`cacache`](https://www.npmjs.com/package/cacache) should be used to manage the content-addressable store.
@@ -260,15 +261,12 @@ An alternative to using the incremental build in the UI5 CLI server would be to
260261

261262
## Unresolved Questions and Bikeshedding
262263

263-
* Measure performance in BAS. Find out whether this approach results in acceptable performance.
264264
* How to distinguish projects with build cache from pre-built projects (with project manifest)
265+
* Check presence of "sourceMetadata" attribute. Only with "sourceMetadata", the cache can be used for incremental (re-)builds the project. Otherwise it is "only" a build *result* that can be used for building dependent projects.
265266
* Cache related topics
266-
* Clarify cache key
267-
* Current POC: project version + dependency versions + build config + UI5 CLI module versions
268-
* Include resource tags in cache
269267
* Allow tasks to store additional information in the cache
270-
* Cache Purging
271268
* Some tasks might be relevant for the server only (e.g. code coverage), come up with a way to configure that
269+
* This will implicitly cause the creation of different caches for server and build. This might just be an acceptable and easy to understand trade-off.
272270
* What if a task ceases to create a resource because of a change in another resource? The previously created version of the resource would still be used from the cache
273-
* Test with selected (community) custom tasks
274-
* With this concept, providing pre-built UI5 libraries becomes especially important. Otherwise consumers will always have to locally build framework libraries, even in the server
271+
* Measure performance in BAS. Find out whether this approach results in acceptable performance.
272+
* Test with selected (community) custom tasks
-52 Bytes
Binary file not shown.
-8.01 KB
Loading

0 commit comments

Comments
 (0)