Strings: clarify the structure of “Details of the String Type”
Nobody has claimed this yet.
- Dominant language
- XML
- Stars
- 596
- Forks
- 890
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 55
Description
I would like to suggest a structural review of the later part of the “Details of the String Type” section on this page:
https://www.php.net/manual/en/language.types.string.php
My concern is not that the current content is technically wrong, but that this part of the page currently mixes several different layers of explanation, which makes it harder to follow.
In particular, these topics seem to be very close together at the moment:
- how string literals are encoded
- the practical expectation that modern PHP source files are usually UTF-8
- legacy or exceptional cases such as Zend Multibyte
- broader Unicode caveats that go beyond encoding, such as normalization or other assumptions programmers may make about text
Because of this, it is difficult to distinguish between:
- the core explanation of how PHP string literals are represented, and
- the broader point that correct Unicode handling requires more than choosing the right API.
For example, the paragraph about string literals seems to combine the basic “source file encoding” explanation with examples that are closer to Unicode normalization and general text-handling concerns.
I wonder whether this part of the page could be reorganized so that:
- the explanation of string literals stays focused on source-file encoding,
- modern UTF-8 usage is treated as the practical default case,
- legacy/special cases are more clearly separated,
- and broader Unicode caveats remain in the final general discussion.
I am not proposing a concrete replacement text here, but I think separating these layers more clearly would make the page easier to read, especially for readers approaching PHP strings from a modern UTF-8-oriented context.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the “Details of the String Type” section in language.types.string.php, linked from the issue. Review how the later paragraphs present source-file encoding, UTF-8 practice, Zend Multibyte, and broader Unicode concerns. Done means the section separates these layers clearly without changing its technical meaning.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- php
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100