Hello,

On Wed, 6 Feb 2019 at 14:17, azjezz <[email protected]> wrote:
>
> Good afternoon.
>
> as some of you may know, i am currently working on a new design for the 
> php.net website and i came across the installation page[1].
>
> the page contains information about "how to compile php from source" but no 
> "how to install it" and i think this is not a good for newbies.
>
> when i started PHP as a kid, i remember using XMAPP on windows, not because i 
> needed Apache or MySQL, but because the PHP site kept telling me that i need 
> `C runtime`, `VC CRT11` and then i should compile the source code and i 
> didn't know how to do that at the time and everything seemed just complicated.
>
> for this, i suggest that w add a new "installation instructions" to the php 
> website, and move the current pages to a new section called "compile from 
> source".
>
> i have added installation instruction page in the mock ups of the new design, 
> you might take a look at it here : 
> https://github.com/azjezz/web-php-mock-ups/blob/master/screenshots/windows-installation.png
>
> [1] :  https://secure.php.net/manual/en/install.php

The mockups in general looks great. Installation chapter itself is in
need of major refactoring for sure. Some things are not relevant
anymore and many are missing. Basically, what you're after in this
step is the way to go probably - to mention more options how to get up
and running fast. This probably needs to be synced with the options in
the manual or if a separate docs for only installation should be done
here. PHP installation itself is a very large topic. Compilation from
source is part of the PHP installation chapter. Also installing PHP on
Solaris, for example is also relevant. Goal of PHP is to be used on
any system, even Android and exotic things such as micro controllers.
How that works in practice at the moment, is another topic but for an
overview maybe.

Few quick tips:
- There is a migration to Git from SVN happening for the PHP manual.
Yes, the PHP manual is still in SVN at the moment. It is built from
the sources in XML files. Doing some major functionality changes to
the manual means also syncing things with this part and how the manual
is generated.
- There was a discussion happening about PHP.net mirrors getting
removed so that's one of the major things to be done probably with the
php.net site before other steps maybe. Mirrors at the moment block the
https migration and usage and upgrading the website code to PHP
7.2/7.3. There is still PHP 5.3 used. And mirrors mean 80+ webservers.

-- 
Peter Kokot

--
PHP Webmaster List Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to