It is almost impossible to learn how to use SparseMatrix from the current documentation. The example code also isn't very useful. We need to improve the documentation and make it easier to grasp and include some real-world examples.

(Possibly related to #1166 and #1770?)

This is just a placeholder issue to obtain feedback about the current state of the docs:

1. Are the docs clear enough?
2. Are the examples useful and real?
3. Is the information there for a newbie?
4. Is the information there for an advanced user?
5. Is the organization appropiate?
6. What can we do to improve it.

As per angularsen/UnitsNet#328 (comment)

Having a set of tests to validate that the correct abbreviation notations and symbols are used would be helpful, as we have seen from before that discrepancies tend to creep in over time.

See #328 for the (currently work in progress) guideline, go through the comments and identify what tests to write for the guid

In area unit, cm2's name should be change.

name: {
singular: 'Square Centimeter',
plural: 'Square Centimeters'
}

The class comment of MonetaryAmountFormat has two code snippets. Both of them are full of compile errors

MonetaryAmountFormat f = MonetaryFormats.getInstance(loc);
f.setStyle(f.getStyle().toBuilder().setPattern("###.##;(###.##)").build());

• there are no #setStyle and #getStyle methods
• there is no #getInstance method on MonetaryFormats, you probably mean `#getAmount

It came up in #41 that it would be nice to have functions like abs(), sqrt(), etc. implemented on $System<f64, U> (and friends) directly, and not just through traits, so that they could be called without the traits in scope.

I'd wanted to extend Unitful with a couple of units in a package of mine but I realized I did not understand most of the discussion about it in the documentation here.

Then I thought I'd just copy the UnitfulUS.jl example but it seems that it is not passing CI, which deterred me back

Provide nice Unicode symbols for fractional exponents wherever possible.

using namespace units;
using namespace units::si::literals;

std::cout << sqrt(1m) << "\n";

> ^C
> ^C
> exit()
No such unit exit, did you mean spectral_exitance_frequency?
> ^C
> ^C
> ^C
> ^C
>
Expected term, got eof
> help
For information on how to use Rink, see the manual: https://github.com/tiffany352/rink-rs/wiki/Rink-Manual
> .exit
Expected term, got <Malformed number literal: No digits after decimal point>
> :q
Expected term, got `:`
> quit

No Unit found is not descriptive at all.

We should at least make that error message more clear for cases like:

• "75kg" instead of "75 kg"

Our assumption for parsing a compound quantity is that there will be a space character between the value and the unit

Currently ToString / Save methods in SharedParameterFile ignore the original format (e.g. the absence of Description and/or UserModifiable columns). File shall be persisted exactly as it was read