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 >