id	summary	reporter	owner	description	type	status	priority	milestone	component	version	resolution	keywords	cc
923	"Integrate Joe's ""simp"" changes from main book"	Andrew Bradford	Andrew Bradford	"Joe had worked on the 'simp' branch of the main book back in 2011.  The goal was to provide a clfs specific schema that would present writing the book in a way that could have common and not-common sections all in one file.

For instance, most of the instructions for building GCC are such that there's a ton of text that's common to all archs.  Only some text is specific to which ever arch is being read.  Right  now we end up with a common file and one file per arch with lots of references back to the common file.  This makes reading either the common file or each of the arch's files difficult as seeing how to get from the files to the output is difficult.  With Joe's 'simp' changes everything goes in one file and the section that's specific to any arch or another goes inline with indication for which arch it's for.  Multiple archs can go together in a block, such as if just one arch is different.

Migration to this new 'simp' style can be done seamlessly based on the last tests I remember Joe doing.  As things are converted over they automatically start using the new schemas and validation.  Until they get converted, the old just docbook is used."	enhancement	assigned	trivial	CLFS Standard 3.1.0	BOOK	CLFS Standard GIT