编写包含状态机的C代码的文档通常需要遵循以下步骤：

1. 确定状态机的需求：首先，你需要明确状态机的目标和设计要求。包括状态的定义、状态之间的转换条件，以及状态转换时需要执行的操作等。

2. 定义状态和事件：根据需求，定义状态和事件的枚举类型。例如：

typedef enum {
    STATE_IDLE,
    STATE_RUNNING,
    STATE_ERROR
} State;

typedef enum {
    EVENT_START,
    EVENT_STOP,
    EVENT_ERROR
} Event;

3. 定义状态机结构体：创建一个状态机结构体，用于保存当前状态和处理状态转换的函数指针等信息。

typedef struct {
    State currentState;
    void (*stateHandler)(Event event);
} StateMachine;

4. 实现状态转换函数：根据状态机的需求，实现状态转换函数。根据当前状态和触发的事件，执行相应的状态转换和操作。例如：

void stateTransition(StateMachine* stateMachine, Event event) {
    switch(stateMachine->currentState) {
        case STATE_IDLE:
            if(event == EVENT_START) {
                stateMachine->currentState = STATE_RUNNING;
                stateMachine->stateHandler = runningStateHandler;
            }
            break;
        case STATE_RUNNING:
            if(event == EVENT_STOP) {
                stateMachine->currentState = STATE_IDLE;
                stateMachine->stateHandler = idleStateHandler;
            } else if(event == EVENT_ERROR) {
                stateMachine->currentState = STATE_ERROR;
                stateMachine->stateHandler = errorStateHandler;
            }
            break;
        case STATE_ERROR:
            // handle error state
            break;
        default:
            break;
    }
}

5. 实现状态处理函数：根据状态机的需求，编写对应的状态处理函数。例如：

void idleStateHandler(Event event) {
    // handle idle state
}

void runningStateHandler(Event event) {
    // handle running state
}

void errorStateHandler(Event event) {
    // handle error state
}

6. 初始化状态机：在主程序中初始化状态机，并设置初始状态和状态处理函数。

int main() {
    StateMachine stateMachine;
    stateMachine.currentState = STATE_IDLE;
    stateMachine.stateHandler = idleStateHandler;

    // main loop
    while(1) {
        // wait for event
        Event event = waitForEvent();

        // handle event
        stateMachine.stateHandler(event);

        // transition to new state
        stateTransition(&stateMachine, event);
    }

    return 0;
}

在编写文档时，可以使用注释来解释代码的功能和实现细节，包括状态和事件的定义、状态转换的逻辑、状态处理函数的功能等。

此外，你还可以使用图表或流程图来可视化状态机的状态和状态转换过程，以便更好地理解和阐述代码的逻辑。