Update README.md

Author: nagpai

README.md

@@ -3,100 +3,94 @@
 <!-- TODO add playground demo link -->
 
 ## Overview
-A collection of rich text formats for WordPress that enhance the block editor with interactive elements, starting with InfoTip tooltips and Marker highlights. More in the future!
+A collection of rich text formats for the WordPress block editor with interactive elements. Starting with InfoTip tooltips and Marker highlights. More to come in the future!
 
-## Features
-
-### 🎯 Marker Format
-- **Text Highlighting**: Emphasize important content with customizable markers
-- **Visual Styling**: Multiple marker animations, styles and colors.
-- **Easy Integration**: Simple toolbar button integration in the block editor
-
-### 🔍 InfoTip Format
-- **Interactive Tooltips**: Add contextual information that appears on hover or click
-- **Customizable Appearance**: Control background color, text color, and placement
-- **Flexible Positioning**: 12 placement options (top, bottom, left, right with start/end variants)
-- **Smart Placement**: Automatic fallback positioning to ensure tooltips stay visible
-- **Responsive Design**: Works seamlessly across desktop and mobile devices
+## Requirements
+- WordPress 6.6+
+- Modern browser with JavaScript enabled
+- Floating UI library (included)
 
 
 ## Installation
 
-1. Download the latest release zip file from GitHub  <!--TODO - GH link to be added for release -->
-2. Upload to your WordPress `/wp-content/plugins/` directory
-3. Activate the plugin through the 'Plugins' menu in WordPress
-4. Start using the new formats in your block editor
+1. Download the latest release from GitHub  <!--TODO - GH link to be added for release -->
+2. Browse to `WP Admin > Plugins > Add New`
+3. Upload the `blablablocks-formats.zip` file
+4. Activate `BlaBlaBlocks Formats` from the plugins page
 
 ## Usage
 
 ### InfoTip Format
 
+<!-- TODO - add recording --> 
+
 1. Select any text in the block editor
 2. Click the InfoTip button in the formatting toolbar
 3. Configure your tooltip with custom text, colors, and overlay placement
 
 
 ### Marker Format
 
+<!-- TODO - add recording -->
+
 1. Select text you want to highlight
 2. Click the Marker button in the formatting toolbar
 3. Choose your preferred highlighting style and animation
 
-## Technical Details
 
-### Requirements
-- WordPress 5.0+
-- Modern browser with JavaScript enabled
-- Floating UI library (included)
+## Development
 
-### Technologies Used
-- **WordPress Block Editor API**: Native integration with Gutenberg via the [Rich Text API](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-rich-text/). 
-- **Floating UI**: Advanced positioning system for tooltips
-- **Web Components**: Custom elements for frontend rendering
-- **React**: Editor interface components
-- **SCSS**: Modular styling system
+### 1. Clone the repository
+Clone the repository to your local system:
 
+```bash
+git clone git@github.com:lubusIN/blablablocks-formats.git
+```
 
-## Development
+### 2. Go to the plugin folder
 
-### Building the Plugin
+```bash
+cd blablablocks-formats
+```
+
+### 3. Install dependencies
 
 ```bash
-# Install dependencies
 npm install
+```
 
-# Build
-npm run build
+### 4. Build plugin
+Build or start the development environment:
+
+```bash
+npm run build       # Compile the source files
+# OR
+npm run start       # Watch for changes and auto-compile
+```
+### 5. Launch Playground
 
-# Watch for changes
-npm run start
+```bash
+npm run serve
 ```
 
-## Contributing
+## Meet Your Artisans
 
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+[LUBUS](http://lubus.in) is a web design agency based in Mumbai.
 
-## Changelog
+<a href="https://cal.com/lubus">
+<img src="https://raw.githubusercontent.com/lubusIN/.github/refs/heads/main/profile/banner.png" />
+</a>
 
-### 1.0.0
-- Initial release
-- InfoTip format with advanced positioning
-- Marker format for text highlighting
-- Web Components for frontend rendering
-- Comprehensive editor integration
+## Credits
+<!-- TODO check if this works after repo is made public -->L
+<a href="https://github.com/lubusIN/blablablocks-formats/graphs/contributors">
+  <img height="36px" src="https://contrib.rocks/image?repo=lubusIN/blablablocks-formats"/>
+</a>
 
-## Support
+* [Marker](https://thenounproject.com/icon/marker-7644139/) icon by [Amir Ali](https://thenounproject.com/amirali) from [Noun Project](https://thenounproject.com/browse/icons/term/marker/) (CC BY 3.0)
 
-For support, feature requests, or bug reports, please open an issue on the project repository.
 
 ## License
 
 This project is licensed under the MIT license.
 
-## Credits
-
-* [Marker](https://thenounproject.com/icon/marker-7644139/) icon by [Amir Ali](https://thenounproject.com/amirali) from [Noun Project](https://thenounproject.com/browse/icons/term/marker/) (CC BY 3.0)