Open c0ncentus opened 1 year ago
10^^1e308 means 1e308 raised to 1e308 1e308 times.
And regarding the docs about methods, we could use JSDoc comments so that they appear in your IDE as well.
And regarding the docs about methods, we could use JSDoc comments so that they appear in your IDE as well.
I really not enjoy to deal with people thinking we are in their head => If i will be a telepath i don't write that.
The package (break_infinity) is (my intuition) ~10-30% well documented... (use depracated documentation + 1 line or 2).
you could put a minimum effort on doing a beautifull readme and reach ~80% rather than thinking of "writting good documentation" ...
If the maintener cares about documentation:
Jsdoc are good but the uses in break_infity (maybe as well here) is a joke.
So thats why put readme is neccessary: To be forced to be clear but maybe not a skill of the author. Like in general as we said as dev ... "tests are garbage", that is also "Just an another myth".
Regarding JSDoc I meant add JSDoc comments as well (and actually for all then methods, not something like how it's now)
To add something, I like how this example from the readme:
x = new Decimal(123.4567);
y = new Decimal("123456.7e-3");
z = new Decimal(x);
x.equals(y) && y.equals(z) && x.equals(z); // true
uses implicit creation of global variables which is a bad practice
Yeah the readme is godawful lmao. Writing a better one would take a lot of effort though, not sure I have it in me.
just do simple is enought. as we said "keep it stupid, simple" ...
is just a system of number with operations ...
it must be simple ... general to deeper mechanisme ... Lot efforts if you have a tons of things in your head and cannot organized them ... Take 10 minutes per day or 1 day per week and on february it is done ... (or even if you have clear mind .... you just make it in 10 minutes ...)
About your first point: 10^^1e308 is an example of tetration, which is pretty much the defining feature of this library - I feel it can be safely assumed that users of break_eternity know what tetration is, as if they don't, break_eternity probably isn't what they're looking for.
Hi, thanks to consider seriously high number issues and make it great !
you may be offense by what i written, but keep in mind that we read as reference youre READ.ME everytime and treat us as well like pig.
My Motivation
I written carefully and take time to suggest swift solution. Is not insulting because thats no the usage of the platform else i will go to twitter, What I want is making READ.ME more pretty like a tool that help us, not the opposite lol ^^ .
I read the readme and it's just scares me (being clear).
All drawsback / solution desired / Alternatives
10^^1e308
it means dealing with f(x)= 10^x^1e308 ? or else like 10^1e308^1e308 ? Be precise please I dont understand what means "^^". we need to search in the doc for solving the issue but you need to not being enigmatic or think "it is not enigmatic because I have clear of ideas of how the package works" (extremly BIAS, because dev are not supposed to know deeply, dev are only USE your package)
Readers are not telepath so write 10^1e308^1e308 instead of 10^^1e308
Section "Comparaison"
dont want to read, just ugly ... be serious and learn to make table in markdown (just i'm serious fot the readers and dev)
Functionnality
Just make it real https://www.pluralsight.com/guides/working-tables-github-markdown
Just i read i dont get the point ... juste make it concise like
and make a list of breaking change ... is like organize your text.
Format
I'am not a telepath so
Note
Seriously you can make it better than https://mikemcl.github.io/decimal.js/ .... Auto generated ok but such annoying and no easy to quickly use package .... With markdown you do 20% of efforts for 99% of usage ...