From 60ef631315a724a550e045b71c113e9c9484ee8b Mon Sep 17 00:00:00 2001 From: Sunshine Date: Sun, 15 Mar 2020 22:20:00 -0400 Subject: [PATCH] add ADR describing asset minimization --- .adr-dir | 2 +- docs/arch/0005-asset-minimization.md | 25 +++++++++++++++++++++++++ 2 files changed, 26 insertions(+), 1 deletion(-) create mode 100644 docs/arch/0005-asset-minimization.md diff --git a/.adr-dir b/.adr-dir index 42e7463..7f19008 100644 --- a/.adr-dir +++ b/.adr-dir @@ -1 +1 @@ -docs/arch/ +docs/arch diff --git a/docs/arch/0005-asset-minimization.md b/docs/arch/0005-asset-minimization.md new file mode 100644 index 0000000..0e487e3 --- /dev/null +++ b/docs/arch/0005-asset-minimization.md @@ -0,0 +1,25 @@ +# 4. Asset Minimization + +Date: 2020-03-14 + +## Status + +Accepted + +## Context + +It may look like a good idea to make monolith compress retrieved assets while +saving the page for the purpose of reducing the resulting document's file size. + +## Decision + +Given that the main purpose of this program is to save pages in a convenient to store and share manner — it's mostly an archiving tool, +aside from being able to tell monolith to exclude certain types of asests (e.g. images, CSS, JavaScript), +it would be outside of scope of this program to implement code for compressing assets. Minimizing files before embedding them +does not reduce the amount of data that needs to be transferred either. A separate tool can be used later to compress and minimize pages +saved by monolith, if needed. + +## Consequences + +Monolith will not support modification of original document assets for the purpose of reducing their size, sticking to performing only a minimal +amount of modifications to the original web page — whatever is needed to provide security or exclude unwanted asset types.