com web/doc: minor updates to tutorial builds page: tutorial/builds.md

[email protected] (Peter Cowburn) Mon, 01 Apr 2019 20:43:33 +0000
Newsgroups php.doc.web
Message-ID <[email protected]>
Commit:    eb5f58c55bfdf67328bf7fd0aabef67b2a31c92c=0AAuthor:    Peter Cowb=
urn <[email protected]>         Mon, 1 Apr 2019 21:43:33 +0100=0AParents:   5=
909e1b8325b547449c0744d2d782eeb53e0088c=0ABranches:  master=0A=0ALink:     =
  http://git.php.net/?p=3Dweb/doc.git;a=3Dcommitdiff;h=3Deb5f58c55bfdf67328=
bf7fd0aabef67b2a31c92c=0A=0ALog:=0Aminor updates to tutorial builds page=0A=
=0Amirrors -> web servers=0Abuild schedules=0Aadd Peter as point of contact=
 for docs.php.net=0Alink to phpdoc list=0A=0AChanged paths:=0A  M  tutorial=
/builds.md=0A=0A=0ADiff:=0Adiff --git a/tutorial/builds.md b/tutorial/build=
s.md=0Aindex 1e5e678..fe58333 100644=0A--- a/tutorial/builds.md=0A+++ b/tut=
orial/builds.md=0A@@ -1,16 +1,15 @@=0A # The PHP Manual builds=0A =0A The P=
HP Manual is written in [DocBook][docbook] and built by [PhD][phd], and=0A-=
these builds are rsynced to the mirrors for users to use.=0A+these builds a=
re rsynced to the web servers for users to use.=0A =0A ## Mirror builds=0A-=
The [rsync box][rsync.php.net] builds the manuals every night, at around 5:=
00 UTC.=0A-The mirrors then pick up these builds when they sync, which usua=
lly happens every hour.=0A-When a mirror syncs depends on how its cron is s=
et up.=0A+The [rsync box][rsync.php.net] builds the manuals every night, at=
 around 05:00 UTC.=0A+The web servers then pick up these builds when they s=
ync, which usually happens every hour.=0A =0A ## Doc server builds=0A-The [=
docs development server][docs.php.net] builds the manual four times a day=
=0A-(0:15 6:15 12:15 and 18:15 UTC). This takes place on the [euk2][euk2] s=
erver.=0A+The [docs development server][docs.php.net] builds the manual six=
 times a day=0A+(every 4 hours, starting at midnight UTC). This takes place=
 on the [euk2][euk2] server.=0A An easy way to see when each translation wa=
s last built, is to look at the=0A [doc downloads page with dates][download=
-docs]. Also note that several old=0A translations reside on this particula=
r server, as it attempts to build every=0A@@ -18,7 +17,7 @@ translation (bo=
th active and inactive).=0A =0A ## CHM builds=0A The CHM version of the man=
ual is built on a Windows machine and pulled on Fridays,=0A-for distributio=
n to mirrors. [Richard][rquadling] maintains these builds.=0A+for distribut=
ion to web servers. [Richard][rquadling] maintains these builds.=0A =0A ## =
Validation=0A Aside from running `php configure.php =E2=80=93with-lang=3Dfo=
o` (see [editing](editing.php))=0A@@ -26,22 +25,20 @@ for a language, anoth=
er way to check if the docs validated is by looking at buil=0A dates on the=
 doc server. See "Doc server builds", above.=0A =0A ## Additional notes=0A-=
- If a manual does not validate on some day, it will not be pushed to the m=
irrors=0A+- If a manual does not validate on some day, it will not be pushe=
d to the web servers=0A   until it does validate (hopefully, the next day).=
=0A - Only active translations are built on rsync box (and then pushed to r=
egular=0A   mirrors). This is managed in [web/php/includes/languages.inc][l=
anguages.inc]=0A-- [docs.php.net][docs.php.net] attempts to build all trans=
lations (both active)=0A-  and inactive.=0A-=0A-  However, we use `broken-l=
anguage.txt` file in root of broken=0A-  translations to disable those very=
 outdated and failing to build=0A+- [docs.php.net][docs.php.net] attempts t=
o build all translations (both active=0A+  and inactive). However, we use a=
 `broken-language.txt` file in root of broken=0A+  translations to disable =
those that are very outdated and failing to build=0A   for a long time.=0A =
=0A ## The humans who manage these=0A If there is a problem with the synced=
 builds, it's wise to contact=0A [Derick][derick] or [Hannes][bjori].=0A If=
 a problem exists on the development server ([docs.php.net][docs.php.net]),=
=0A-then contact the documentation team.=0A+then contact [Peter][salathe] o=
r the [documentation team mailing list][phpdoc-list].=0A =0A [docbook]: htt=
p://www.docbook.org/=0A [phd]: http://doc.php.net/phd.php=0A@@ -54,3 +51,5 =
@@ then contact the documentation team.=0A [rquadling]: http://people.php.n=
et/rquadling=0A [derick]: http://people.php.net/derick=0A [bjori]: http://p=
eople.php.net/bjori=0A+[salathe]: http://people.php.net/salathe=0A+[phpdoc-=
list]: mailto:[email protected]=0A