Re: [PHP-DOC] This PHP Manual build is broken

2013-09-19 Thread Levi Morrison
Thanks for fixing this: I was not aware that listitem could not contain text nodes (or so it seems).

Re: [PHP-DOC] Strict standards errors

2013-09-09 Thread Levi Morrison
Tangent: On Mon, Sep 9, 2013 at 4:37 PM, Chris Wright wrote: > > I know the new MD-esque format is pretty much definitely going to > happen... Docs migration is a serious subject that needs more discussion if it's going to happen.

Re: [PHP-DOC] Getting more people involved.. bye bye Docbook

2013-08-10 Thread Levi Morrison
After looking at what Hannes proposed, I think it is simple and fairly usable. I see potential parsing issues in the synopsis section, though. The code portion of that section should be marked somehow, perhaps with: ``php-synopsis int function strpos( string $haystack, mixed $needle,

Re: [PHP-DOC] Re: [PHP-WEBMASTER] CHM (with user notes) documentation is out of date

2013-07-10 Thread Levi Morrison
On Wed, Jul 10, 2013 at 9:14 PM, Bogdan Popescu wrote: > I noticed CHM has been removed completely from > http://www.php.net/download-docs.php. Will it come back or is this final? > > Thank you! > They will come back if someone can fix them.

Re: [PHP-DOC] PHD renders and as tags in HTML; this is problematic.

2013-06-30 Thread Levi Morrison
> This certainly feels like something we should be doing in PhD-land. >>> "Fixing" the docs would be a nightmare, we wrap everything in s. And >>> remember that HTML isn't the only output format for our docs, any changes >>> to the DocBook structure must take the other media into consideration. >>

Re: [PHP-DOC] PHD renders and as tags in HTML; this is problematic.

2013-06-30 Thread Levi Morrison
On Wed, Jun 26, 2013 at 3:17 PM, Peter Cowburn wrote: > On 26 June 2013 21:10, Levi Morrison wrote: > >> I currently don't know anything about PHD. I'm willing to learn and work >> on this, but my understanding is that before I make any changes that I am >>

[PHP-DOC] PHD renders and as tags in HTML; this is problematic.

2013-06-26 Thread Levi Morrison
PHD renders as a tag. This is problematic because in HTML the tag cannot contain all sorts of things that a DocBook can, most notably lists. The parameters and see also sections of every page have a wrapped around the list. Since the tag cannot contain a list, Chrome and others will 'fix' the

[PHP-DOC] Re: Jetbrains PhpStorm OpenSource License Upgrade + Mentioning JetBrains on php.net

2013-06-26 Thread Levi Morrison
> > But we are not > thanking them as a team for allowing you to use their commercial > product, which they advertise is free to use for open source projects > anyway. > The difference is that I see it as being generous to allow open source projects to use a commercial product at no cost.Our mirro

[PHP-DOC] Re: [PHP-WEBMASTER] Uservoice & the new look / docs

2013-06-25 Thread Levi Morrison
On Tue, Jun 25, 2013 at 3:43 PM, Paul Dragoonis wrote: > salathe registered the account, he shared admin details with me to moderate > and close off issues that I fix. > > Not sure what the best way to share these details is, but they really ought to be shared somehow.

[PHP-DOC] Re: Jetbrains PhpStorm OpenSource License Upgrade + Mentioning JetBrains on php.net

2013-06-25 Thread Levi Morrison
On Tue, Jun 25, 2013 at 11:07 AM, Hannes Magnusson wrote: > On Tue, Jun 25, 2013 at 12:49 AM, Alexey Shein wrote: > > Hello, guys, > > > > JetBrains team supported us again and upgraded our free PhpStorm > license, so > > if you need that - feel free to drop me a letter with your php.net id :) >

[PHP-DOC] Re: Jetbrains PhpStorm OpenSource License Upgrade + Mentioning JetBrains on php.net

2013-06-25 Thread Levi Morrison
On Tue, Jun 25, 2013 at 1:49 AM, Alexey Shein wrote: > Hello, guys, > > JetBrains team supported us again and upgraded our free PhpStorm license, > so if you need that - feel free to drop me a letter with your php.net id > :) > > There's one more thing to decide. Elena (Jetbrains Community Suppor

[PHP-DOC] Re: [PHP-WEBMASTER] User notes guidelines.

2013-01-10 Thread Levi Morrison
> Another way to look at this is if the function lacks something not otherwise > covered by another function. To elaborate I've seen user implementations of > count that work on multidimensional arrays. Obviously PHP has no similar > function. There is no count_recursive in PHP so I think that's fi

Re: [PHP-DOC] PHP.net tutorials improvements

2012-12-31 Thread Levi Morrison
I appreciate your enthusiasm and I do agree that the tutorial portion of the section needs a rewrite. However, I disagree with much of the content you propose. We should stay away from frameworks, PHP fig, and ORMS in the manual. What we really need is a way to teach basic PHP mechanics to a new

Re: [PHP-DOC] Fixing the layout/style for man pages

2012-12-29 Thread Levi Morrison
>> 2. Kill the Quick TOC in the documentation. This frees up a lot of >> space, but means we need to find a new home for the language switcher >> and how to report an error. > > We have a pull request on GitHub to deal with this: > https://github.com/php/web-php/pull/8. I'm not crazy about the s

Re: [PHP-DOC] Fixing the layout/style for man pages

2012-12-28 Thread Levi Morrison
Funny you should ask about these things. I was working on prototype.php.net site a lot about a year ago, but then got caught up with my work. Things I believe should be finished before launch: 1. The documentation pages need to be full-page width. They are far too narrow in their current sta

Re: [PHP-DOC] Coming back into the fold.

2012-09-26 Thread Levi Morrison
On Wed, Sep 26, 2012 at 12:08 PM, Hannes Magnusson wrote: > On Wed, Sep 26, 2012 at 10:50 AM, Karoly Negyesi wrote: >> On Wed, Sep 26, 2012 at 10:45 AM, Levi Morrison >> wrote: >>>> >>>> > Any new tools? >>>> >>>> We evolve v

Re: [PHP-DOC] Coming back into the fold.

2012-09-26 Thread Levi Morrison
> > > Any new tools? > > We evolve very slowly, don't think there have been any > tooling/structure changes for years :) > Yes, but we did move from svn to git.