documentations/dbm_watt_doc.py

import streamlit as st

st.markdown(
    """
# dBm Watt Calculator Documentation

## 1. Objective
Convert power values between dBm, Watt (W), and milliwatt (mW).

## 2. When to use this tool
Use this page for quick RF power conversions during planning, checks, and reporting.

## 3. Input files and accepted formats
No file upload is required.
Manual numeric input only.

## 4. Required fields
Three conversion modes are available:
- `dBm -> W + mW`
- `W -> dBm + mW`
- `mW -> dBm + W`

## 5. Step-by-step usage
1. Open `Apps > dBm <> Watt Calculator`.
2. Select conversion mode.
3. Enter input value.
4. Click `Convert`.
5. Read decimal and scientific notation outputs.

## 6. Outputs generated
- converted values in two units
- decimal and scientific formatting

## 7. Frequent errors and fixes
- Error for non-positive W input.
  - Fix: use value strictly greater than 0.
- Error for non-positive mW input.
  - Fix: use value strictly greater than 0.
- Unexpected value.
  - Fix: verify unit and conversion mode selection.

## 8. Minimal reproducible example
- Input: mode `dBm -> W + mW`, value `30`.
- Action: click `Convert`.
- Expected result: approximately `1 W` and `1000 mW`.

## 9. Known limitations
- Manual one-value conversion only.
- No batch file conversion in current version.
- No history of previous calculations.

## 10. Version and update date
- Documentation version: 1.0
- Last update: 2026-02-23
"""
)