[Bug 70118] README claims homepage cont ains “details of the latest version”

[email protected] Fri, 19 Jun 2026 17:24:54 +0000
Newsgroups gmane.comp.apache.documentation
Message-ID <[email protected]/bugzilla/>
https://bz.apache.org/bugzilla/show_bug.cgi?id=3D70118

--- Comment #3 from Philippe Cloutier <[email protected]> ---
Greetings Rich,

(In reply to Rich Bowen from comment #1)
> "Details of " and "information on" are synonymous.
Thank you, you seem to be right that these are parasynonymous. That is not =
how
I understood "Details of" though. I took "Details" merely as the plural of
"detail", which for example Wiktionary first defines as =E2=80=9CA part sma=
ll enough to
escape casual notice=E2=80=9D: https://en.wiktionary.org/wiki/detail#Noun
A quote from Wiktionary demonstrates the sense I expected:
> I don't concern myself with the details of accounting.
Anyway, apologies if I misinterpreted and feel free to mark this report as
invalid.

> And a product's website exists *solely* to provide information on the lat=
est
> version,
Many projects support several versions of their product, not just the lates=
t.
Even httpd=E2=80=99s website documents several versions (at least 2.0, 2.2,=
 2.4 and
2.5). A product=E2=80=99s website can also play multiple roles, such as adv=
ertising,
selling/distributing, recruiting developers and collecting feedback.

> so I have no idea how that can be "banal" or "dated".
Providing information on current versions is one of the most basic function=
s of
a product=E2=80=99s website. That has been expected for decades. Perhaps, i=
n pre-HTTP
times, when software was distributed on floppy disks, it made sense to tell
readers to go to the W-e-b s-i-t-e rather than Usenet to verify that what
reached them was fresh enough. But nowadays, featuring the =E2=80=9CThe Lat=
est Version=E2=80=9D
section before the =E2=80=9CInstallation=E2=80=9D section feels like an ana=
chronism.

(In reply to Rich Bowen from comment #2)
> FWIW the README was rewritten into markdown style formatting so that it
> would render correctly on the Github page. This happened in r1915387
Thanks
Hum, I see there is a README.md symbolic link to README, which contains
Markdown. I assume that is what lets GitHub interpret README=E2=80=99s cont=
ents as
Markdown.

I agree that the contents of README in trunk use Markdown syntax. What I me=
ant
is that a README is normally plain text, and httpd=E2=80=99s has no declara=
tion that it
contains Markdown. If one opens it directly, the OS has no clue it is Markd=
own,
since the file has no extension, and Markdown has no file type signature.

--=20
You are receiving this mail because:
You are the assignee for the bug.=