Remove out of scope docs, and clarify minor areas

Author: heikkitoivonen

docs/builtins/float.md

@@ -103,67 +103,6 @@ if x < y + 0.001:       # O(1)
     pass
 ```
 
-## Precision and Limitations
-
-### Fixed 64-bit Precision
-
-```python
-# IEEE 754 double precision (64 bits)
-# - 1 sign bit
-# - 11 exponent bits (range ~10^-308 to 10^308)
-# - 52 mantissa bits (~15-17 decimal digits precision)
-
-x = 0.1 + 0.2
-print(x == 0.3)  # False! Precision loss
-
-# Representation
-print(f"{x:.20f}")  # 0.30000000000000004443
-```
-
-### Avoiding Precision Issues
-
-```python
-from decimal import Decimal
-
-# Use Decimal for financial calculations
-price = Decimal('0.10')
-tax = Decimal('0.20')
-total = price + tax  # Exact: 0.30
-
-# Use math.isclose for float comparisons
-import math
-x = 0.1 + 0.2
-if math.isclose(x, 0.3):  # Accounts for precision
-    print("Equal within tolerance")
-```
-
-## Special Float Values
-
-| Value | Representation | Notes |
-|-------|-----------------|-------|
-| Positive infinity | `float('inf')` | Larger than any number |
-| Negative infinity | `float('-inf')` | Smaller than any number |
-| Not a Number | `float('nan')` | Unordered, `nan != nan` |
-| Zero | `0.0` or `-0.0` | Two representations |
-
-```python
-import math
-
-x = float('inf')
-y = float('nan')
-
-# Infinity operations
-print(x + 100)          # inf
-print(x - x)            # nan (indeterminate)
-print(x / x)            # nan
-
-# NaN behavior - unordered
-print(math.isnan(y))    # True
-print(y == y)           # False (NaN != NaN always)
-print(y < 5)            # False (unordered)
-print(y > 5)            # False (unordered)
-```
-
 ## Performance Characteristics
 
 ### Fixed-size Operations
@@ -212,20 +151,6 @@ for i in range(1000000):
 - **[Decimal](../stdlib/decimal.md)** - Arbitrary precision decimal
 - **[Fraction](../stdlib/fractions.md)** - Rational numbers
 
-## Best Practices
-
-✅ **Do**:
-
-- Use `float` for general numerical computation
-- Use `math.isclose()` for float comparisons
-- Use `round()` for display, not comparison
-
-❌ **Avoid**:
-
-- Comparing floats with `==` directly
-- Assuming decimal representation is exact
-- Using floats for financial calculations (use `Decimal`)
-
 ## Further Reading
 
 - [CPython Internals: float](https://zpoint.github.io/CPython-Internals/BasicObject/float/float.html) -

docs/builtins/int.md

@@ -146,9 +146,9 @@ a = 100
 b = 100
 print(a is b)  # True - same object!
 
-# Large integers use arbitrary precision
-x = 10**1000
-y = 10**1000
+# Large integers not cached
+x = 300
+y = 300
 print(x is y)  # False - different objects
 ```
 

docs/builtins/str.md

@@ -172,7 +172,7 @@ for word in words:
 result = "".join(words)
 
 # Also good: list comprehension with join
-result = "".join(w.upper() for w in words)
+result = "".join([w.upper() for w in words])
 ```
 
 ### String Formatting