https://bz.apache.org/bugzilla/show_bug.cgi?id=70118

--- 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 “A part small enough to
escape casual notice”: 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 latest
> version,
Many projects support several versions of their product, not just the latest.
Even httpd’s website documents several versions (at least 2.0, 2.2, 2.4 and
2.5). A product’s website can also play multiple roles, such as advertising,
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 functions of
a product’s website. That has been expected for decades. Perhaps, in 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 “The Latest Version”
section before the “Installation” section feels like an anachronism.

(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’s contents as
Markdown.

I agree that the contents of README in trunk use Markdown syntax. What I meant
is that a README is normally plain text, and httpd’s has no declaration that it
contains Markdown. If one opens it directly, the OS has no clue it is Markdown,
since the file has no extension, and Markdown has no file type signature.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to