Growing Pains

  • Growth by accretion has resulted in some content models that are at best odd and at worst broken in pretty obvious ways.

  • Ten years of incremental growth has also changed the scale of DocBook. Designing a schema of roughly 400 elements is different than designing a schema of roughly 100. Logically extending decisions that looked regular and consistent when DocBook had 100 elements has not always resulted in a design that continues to look regular and consistent.