docs: improve cross-linking within reference

ibis/expr/schema.py

@@ -17,7 +17,7 @@
 
 
 class Schema(Concrete, Coercible, MapSet):
-    """An object for holding table schema information."""
+    """An ordered mapping of str -> [datatype](./datatypes.qmd), used to hold a [Table](./expression-tables.qmd#ibis.expr.tables.Table)'s schema."""
 
     fields: FrozenDict[str, dt.DataType]
     """A mapping of [](`str`) to

ibis/expr/types/generic.py

@@ -82,6 +82,8 @@ def hash(self) -> ir.IntegerValue:
     def cast(self, target_type: dt.DataType) -> Value:
         """Cast expression to indicated data type.
 
+        Similar to `pandas.Series.astype`.
+
         Parameters
         ----------
         target_type
@@ -877,7 +879,7 @@ def desc(self) -> ir.Value:
         return ops.SortKey(self, ascending=False).to_expr()
 
     def as_table(self) -> ir.Table:
-        """Promote the expression to a table.
+        """Promote the expression to a [Table](./expression-tables.qmd#ibis.expr.types.Table).
 
         Returns
         -------

ibis/expr/types/relations.py

@@ -695,7 +695,7 @@ def columns(self) -> list[str]:
         return list(self.schema().names)
 
     def schema(self) -> sch.Schema:
-        """Return the schema for this table.
+        """Return the [Schema](./schemas.qmd#ibis.expr.schema.Schema) for this table.
 
         Returns
         -------