Re: Splittling into chapters?

On Thu, 31 Jul 2014 12:34:37 +0400, Rob Allen <rob@akrabat.com> wrote:

On 31 Jul 2014, at 10:31, Stas Malyshev <smalyshev@sugarcrm.com> wrote:

Hi! What do you think about splitting it into chapters instead of having one huge document? I've made a pull: https://github.com/php/php-langspec/pull/27 using very simple script to just split on "#Whatever" and use "whatever" as a file name. This make some scripts a bit more complex, though nothing prevents one from merging it back when needed to build other formats.

The only issue I can think of is that the order of each chapter is implicitly alphabetical. I wonder if it would be helpful if the file names started with a chapter number? Regards, Rob... -- PHP Naming Standardization Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php

Hi Rob, Probably better to make them fixed-length numbers, as in 001, 002, ..., 099 and so on, this way order of the files sorted using string comparison won't be messed up :)