From 431f873def056d99b3c378827f4ce5f5c88b7cc9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Olender?=
 <92638966+TC-MO@users.noreply.github.com>
Date: Tue, 10 Dec 2024 10:23:27 +0100
Subject: [PATCH] further changes

---
 CONTRIBUTING.md | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1ff30562d..19a72739d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -105,7 +105,7 @@ You should be able to open https://docs.apify.loc in your browser and run all th
       - info
       - caution
       - danger
-    - Implement code tabs for multiple languages
+    - Use code tabs for multiple languages
     - Include proper metadata in front matter
 
     Example of proper usage and formatting:
@@ -144,7 +144,7 @@ You should be able to open https://docs.apify.loc in your browser and run all th
 Content lives in the following locations:
 
 - Main content like Platform documentation & Academy: `/sources` directory
-- API reference: Genereated from OpenAPI specs within `/apify-api` directory
+- API reference: Generated from OpenAPI specs within `/apify-api` directory
 - SDK docs: separate repositores
 - Client docs: separate repositories
 - CLI docs: separate repositories
@@ -153,7 +153,7 @@ Content lives in the following locations:
 
 ### Overview
 
-The API reference documentation at docs.apify.com is built directly froum our OpenAPI specification. The source of truth for the API specification lives in the `/apify-api`  directowy within [apify-docs](https://github.com/apify/apify-docs) repository.
+The API reference documentation at docs.apify.com is built directly froum our OpenAPI specification. The source of truth for the API specification lives in the `/apify-api/openapi`  directory within [apify-docs](https://github.com/apify/apify-docs) repository.
 
 ### Setup requirements
 
@@ -281,20 +281,20 @@ Add languages by adding new folders at the appropriate path level.
 1. Markdown:
 
     ```bash
-    npm run lint:md
-    npm run lint:md:fix
+    npm run lint:md # Checks for any issues using markdownlint
+    npm run lint:md:fix # Applies fixes
     ```
 
 2. Code:
 
     ```bash
-    npm run lint:code
-    npm run lint:code:fix
+    npm run lint:code # Checks .js & .ts files
+    npm run lint:code:fix # Applies fixes
     ```
 
 3. Prose:
 
-    - Use Vale for content linting
+    - Use [Vale](https://vale.sh/) for content linting
     - Configure exceptions in `accepts.txt`
 
 ## Pull request process
@@ -312,5 +312,4 @@ Add languages by adding new folders at the appropriate path level.
 ## Additional resources
 
 - [Docusaurus documentation](https://docusaurus.io/docs)
-- [OpenAPI specification]
 - [Vale style guide](https://vale.sh/docs)