napi -> node-api

Author: avivkeller

pages/napi/getting-started/index.md

@@ -4,7 +4,7 @@ authors: gabrielschulhof, NickNaso, jschlight, mhdawson, KevinEady, avivkeller
 
 # CMake.js
 
-[CMake.js](https://github.com/cmake-js/cmake-js) is good build tool alternative to [node-gyp](/learn/napi/build-tools/node-gyp.md). CMake.js is based on the [CMake](https://cmake.org) tool which must be installed.
+[CMake.js](https://github.com/cmake-js/cmake-js) is good build tool alternative to [node-gyp](/learn/node-api/build-tools/node-gyp.md). CMake.js is based on the [CMake](https://cmake.org) tool which must be installed.
 
 ### Pros
 
@@ -78,7 +78,7 @@ In addition to the entries required for any CMake build, additional entries are
 Here are the lines required for all native modules built using CMake.js:
 
 ```cpp
-project(napi-cmake-build-example)
+project(node-api-cmake-build-example)
 include_directories(${CMAKE_JS_INC})
 file(GLOB SOURCE_FILES "hello.cc")
 add_library(${PROJECT_NAME} SHARED ${SOURCE_FILES} ${CMAKE_JS_SRC})

pages/napi/build-tools/cmake-js.md pages/node-api/build-tools/cmake-js.mdpages/napi/build-tools/cmake-js.md renamed to pages/node-api/build-tools/cmake-js.md

@@ -16,6 +16,6 @@ There are two broad strategies for shipping a native addon:
 
 ## Build tools covered in this section
 
-- [node-gyp](/learn/napi/build-tools/node-gyp.md) - the default build tool bundled with npm; uses Google's GYP format and is nearly universally supported in the Node ecosystem
-- [CMake.js](/learn/napi/build-tools/cmake-js.md) - a CMake-based alternative, well-suited for projects that already use CMake
-- [node-pre-gyp](/learn/napi/build-tools/node-pre-gyp.md) - a layer on top of node-gyp for distributing pre-built binaries via Amazon S3
+- [node-gyp](/learn/node-api/build-tools/node-gyp.md) - the default build tool bundled with npm; uses Google's GYP format and is nearly universally supported in the Node ecosystem
+- [CMake.js](/learn/node-api/build-tools/cmake-js.md) - a CMake-based alternative, well-suited for projects that already use CMake
+- [node-pre-gyp](/learn/node-api/build-tools/node-pre-gyp.md) - a layer on top of node-gyp for distributing pre-built binaries via Amazon S3

pages/napi/build-tools/index.md pages/node-api/build-tools/index.mdpages/napi/build-tools/index.md renamed to pages/node-api/build-tools/index.md

@@ -16,7 +16,7 @@ node-gyp is included with npm; when npm sees `"gypfile": true` in `package.json`
 npm install -g node-gyp
 ```
 
-For developers who find node-gyp too constraining, [CMake.js](/learn/napi/build-tools/cmake-js.md) is a good alternative.
+For developers who find node-gyp too constraining, [CMake.js](/learn/node-api/build-tools/cmake-js.md) is a good alternative.
 
 ### Pros
 

pages/napi/build-tools/node-gyp.md pages/node-api/build-tools/node-gyp.mdpages/napi/build-tools/node-gyp.md renamed to pages/node-api/build-tools/node-gyp.md

@@ -0,0 +1,25 @@
+---
+authors: avivkeller
+---
+
+# Getting Started with Node-API
+
+This section walks you through everything you need to begin building native Node.js addons with Node-API. It is designed for developers who are new to native addon development and want a guided path from zero to a working module.
+
+## What you will learn
+
+- [Prerequisites](/learn/node-api/getting-started/prerequisites.md) - the C/C++ and JavaScript knowledge you need before diving in
+- [The tools you'll need](/learn/node-api/getting-started/tools.md) - how to install Node, npm, Git, and the C/C++ toolchain on Windows, macOS, and Linux
+- [Anatomy of a Node-API project](/learn/node-api/getting-started/project-structure.md) - the common directory layout, `package.json` entries, `binding.gyp`, and the JavaScript wrapper layer shared by every `node-addon-api` project
+- [Your first project](/learn/node-api/getting-started/your-first-project.md) - building and running your first Node-API module
+- [ObjectWrap](/learn/node-api/getting-started/objectwrap.md) - exposing C++ objects as JavaScript objects using `node-addon-api`'s `ObjectWrap` class
+- [Migrating from NAN](/learn/node-api/getting-started/migration.md) - converting an existing NAN-based addon to Node-API
+
+## Which API level should I use?
+
+Node-API operates at two levels:
+
+- **C API** - built directly into Node.js and documented on the [Node.js API pages](https://nodejs.org/api/n-api.html). Gives you maximum control and no extra dependencies.
+- **C++ wrapper (`node-addon-api`)** - an npm package that wraps the C API in a friendlier C++ object model. Recommended for most projects because it reduces boilerplate significantly while preserving full ABI stability.
+
+The examples in this section use `node-addon-api`.

pages/napi/build-tools/node-pre-gyp.md …ges/node-api/build-tools/node-pre-gyp.mdpages/napi/build-tools/node-pre-gyp.md renamed to pages/node-api/build-tools/node-pre-gyp.md pages/napi/build-tools/node-pre-gyp.md renamed to pages/node-api/build-tools/node-pre-gyp.md

@@ -10,7 +10,7 @@ This tutorial uses the conversion tool supplied with Node-API to give you a head
 
 To keep things somewhat constrained, this tutorial uses [node-microtime](https://github.com/wadey/node-microtime) which is a simple NAN-based native add-on. This add-on makes system calls to determine the current time to microsecond resolution if supported by the operating system.
 
-Before you start, make sure you've got all the necessary [prerequisites](/learn/napi/getting-started/prerequisites.md) and [tools](/learn/napi/getting-started/tools.md) installed.
+Before you start, make sure you've got all the necessary [prerequisites](/learn/node-api/getting-started/prerequisites.md) and [tools](/learn/node-api/getting-started/tools.md) installed.
 
 > Node-API is stable in all currently supported Node.js releases. Use an [Active LTS or Maintenance LTS release](https://nodejs.org/en/about/releases/). You can check the version of Node.js you are running with `node -v`.
 

pages/node-api/getting-started/index.md

@@ -4,9 +4,9 @@ authors: gabrielschulhof, NickNaso, jschlight, mhdawson, KevinEady, avivkeller
 
 # Object Wrap
 
-This tutorial is an alternative to [Your First Project](/learn/napi/getting-started/your-first-project.md). Instead of exporting a plain function, it demonstrates how to expose a C++ object as a JavaScript object using `node-addon-api`'s `ObjectWrap` class.
+This tutorial is an alternative to [Your First Project](/learn/node-api/getting-started/your-first-project.md). Instead of exporting a plain function, it demonstrates how to expose a C++ object as a JavaScript object using `node-addon-api`'s `ObjectWrap` class.
 
-Before you start, make sure you've got all the necessary [prerequisites](/learn/napi/getting-started/prerequisites.md) and [tools](/learn/napi/getting-started/tools.md) installed, and read [Anatomy of a Node-API project](/learn/napi/getting-started/project-structure.md) to understand the common project layout and configuration files.
+Before you start, make sure you've got all the necessary [prerequisites](/learn/node-api/getting-started/prerequisites.md) and [tools](/learn/node-api/getting-started/tools.md) installed, and read [Anatomy of a Node-API project](/learn/node-api/getting-started/project-structure.md) to understand the common project layout and configuration files.
 
 ## Creating a project
 
@@ -36,7 +36,7 @@ npm test
 
 ## binding.gyp
 
-The project's [**binding.gyp**](https://github.com/nodejs/node-addon-examples/blob/main/src/2-js-to-native-conversion/object-wrap-demo/node-addon-api/binding.gyp) follows the standard format (see [Anatomy of a Node-API project](/learn/napi/getting-started/project-structure.md#bindinggyp) for a full explanation of the `binding.gyp` format and how `node-gyp` uses it).
+The project's [**binding.gyp**](https://github.com/nodejs/node-addon-examples/blob/main/src/2-js-to-native-conversion/object-wrap-demo/node-addon-api/binding.gyp) follows the standard format (see [Anatomy of a Node-API project](/learn/node-api/getting-started/project-structure.md#bindinggyp) for a full explanation of the `binding.gyp` format and how `node-gyp` uses it).
 
 ## src/object_wrap_demo.h and src/object_wrap_demo.cc
 

pages/napi/getting-started/migration.md …es/node-api/getting-started/migration.mdpages/napi/getting-started/migration.md renamed to pages/node-api/getting-started/migration.md pages/napi/getting-started/migration.md renamed to pages/node-api/getting-started/migration.md

@@ -12,4 +12,4 @@ For your own projects, it will be necessary to have an understanding of the C/C+
 
 ## Command line tools
 
-Many of the tools used to develop Node-API modules are run from the command line. So at least a passing familiarity and confidence with your command line tool is essential. IDEs, as described [here](/learn/napi/getting-started/tools.md#other-tools) can help. But they also rely in the command line.
+Many of the tools used to develop Node-API modules are run from the command line. So at least a passing familiarity and confidence with your command line tool is essential. IDEs, as described [here](/learn/node-api/getting-started/tools.md#other-tools) can help. But they also rely in the command line.