Enhance documentation examples with specific class titles for clarity

Signed-off-by: Piotr PG Gajek <[email protected]>

Author: pgajek2

website/docs/advanced-usage/fls.md

@@ -18,7 +18,7 @@ none (by default) | `USER_MODE` | enforced
 
 `USER_MODE` is a enabled by default. It means that **the object permissions, field-level security**, as well as sharing rules, **are enforced**.
 
-```apex
+```apex title="SOQL_Account.cls"
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
     public static SOQL_Account query() {
         return new SOQL_Account();
@@ -34,7 +34,7 @@ public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selecto
 The object permissions, field-level security, and sharing rules are enforced.
 Access to the `Account` object and fields (`Account.Name` and `Account.AccountNumber`) will be checked.
 
-```apex
+```apex title="ExampleController.cls"
 public without sharing class ExampleController {
     public static List<Account> getAccountsByRecordType(String recordType) {
         return SOQL_Account.query().toList();
@@ -48,7 +48,7 @@ public without sharing class ExampleController {
 
 Developer can disable `USER_MODE` and enable `SYSTEM_MODE` using `.systemMode()` method.
 
-```apex
+```apex title="SOQL_Account.cls"
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
     public static SOQL_Account query() {
         return new SOQL_Account();
@@ -64,7 +64,7 @@ public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selecto
 
 The object permissions and field-level permissions are ignored.
 
-```apex
+```apex title="ExampleController.cls"
 public without sharing class ExampleController {
     public static List<Account> getAccountsByRecordType(String recordType) {
         return SOQL_Account.query().toList();
@@ -78,7 +78,7 @@ public without sharing class ExampleController {
 You may encounter situations where you need object and field-level security but want to ignore sharing rules (`without sharing`).
 To achieve this, use `.systemMode()`, `.withoutSharing()` and `.stripInaccessible()`.
 
-```apex
+```apex title="SOQL_Account.cls"
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
     public static SOQL_Account query() {
         return new SOQL_Account();
@@ -96,7 +96,7 @@ public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selecto
 
 The object permissions and field-level permissions are enforced, but sharing rules are ignored.
 
-```apex
+```apex title="ExampleController.cls"
 public without sharing class ExampleController {
     public static List<Account> getAccountsByRecordType(String recordType) {
         return SOQL_Account.query().toList();

website/docs/advanced-usage/mocking.md

@@ -7,7 +7,7 @@ sidebar_position: 30
 Mocking provides a way to substitute records from a Database with some prepared data. Data can be prepared in form of SObject records and lists in Apex code or Static Resource `.csv` file.
 Mocked queries won't make any SOQL's and simply return data set in method definition, mock __will ignore all filters and relations__, what is returned depends __solely on data provided to the method__. Mocking is working __only during test execution__. To mock SOQL query, use `.mockId(id)` method to make it identifiable. If you mark more than one query with the same ID, all marked queries will return the same data.
 
-```apex
+```apex title="ExampleController.cls"
 public with sharing class ExampleController {
 
     public static List<Account> getPartnerAccounts(String accountName) {
@@ -111,7 +111,7 @@ This behavior is consistent with Salesforce’s native limits, ensuring that you
 
 ## List of records
 
-```apex
+```apex title="ExampleControllerTest.cls"
 @IsTest
 private class ExampleControllerTest {
 
@@ -134,7 +134,7 @@ private class ExampleControllerTest {
 
 ## Single record
 
-```apex
+```apex title="ExampleControllerTest.cls"
 @IsTest
 private class ExampleControllerTest {
 
@@ -152,7 +152,7 @@ private class ExampleControllerTest {
 
 ## Static resource
 
-```apex
+```apex title="ExampleControllerTest.cls"
 @IsTest
 private class ExampleControllerTest {
 
@@ -170,7 +170,7 @@ private class ExampleControllerTest {
 
 ## Count Result
 
-```
+```apex title="ExampleControllerTest.cls"
 @IsTest
 private class ExampleControllerTest {
 
@@ -195,7 +195,7 @@ _Using JSON String_
 
 By passing simple String, it is possible to write non-writable fields, like `Name` on Contact object.
 
-```
+```apex
 @IsTest
 static void getAccountsWithContacts() {
     List<Account> mocks = (List<Account>) JSON.deserialize(
@@ -221,7 +221,7 @@ _Using Serialization/Deserialization_
 
 Using this approach it is possible to bind data with additional logic, like using Test Data Factory.
 
-```
+```apex
 @IsTest
 static void getAccountsWithContacts() {
     List<Account> mocks = (List<Account>) JSON.deserialize(
@@ -256,7 +256,7 @@ static void getAccountsWithContacts() {
 
 ## Parent relationship
 
-```
+```apex
 @IsTest
 private class ExampleControllerTest {
     @IsTest
@@ -281,7 +281,7 @@ There is no way to create a `new AggregateResult()` instance in Apex. You can fi
 
 To mock `AggregateResult`, we introduced `SOQL.AggregateResultProxy`, which provides the same methods as the standard `AggregateResult` class.
 
-```apex
+```apex title="ExampleController.cls"
 public with sharing class ExampleController {
     public void getLeadAggregateResults() {
         List<SOQL.AggregateResultProxy> result = SOQL.of(Lead.SObjectType)
@@ -292,8 +292,9 @@ public with sharing class ExampleController {
             .toAggregatedProxy(); // <== use toAggregatedProxy()
     }
 }
+```
 
-
+```apex title="ExampleControllerTest.cls"
 @IsTest
 public class ExampleControllerTest {
     @IsTest
@@ -324,7 +325,7 @@ Pass an empty list: `.thenReturn(new List<Type>())`;
 
 This behavior will be the same as it is during runtime.
 
-```apex
+```apex title="ExampleControllerTest.cls"
 @IsTest
 public class ExampleControllerTest {
     private static final String TEST_ACCOUNT_NAME = 'MyAccount 1';

website/docs/advanced-usage/sharing.md

@@ -19,7 +19,7 @@ none (by default) | `USER_MODE` | `with sharing`
 
 `USER_MODE` is a enabled by default. It means that the object permissions, field-level security and **sharing rules are enforced**.
 
-```apex
+```apex title="SOQL_Account.cls"
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
     public static SOQL_Account query() {
         return new SOQL_Account();
@@ -34,7 +34,7 @@ public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selecto
 
 The object permissions, field-level security, and sharing rules are enforced. Class sharing mode is ignored (`without sharing`).
 
-```apex
+```apex title="ExampleController.cls"
 public without sharing class ExampleController {
     public static List<Account> getAccountsByRecordType(String recordType) {
         return SOQL_Account.query().toList();
@@ -51,7 +51,7 @@ Developers can control the sharing mode (`inherited sharing`, `with sharing`, an
 
 **NOTE!** To make it work, always set `inherited sharing` in your selector class.
 
-```apex
+```apex title="SOQL_Account.cls"
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
     public static SOQL_Account query() {
         return new SOQL_Account();
@@ -67,7 +67,7 @@ public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selecto
 
 The object permissions and field-level permissions are ignored. Sharing rules are controlled by the sharing mode (`without sharing`).
 
-```apex
+```apex title="ExampleController.cls"
 public without sharing class ExampleController {
     public static List<Account> getAccountsByRecordType(String recordType) {
         return SOQL_Account.query().toList();
@@ -79,7 +79,7 @@ public without sharing class ExampleController {
 
 You can force the sharing mode for all of your queries.
 
-```apex
+```apex title="SOQL_Account.cls"
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
     public static SOQL_Account query() {
         return new SOQL_Account();
@@ -96,7 +96,7 @@ public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selecto
 
 The object permissions and field-level permissions are ignored. Sharing rules are controlled by the sharing mode specified in the `query()` method (`.withSharing()`).
 
-```apex
+```apex title="ExampleController.cls"
 public with sharing class ExampleController {
     public static List<Account> getAccountsByRecordType(String recordType) {
         return SOQL_Account.query().toList();
@@ -109,7 +109,7 @@ public with sharing class ExampleController {
 
 You can force the sharing mode for all of your queries.
 
-```apex
+```apex title="SOQL_Account.cls"
 public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selector {
     public static SOQL_Account query() {
         return new SOQL_Account();
@@ -126,7 +126,7 @@ public inherited sharing class SOQL_Account extends SOQL implements SOQL.Selecto
 
 The object permissions and field-level permissions are ignored. Sharing rules are controlled by the sharing mode specified in the `query()` method (`.withoutSharing()`).
 
-```apex
+```apex title="ExampleController.cls"
 public with sharing class ExampleController {
     public static List<Account> getAccountsByRecordType(String recordType) {
         return SOQL_Account.query().toList();

website/docs/advanced-usage/soql-caching.md

@@ -75,7 +75,7 @@ This clear distinction gives architects full control over which records should b
 
 Additionally, Cached Selectors look slightly different and include cache-specific methods:
 
-```apex
+```apex title="SOQL_ProfileCache.cls"
 public with sharing class SOQL_ProfileCache extends SOQLCache implements SOQLCache.Selector {
     public static SOQL_ProfileCache query() {
         return new SOQL_ProfileCache();

website/src/css/custom.css

@@ -53,3 +53,25 @@ body {
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
 }
+
+.prism-code {
+  counter-reset: line-number;
+  border: 1px solid #eaeaea;
+  border-radius: 5px;
+  padding: 1em;
+  background-color: #f9f9f9;
+}
+.prism-code > code > span {
+  display: block;
+  counter-increment: line-number;
+  position: relative;
+  padding-left: 3.5em;
+}
+.prism-code > code > span::before {
+  content: counter(line-number);
+  position: absolute;
+  left: 0;
+  width: 2.5em;
+  text-align: right;
+  color: #999;
+}