firefox source docs do not include create/update dates
Categories
(Developer Infrastructure :: Firefox Source Docs: Content, defect)
Tracking
(Not tracked)
People
(Reporter: essin, Unassigned)
Details
User Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:103.0) Gecko/20100101 Firefox/103.0
Steps to reproduce:
https://firefox-source-docs.mozilla.org/index.html
Many pages appear to be obsolete, but who could tell. pages are not date-stamped
Actual results:
got instructions that don't correspond to latest FF
Expected results:
Either all docs should refer to latest version or should include date created/updated and list of applicable versions. Current situation is frustrating and a waste of time.
|
||
Comment 1•3 years ago
|
||
The pages are part of the Firefox source code and all changes to them are date stamped there: https://searchfox.org/mozilla-central/source/docs/index.rst If there are specific issues in things that are obsolete or incorrect you each page has a link to raise a bug about that.
|
Reporter | |
Comment 2•3 years ago
|
||
I'm sorry for being so stupid but I don't see a date anywhere on
https://firefox-source-docs.mozilla.org/devtools-user/browser_toolbox/index.html
Which shows options that are no longer displayed when clicking the 3 dots
Nor do I see a date anywhere on
https://searchfox.org/mozilla-central/source/docs/index.rst
I don't know if I'm blind, stupid or what but whe I seen material that does not correspond to the behavior of the current release, and I can't find any information about how old the docs are, my conclusion (obviously wrong and misguided) is that the docs are obsolete.
People love to chide me about being frustrated that I've wasted my time trying to use feautures that are described in the docs but that have been apparently been removed from the product. No one ever responds, gee maybe there's a problem here. Help me understand more about what you were trying to do and why you think the docs are wrong.
I'm using an ipad right now to write this. Maybe the date stamps don't display on the ipad, but I didn't see any using FF on win 11 either.
Call me Ishmael
|
|
Reporter | |
Comment 3•3 years ago
|
||
This is an example of good documentation. Applicapable version at top, date page updated ar bottom
https://docs.python.org/3/reference/simple_stmts.html#the-yield-statement
|
|
||
Comment 4•3 years ago
|
||
Go to https://searchfox.org/mozilla-central/source/docs/index.rst hover your mouse over the grey bar on the left. All the individual changes and their dates are visible.
Description
•