Overview

The official Salesforce Developer Documentation portal (developer.salesforce.com/docs) serves as the authoritative source of truth for platform architects, software engineers, and integration developers. With hundreds of distinct developer guides, API specifications, and reference manuals spanning more than twenty years of platform evolution, navigating the documentation library requires understanding its architectural taxonomy.

The documentation is organized around six foundational architectural pillars: Core Platform & Languages, APIs & Integration Services, Metadata & Application Lifecycle Management (ALM), Agentforce & Einstein AI, Data Cloud & Lakehouse, and Revenue & Industry Clouds.

Salesforce Developer Documentation Ecosystem & Navigation Hierarchy


Pillar 1: Core Platform & Programming Languages

This section houses the guides for building custom business logic, user interfaces, and automated workflows directly on the Lightning Platform.

1. Apex Developer Guide & Reference

  • URL: https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_intro.htm
  • What It Covers:
    • Apex language syntax, object-oriented concepts, and execution flow.
    • Governor limits (SOQL, DML, Heap, CPU timeouts) and transaction management.
    • Triggers, context variables, and trigger frameworks.
    • Asynchronous Apex: Queueable, Batchable, Schedulable, and Future methods.
    • System namespace reference (System, Database, Schema, ConnectApi).

2. Lightning Web Components (LWC) Developer Guide

  • URL: https://developer.salesforce.com/docs/component-library
  • What It Covers:
    • Modern web standards-based reactive UI framework.
    • Component lifecycle hooks (connectedCallback, renderedCallback, disconnectedCallback).
    • Lightning Data Service (LDS) wire adapters and functions (getRecord, updateRecord).
    • Base components library (lightning-input, lightning-datatable, lightning-card).
    • Inter-component communication via Custom Events and Lightning Message Service (LMS).

3. Object Reference for the Salesforce Platform


Pillar 2: APIs & Integration Services

The Salesforce API Library (developer.salesforce.com/docs/apis) outlines the programmatic endpoints used by external applications, middleware, and microservices to exchange data with Salesforce.

API Name Documentation Link Protocol / Format Recommended Workload
REST API REST API Guide HTTP / JSON / XML Synchronous record CRUD, search, and lightweight transactions.
Bulk API 2.0 Bulk API 2.0 Guide Async REST / CSV Batch importing or querying datasets >2,000 records up to 150M records/day.
GraphQL API GraphQL API Guide GraphQL / JSON Eliminating over-fetching in mobile and single-page apps with a single round-trip query.
Pub/Sub API Pub/Sub API Guide gRPC / HTTP/2 / Binary Real-time event streaming for Platform Events and Change Data Capture (CDC).
Connect REST API Connect REST Guide HTTP / JSON Simplified, business-process-oriented access to Chatter, CMS, and B2B Commerce.
SOAP API SOAP API Guide SOAP / WSDL / XML Strongly typed enterprise integrations requiring strict enterprise or partner contracts.

Pillar 3: Metadata, DevOps & Developer Tools

Salesforce’s modern developer tooling focuses on source-driven development, scratch org lifecycles, and automated continuous delivery.

1. Metadata API Developer Guide

2. Salesforce CLI Command Reference (sf)

3. Second-Generation Packaging (2GP) Guide


Pillar 4: Agentforce & Einstein AI

The newest and fastest-growing segment of the developer documentation covers generative AI, autonomous agent design, and enterprise AI orchestration.


Pillar 5: Data Cloud & Lakehouse Analytics

Documentation for zero-copy data federation, real-time streaming, and high-speed analytical querying.


Pillar 6: Revenue & Industry Cloud Guides

Salesforce provides specialized developer manuals for enterprise industries and business applications:


How to Choose the Right Salesforce Developer Resource

If your task is… Start with this official guide Primary Technology
Writing custom triggers or transactional business logic Apex Developer Guide Apex, SOQL, Unit Tests
Building interactive UI components in record pages Lightning Web Components Reference HTML5, Modern ES6+, CSS
Connecting an external system for high-volume ETL Bulk API 2.0 Developer Guide REST, CSV, Async Jobs
Building event-driven architectures with real-time push Pub/Sub API Developer Guide gRPC, Protocol Buffers, CDC
Deploying code and managing CI/CD release pipelines Salesforce CLI Reference & 2GP Guide CLI (sf), GitHub Actions
Implementing AI agents and autonomous assistants Agentforce & Models API Guides Generative AI, MCP, Prompts
Querying unified cross-cloud customer data lakes Data Cloud Query SQL API Guide ANSI SQL, Lakehouse, DMOs
Headless quoting and automated contract amendments Salesforce CPQ Developer Guide SBQQ.ServiceRouter, Apex

Frequently asked questions

What are the primary entry points for official Salesforce developer documentation?

The primary portal is developer.salesforce.com/docs, which organizes resources into the Salesforce API Library, Apex and LWC developer guides, Object Reference, Metadata API, and cloud-specific developer centers.

What is the difference between the Salesforce Object Reference and the Metadata API Guide?

The Object Reference documents standard database tables and their fields for runtime data access via SOQL, SOSL, and REST. The Metadata API Guide documents XML types used to configure and deploy application schemas and code.

Where can developers find API documentation for Agentforce and AI models?

Agentforce guides and AI documentation are located under the Agentforce and Einstein hubs, detailing the Models API, Prompt Builder templates, Agent Script Builder, and Hosted Model Context Protocol servers.

How do Salesforce release cycles affect developer documentation versions?

Salesforce updates developer guides three times a year corresponding to Spring, Summer, and Winter releases. URLs often include release versions or redirect to the current active release version such as API v68.0.

Which API guide should be used for integrating large datasets into Salesforce?

The Bulk API 2.0 Developer Guide is the recommended resource for loading or querying datasets containing more than 2,000 records asynchronously, providing higher throughput than standard REST or SOAP APIs.

Where is the documentation for Salesforce CLI and modern DevOps workflows?

Salesforce CLI documentation, scratch org setup, and Second-Generation Packaging guides are hosted under the Developer Tools and DevOps Center sections on the official documentation portal.

Comments

Questions, corrections and tips are welcome. Comments are GitHub Discussions, so you sign in with GitHub.