Skip to content

Commit

Permalink
started adding detail to the cache consideration section
Browse files Browse the repository at this point in the history
see #138
  • Loading branch information
andrecedik committed Jul 10, 2020
1 parent a60b02b commit 245804b
Showing 1 changed file with 12 additions and 1 deletion.
13 changes: 12 additions & 1 deletion http-warning/draft-cedik-http-warning-02.xml
Original file line number Diff line number Diff line change
Expand Up @@ -231,8 +231,19 @@ Content-Warning: "embedded-warning"; 1590190500
</section>
<section anchor="cache.considerations" title="Cache Considerations">
<t>
tbd.
The Content-Warning field itself does not encourage a specific handling when it comes to caching responses. It is up to the Content-Warning type to specify if caching can be used or not.
</t>
<section anchor="embedded-warning-and-caching" title='Caching the "embedded-warning" Content-Warning type'>
<t>
The reasons for returning the Content-Warning Type "embedded-warning" can be manifold. A system could e.g. return warnings due to circumstances in the backend that can either still exist on subsequent requests or that have been solved in the meantime.
</t>
<t>
Intermediaries can fall into the same category. When a warning occurs, it can add warnings to the response making it possible to debug what happened at the intermediary. The reason for said warning can persist or may disappear on subsequent requests.
</t>
<t>
Therefore caching embedded-warnings shouldn't be done. As one can't predict if the reason for returning embedded-warnings is still persistent.
</t>
</section>
</section>
<section anchor="security.considerations" title="Security Considerations">
<t>
Expand Down

0 comments on commit 245804b

Please sign in to comment.