enhance README & CONTRIBUTING guidelines

Author: TC-MO

.github/styles/config/vocabularies/Docs/accept.txt

@@ -123,3 +123,4 @@ walkthroughs?
 
 ul
 [Aa]gno
+pnpm

CONTRIBUTING.md

@@ -10,9 +10,10 @@
 
 ### Prerequisites
 
-1. Git
-2. Node.js
-3. GitHub access
+1. **Git**
+2. **Node.js 22** (see [.nvmrc](.nvmrc) file)
+3. **GitHub access**
+4. **npm** or **pnpm** package manager
 
 ### Installation steps
 
@@ -312,21 +313,21 @@ Add languages by adding new folders at the appropriate path level.
 
 ### Linting
 
-1. Markdown:
+1. **Markdown**:
 
     ```bash
     npm run lint:md # Checks for any issues using markdownlint
     npm run lint:md:fix # Applies fixes
     ```
 
-2. Code:
+2. **Code**:
 
     ```bash
     npm run lint:code # Checks .js & .ts files
     npm run lint:code:fix # Applies fixes
     ```
 
-3. Prose:
+3. **Prose**:
 
     - Use [Vale](https://vale.sh/) for content linting
     - Configure exceptions in `accepts.txt`
@@ -347,3 +348,5 @@ Add languages by adding new folders at the appropriate path level.
 
 - [Docusaurus documentation](https://docusaurus.io/docs)
 - [Vale style guide](https://vale.sh/docs)
+- [OpenAPI specification](https://spec.openapis.org/oas/v3.1.0)
+- [Redocly documentation](https://redocly.com/docs/)

README.md

@@ -21,13 +21,43 @@ Our documentation ecosystem consists of:
   - [Python](https://docs.apify.com/sdk/python/)
 - **CLI documentation** - [CLI docs](https://docs.apify.com/cli/)
 
-## Getting started
+## Getting Started
 
-Before contributing, read these essential resources:
+**Before contributing, read these essential resources:**
 
-- [Contributing guidelines](CONTRIBUTING.md)
-- [Documentation style guide](CONTRIBUTING.md#documentation-style-guide)
-- [AI Assistant Rules Structure](CONTRIBUTING.md#ai-assistant-rules-structure)
+- [Contributing guidelines](CONTRIBUTING.md) - Complete setup and contribution process
+- [Documentation style guide](CONTRIBUTING.md#documentation-style-guide) - Writing standards and formatting
+- [AI Assistant Rules Structure](CONTRIBUTING.md#ai-assistant-rules-structure) - AI tool configuration
+
+### Prerequisites
+
+- **Node.js 22** (see [.nvmrc](.nvmrc))
+- **npm** or **pnpm**
+- **Git**
+
+### Quick Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/apify/apify-docs.git
+cd apify-docs
+
+# Install dependencies
+npm install
+
+# Start development server
+npm start
+```
+
+The site will be available at `http://localhost:3000`
+
+### Available Scripts
+
+- `npm start` - Start development server with API docs
+- `npm run build` - Build for production
+- `npm run lint` - Run all linting checks
+- `npm run lint:fix` - Fix linting issues automatically
+- `npm run api:rebuild` - Regenerate API documentation
 
 ## Documentation architecture
 
@@ -57,7 +87,7 @@ Our documentation is built using:
 - **Automated Deployment**: CI/CD pipeline for continuous updates
 - **nginx routing**: Handles subdomain routing and redirects
 
-## Need help
+### Need help
 
 - For contribution questions, see our [Contributing Guidelines](CONTRIBUTING.md)
 - For technical issues, [create a GitHub issue](https://github.com/apify/apify-docs/issues/new)