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