Re: [STANDARDS] Splittling into chapters?

[email protected] (Joel Marcey)
Newsgroups php.standards
Message-ID <CFFF9C0B.ADDC%[email protected]>
Hi!

We thought about this too before releasing the spec. See my comment here:

https://github.com/php/php-langspec/pull/3#issuecomment-50672207

The issue came down to maintaining the consistency of the internal
reference links (all those §§ you see). They break if you separate the
spec into multiple chapters Š unless of course your pull request handled
that, then yay!! 

But, otherwise, if we are ok with multiple chapters and broken links for a
while until I (or someone) writes a script to fix it, then I am ok with
this.

Joel Marcey

On 7/31/14, 1:31 AM, "Stas Malyshev" <[email protected]> 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.
>
>-- 
>Stanislav Malyshev, Software Architect
>SugarCRM: 
>https://urldefense.proofpoint.com/v1/url?u=http://www.sugarcrm.com/&k=ZVNj
>lDMF0FElm4dQtryO4A%3D%3D%0A&r=wGbJiiHCLM%2FCBILbHfp%2FHA%3D%3D%0A&m=1i2gyA
>pVtGDMBBeq160Dqmw82heLtCCaKX8dx1uX8XM%3D%0A&s=2983d985546ff26edc915e3d4cf5
>bd0c8a9615613a36a518905b42687dca2efb
>
>-- 
>PHP Naming Standardization Mailing List
>(https://urldefense.proofpoint.com/v1/url?u=http://www.php.net/&k=ZVNjlDMF
>0FElm4dQtryO4A%3D%3D%0A&r=wGbJiiHCLM%2FCBILbHfp%2FHA%3D%3D%0A&m=1i2gyApVtG
>DMBBeq160Dqmw82heLtCCaKX8dx1uX8XM%3D%0A&s=e733bcc577263633019edce9e2c1d3ef
>ba883161e0b2bbd8bf47ae97519d2b71)
>To unsubscribe, visit:
>https://urldefense.proofpoint.com/v1/url?u=http://www.php.net/unsub.php&k=
>ZVNjlDMF0FElm4dQtryO4A%3D%3D%0A&r=wGbJiiHCLM%2FCBILbHfp%2FHA%3D%3D%0A&m=1i
>2gyApVtGDMBBeq160Dqmw82heLtCCaKX8dx1uX8XM%3D%0A&s=ff9a73294b1e12e4dcb2f457
>8509d41467f9f7a2a5151a118acff681f820db56
>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.