Add a guide for the new tables (#3655)

Co-authored-by: Laurenz <laurmaedje@gmail.com>

Cargo.lock

@@ -2622,7 +2622,7 @@ dependencies = [
 [[package]]
 name = "typst-dev-assets"
 version = "0.10.0"
-source = "git+https://github.com/typst/typst-dev-assets?rev=c63ab46#c63ab467b6d2242b7993b81c1156b915486bcf02"
+source = "git+https://github.com/typst/typst-dev-assets?rev=2eec695#2eec695af4b8b32c079e549b78c64ef7ff5d5fff"
 
 [[package]]
 name = "typst-docs"

Cargo.toml

@@ -26,7 +26,7 @@ typst-svg = { path = "crates/typst-svg" }
 typst-syntax = { path = "crates/typst-syntax" }
 typst-timing = { path = "crates/typst-timing" }
 typst-assets = { git = "https://github.com/typst/typst-assets", rev = "4d1211a" }
-typst-dev-assets = { git = "https://github.com/typst/typst-dev-assets", rev = "c63ab46" }
+typst-dev-assets = { git = "https://github.com/typst/typst-dev-assets", rev = "2eec695" }
 az = "1.2"
 base64 = "0.22"
 bitflags = { version = "2", features = ["serde"] }

crates/typst/src/model/table.rs

@@ -24,6 +24,9 @@ use crate::visualize::{Paint, Stroke};
 ///
 /// Tables are used to arrange content in cells. Cells can contain arbitrary
 /// content, including multiple paragraphs and are specified in row-major order.
+/// For a hands-on explanation of all the ways you can use and customize tables
+/// in Typst, check out the [table guide]($guides/table-guide).
+///
 /// Because tables are just grids with different defaults for some cell
 /// properties (notably `stroke` and `inset`), refer to the [grid
 /// documentation]($grid) for more information on how to size the table tracks

docs/guides/guide-for-latex-users.md

@@ -10,8 +10,6 @@ out Typst. We will explore the main differences between these two systems from a
 user perspective. Although Typst is not built upon LaTeX and has a different
 syntax, you will learn how to use your LaTeX skills to get a head start.
 
-<!-- Mention that Typst is not built upon LaTeX -->
-
 Just like LaTeX, Typst is a markup-based typesetting system: You compose your
 document in a text file and mark it up with commands and other syntax. Then, you
 use a compiler to typeset the source file into a PDF. However, Typst also

docs/guides/welcome.md

@@ -11,3 +11,4 @@ propose other topics for guides!
 ## List of Guides
 - [Guide for LaTeX users]($guides/guide-for-latex-users)
 - [Page setup guide]($guides/page-setup-guide)
+- [Table guide]($guides/table-guide)

docs/src/lib.rs

@@ -167,6 +167,7 @@ fn guide_pages(resolver: &dyn Resolver) -> PageModel {
     page.children = vec![
         md_page(resolver, &base, load!("guides/guide-for-latex-users.md")),
         md_page(resolver, &base, load!("guides/page-setup.md")),
+        md_page(resolver, &base, load!("guides/tables.md")),
     ];
     page
 }