diff --git a/ortools/sat/doc/boolean_logic.md b/ortools/sat/doc/boolean_logic.md
index d3b7e60dde..7ec6a794ff 100644
--- a/ortools/sat/doc/boolean_logic.md
+++ b/ortools/sat/doc/boolean_logic.md
@@ -4,4 +4,91 @@
 
 ## Introduction
 
-The CP-SAT solver can express boolean variables and constraints.
+The CP-SAT solver can express boolean variables and constraints. A **boolean
+variable** is a integer variable between 0 and 1. A **literal** is either a
+boolean variable or its negation. Please note that this negation is different
+from the opposite operation on integer variables.
+
+## Boolean variables and literals
+
+### Python code
+
+    from google3.util.operations_research.sat.python import cp_model
+
+    model = cp_model.CpModel()
+    x = model.NewBoolVar('x')
+    literal = x.Not()
+
+### C++ code
+
+    #include "ortools/sat/cp_model.pb.h"
+    #include "ortools/sat/cp_model_utils.h"
+
+    namespace operations_research {
+    namespace sat {
+
+    CpModelProto cp_model;
+
+    auto new_boolean_variable = [&cp_model]() {
+      const int index = cp_model.variables_size();
+      IntegerVariableProto* const var = cp_model.add_variables();
+      var->add_domain(0);
+      var->add_domain(1);
+      return index;
+    };
+
+    const int x = new_boolean_variable();
+    const int literal = NegatedRef(x);
+
+    }  // namespace sat
+    }  // namespace operations_research
+
+## Boolean constraints
+
+There are three boolean constraints.
+
+-   or(literal1, .., literaln)
+-   and(literal1, .., literaln)
+-   xor(literal1, .., literaln)
+
+### Python code
+
+    from google3.util.operations_research.sat.python import cp_model
+
+    model = cp_model.CpModel()
+    x = model.NewBoolVar('x')
+    y = model.NewBoolVar('y')
+    model.AddBoolOr([x, y.Not()])
+
+### C++ code
+
+    #include "ortools/sat/cp_model.pb.h"
+    #include "ortools/sat/cp_model_utils.h"
+
+    namespace operations_research {
+    namespace sat {
+
+    CpModelProto cp_model;
+
+    auto new_boolean_variable = [&cp_model]() {
+      const int index = cp_model.variables_size();
+      IntegerVariableProto* const var = cp_model.add_variables();
+      var->add_domain(0);
+      var->add_domain(1);
+      return index;
+    };
+
+    auto add_bool_or = [&cp_model](const std::vector<int>& literals) {
+      BooleanArgumentProto* const bool_or =
+          model.add_constraints()->mutable_bool_or();
+      for (const int lit : literals) {
+        mutable_bool_or->add_literals(lit);
+      }
+    };
+
+    const int x = new_boolean_variable();
+    const int y = new_boolean_variable();
+    add_bool_or({x, NegatedRef(y)});
+
+    }  // namespace sat
+    }  // namespace operations_research
diff --git a/ortools/sat/doc/index.md b/ortools/sat/doc/index.md
index b2f7997694..3fa84b4b4e 100644
--- a/ortools/sat/doc/index.md
+++ b/ortools/sat/doc/index.md
@@ -2,10 +2,9 @@
 
 
 
-This document presents modeling recipes for the CP-SAT solver.
-These are grouped by type:
-
-  - [boolean logic](boolean_logic.md)
-  - [integer arithmetic](integer_arithmetic.md)
-  - [scheduling](scheduling.md)
+This document presents modeling recipes for the CP-SAT solver. These are grouped
+by type:
 
+-   [boolean logic](boolean_logic.md)
+-   [integer arithmetic](integer_arithmetic.md)
+-   [scheduling](scheduling.md)
diff --git a/ortools/sat/doc/scheduling.md b/ortools/sat/doc/scheduling.md
index 509314583a..53119c26a4 100644
--- a/ortools/sat/doc/scheduling.md
+++ b/ortools/sat/doc/scheduling.md
@@ -35,6 +35,9 @@ and C++.
 
     #include "ortools/sat/cp_model.pb.h"
 
+    namespace operations_research {
+    namespace sat {
+
     CpModelProto cp_model;
 
     auto new_variable = [&cp_model](int64 lb, int64 ub) {
@@ -64,3 +67,6 @@ and C++.
     const int duration_var = new_constant(10);
     const int end_var = new_variable(0, horizon);
     const int interval_var = new_interval(start_var, duration_var, end_var);
+
+    }  // namespace sat
+    }  // namespace operations_research