servo / servo/book

Documentation for inline layout algorithm

Open
#75 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
42
Forks
71
Avg merge
1d 5h
Merged PRs (30d)
8

Description

Motivation

Existing online crate documentation mostly follows CSS specification: CSS Inline Layout Module Level 3, part 2, Inline Layout Model. But this is very high level overview. I belie that a number of important details should be explained for newcomers to web technologies domain.
Lets add documentation on such things as:

  • Box tree and Inline Formatting Context construction
  • Bidi processing and reordering
  • Text shaping
  • Line breaking #76
  • Fragments generation #77

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the online inline layout crate documentation and the CSS Inline Layout Module Level 3 model section linked in the issue. Map the existing high-level material against the requested topics: box tree and inline formatting context construction, bidi processing, text shaping, line breaking, and fragment generation. Done means these newcomer-focused details are documented, while issues #76 and #77 identify separate line-breaking and fragment work.

Written by the indexing model from the issue text.

Assessment

Tech stack
css
Domain
documentation, web-dev
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.