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! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
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 Apr 02 10:03:46 2023 UTC