php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #80681 SVN mentions in manual and dochowto
Submitted: 2021-01-28 13:20 UTC Modified: 2021-01-28 15:32 UTC
From: ae@php.net Assigned:
Status: Open Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If this is not your bug, you can add a comment by following this link.
If this is your bug, but you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: ae@php.net
New email:
PHP Version: OS:

 

 [2021-01-28 13:20 UTC] ae@php.net 
Description:
------------
The PHP Manual > Appendices > About the manual [1] mentions SVN a lot, so the manual tutorial (dochowto) [2].

They need a rewrite from the recent SVN to git migration.


[1] https://www.php.net/manual/en/about.generate.php and https://www.php.net/manual/en/about.translations.php

[2] http://doc.php.net/tutorial/

Expected result:
----------------
No mention of SVN (or CVS!) sources of the manual.

Actual result:
--------------
"The XML source code may be downloaded from SVN and viewed at » https://svn.php.net/viewvc/."

"People involved in the translations start from the XML source code available from » https://svn.php.net/viewvc/ and from it they translate"

"To checkout the documentation source, use a modified version of the following command where you change {LANG} to a desired language, such as en for only English:

svn checkout https://svn.php.net/repository/phpdoc/modules/doc-{LANG} phpdoc-{LANG}"

"Obtaining SVN access"

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2021-01-28 13:43 UTC] cmb@php.net 
Just earlier today I committed a (partial?) fix[1] for the manual.

[1] <https://github.com/php/doc-en/commit/9ffcc250271e62382436b7952691284cd98042f5>
 [2021-01-28 14:37 UTC] ae@php.net 
Yes... I opened this bug almost as a reaction from this specific commit, but to track other places that need a revision up to a full rewrite.

But english is not my native language, so I'm not up to the task,
 [2021-01-28 15:32 UTC] cmb@php.net 
> But english is not my native language, […]

Few, if any, current doc maintainers are native English speakers.
:)
 
PHP Copyright © 2001-2023 The PHP Group
All rights reserved. 		Last updated: Sun Dec 10 18:01:27 2023 UTC