refactor: Rename job macros and update documentation

- Renamed `spacedrive_job` macro to `job` for clarity and consistency across the SDK.
- Updated references in the SDK and test extension to reflect the new macro name.
- Enhanced comments in the test extension to better describe functionality and usage.
- Added "checkpointing" to the cspell project words for improved spell checking.

.cspell/project_words.txt

@@ -8,6 +8,7 @@ benja
 Bento
 brendonovich
 chacha
+checkpointing
 codegen
 Condvar
 dashmap

crates/sdk-macros/src/job.rs

@@ -4,7 +4,7 @@ use proc_macro::TokenStream;
 use quote::quote;
 use syn::{parse_macro_input, FnArg, ItemFn, Type};
 
-pub fn spacedrive_job_impl(_args: TokenStream, input: TokenStream) -> TokenStream {
+pub fn job_impl(_args: TokenStream, input: TokenStream) -> TokenStream {
 	let input_fn = parse_macro_input!(input as ItemFn);
 
 	// Extract function info

crates/sdk-macros/src/lib.rs

@@ -12,7 +12,7 @@ mod job;
 /// # Example
 ///
 /// ```no_run
-/// #[spacedrive_job]
+/// #[job]
 /// async fn email_scan(ctx: &JobContext, state: &mut EmailScanState) -> Result<()> {
 ///     for email in fetch_emails(&state.last_uid)? {
 ///         ctx.check()?;  // Auto-checkpoints!
@@ -29,8 +29,8 @@ mod job;
 /// - Error handling
 /// - Auto-checkpoint on interrupt
 #[proc_macro_attribute]
-pub fn spacedrive_job(args: TokenStream, input: TokenStream) -> TokenStream {
-	job::spacedrive_job_impl(args, input)
+pub fn job(args: TokenStream, input: TokenStream) -> TokenStream {
+	job::job_impl(args, input)
 }
 
 /// Extension container macro

crates/sdk/src/lib.rs

@@ -43,4 +43,4 @@ pub mod prelude {
 }
 
 // Re-export macros
-pub use spacedrive_sdk_macros::{extension, spacedrive_job};
+pub use spacedrive_sdk_macros::{extension, job};

extensions/test-extension/src/lib.rs

@@ -1,17 +1,19 @@
-//! Test Extension - Beautiful API Demo
+//! Test Extension
 //!
-//! This shows what extension development looks like with macros.
-//! Compare to test-extension/ to see the difference!
+//! Demonstrates the Spacedrive extension SDK using procedural macros to simplify
+//! extension development by abstracting FFI and state management details.
 
 use spacedrive_sdk::prelude::*;
-use spacedrive_sdk::{extension, spacedrive_job};
+use spacedrive_sdk::{extension, job};
 
-// === Extension Definition (generates plugin_init/cleanup) ===
+// Extension Definition
+// The #[extension] macro generates plugin initialization and cleanup functions.
 
 #[extension(id = "test-extension", name = "Test Extension", version = "0.1.0")]
 struct TestExtension;
 
-// === Job State ===
+// Job State Definition
+// State is automatically serialized/deserialized for checkpointing.
 
 #[derive(Serialize, Deserialize, Default)]
 pub struct CounterState {
@@ -20,10 +22,10 @@ pub struct CounterState {
 	pub processed: Vec<String>,
 }
 
-// === Beautiful Job Definition ===
+// Job Implementation
+// The #[job] macro handles FFI bindings, serialization, and error handling.
 
-/// This is ALL you write! The macro handles everything else.
-#[spacedrive_job]
+#[job]
 fn test_counter(ctx: &JobContext, state: &mut CounterState) -> Result<()> {
 	ctx.log(&format!(
 		"Starting counter (current: {}, target: {})",
@@ -31,46 +33,37 @@ fn test_counter(ctx: &JobContext, state: &mut CounterState) -> Result<()> {
 	));
 
 	while state.current < state.target {
-		// Check interruption - if interrupted, auto-checkpoints and returns!
+		// Check for interruption signals
 		if ctx.check_interrupt() {
 			ctx.log("Interrupted, saving state...");
 			ctx.checkpoint(state)?;
 			return Err(Error::OperationFailed("Interrupted".into()));
 		}
 
-		// Do work
+		// Process work unit
 		state.current += 1;
 		state.processed.push(format!("item_{}", state.current));
 
-		// Report progress
+		// Update progress reporting
 		let progress = state.current as f32 / state.target as f32;
 		ctx.report_progress(
 			progress,
 			&format!("Counted {}/{}", state.current, state.target),
 		);
 
-		// Track metrics
+		// Track processed items
 		ctx.increment_items(1);
 
-		// Checkpoint every 10
+		// Periodic checkpoint for recovery
 		if state.current % 10 == 0 {
 			ctx.checkpoint(state)?;
 		}
 	}
 
 	ctx.log(&format!(
-		"✓ Completed! Processed {} items",
+		"Completed processing {} items",
 		state.processed.len()
 	));
 
 	Ok(())
 }
-
-// That's it! No:
-// - #[no_mangle]
-// - extern "C"
-// - Pointer manipulation
-// - Manual serialization
-// - FFI boilerplate
-//
-// Just pure, clean business logic!