icu4x icon indicating copy to clipboard operation
icu4x copied to clipboard

Reword "computationally heavy" language in docs

Open sffc opened this issue 2 years ago • 3 comments

Our docs have verbiage such as:

For that reason, one should think of the process of formatting a date in two steps - first, a computational heavy construction of DateTimeFormatter, and then fast formatting of DateTime data using the instance."

This is somewhat misleading. We should come up with better verbiage.

sffc avatar Oct 29 '23 22:10 sffc

Do we have any measurements of the actual cost of DTF construction?

zbraniecki avatar Oct 30 '23 11:10 zbraniecki

Let's block this on #3865 and write the verbiage based on measurements after those changes land.

sffc avatar Oct 30 '23 17:10 sffc

Assigning to @sffc since it's a part of the whole set of datetime changes

Manishearth avatar Sep 30 '24 23:09 Manishearth

This language no longer exists in the current docs, and my new docs discuss various tradeoffs, although not specifically this one. The principle of "expensive constructor and fast format function" is one that would apply horizontally across ICU4X. So I will close this issue.

sffc avatar Jan 09 '25 03:01 sffc