docs: improve README documentation

Author: code-by-sia

README.md

@@ -1,65 +1,92 @@
 # OpenWebSheet
-OpenSource Web based spreadsheet 
 
-[<img src=https://github.com/SiamandMaroufi/OpenWebSheet/workflows/CI/badge.svg />](https://github.com/SiamandMaroufi/OpenWebSheet/actions?query=workflow%3ACI)
+OpenWebSheet is an open-source, web-based spreadsheet application. It runs in the browser, can be installed as a Progressive Web App (PWA), and stores spreadsheet documents in the project’s `.ows` format.
 
- 
-### Installed PWA: 
+[<img src="https://github.com/SiamandMaroufi/OpenWebSheet/workflows/CI/badge.svg" alt="CI status" />](https://github.com/SiamandMaroufi/OpenWebSheet/actions?query=workflow%3ACI)
 
-<img src="https://siamandmaroufi.github.io/OpenWebSheet/demo.png" />
+## Demo and PWA installation
 
-##### for installing the pwa app click on install icon at the url bar's right side
+<img src="https://siamandmaroufi.github.io/OpenWebSheet/demo.png" alt="OpenWebSheet demo" />
 
-1. <a href="https://siamandmaroufi.github.io/OpenWebSheet/" >Install</a> the PWA application <br />
-2. <a href="https://siamandmaroufi.github.io/OpenWebSheet/demo/DEMO.ows" download="download" target="_blank" >Download</a>  the `demo.ows` sample  file
-3. click on load *Folder Icon* and load the sample file
+1. Open the hosted app: <https://siamandmaroufi.github.io/OpenWebSheet/>
+2. Install the PWA using the install icon in the browser address bar.
+3. Download the sample file: <https://siamandmaroufi.github.io/OpenWebSheet/demo/DEMO.ows>
+4. Use the folder/load icon in the app to open the sample `.ows` file.
 
+## Features
 
+- Canvas-based spreadsheet rendering
+- Basic cell content editing
+- Borders
+- Merge and split cells
+- Basic formula support
+- Import/export support for the native `.ows` format
+- PWA support
 
+## Roadmap
 
-### Roadmap
-
-* [x] basic structure
-* [x] canvas rendering
-* [x] basic content editor
-* [x] borders
-* [x] merge and split
-* [ ] formula and expressions
-  * [x] Basic Support
-  * [ ] Advanced features
-* [x] import/export
-  * [x] Mathematical formulas
-  * [ ] Open office format support
-* [ ] advanced ui features
+- [x] Basic structure
+- [x] Canvas rendering
+- [x] Basic content editor
+- [x] Borders
+- [x] Merge and split
+- [ ] Formula and expressions
+  - [x] Basic support
+  - [ ] Advanced features
+- [x] Import/export
+  - [x] Mathematical formulas
+  - [ ] OpenOffice/OpenDocument format support
+- [ ] Advanced UI features
 
+## Project setup
 
+Install dependencies:
 
-## Project setup
-```
+```sh
 npm install
 ```
 
-### Compiles and hot-reloads for development
-```
+Start the development server:
+
+```sh
 npm run serve
 ```
 
-### Compiles and magnifies for production
-```
+Build for production:
+
+```sh
 npm run build
 ```
 
-### Run your tests
-```
-npm run test
-```
+Run linting:
 
-### Lints and fixes files
-```
+```sh
 npm run lint
 ```
 
-### Run your unit tests
-```
+Run unit tests:
+
+```sh
 npm run test:unit
 ```
+
+## Documentation
+
+Additional documentation is available in the [`docs/`](docs/) directory:
+
+- [Development guide](docs/development.md)
+- [Architecture overview](docs/architecture.md)
+- [User guide](docs/user-guide.md)
+- [Supported formats](docs/supported-formats.md)
+
+## Contributing
+
+1. Create an issue or choose an existing one.
+2. Create a focused branch for the change.
+3. Keep changes small and reviewable.
+4. Run linting and tests before opening a pull request.
+5. Update documentation when behavior, setup, or architecture changes.
+
+## License
+
+No license file is currently included in the repository. Add one before publishing or reusing the project in environments that require explicit licensing terms.