poi icon indicating copy to clipboard operation
poi copied to clipboard

Update description for Maven

Open jzwolak opened this issue 4 months ago • 3 comments

The description reads "Apache POI - Java API To Access Microsoft Format Files" at https://central.sonatype.com/artifact/org.apache.poi/poi-ooxml

It should read "Apache POI - Java API To Access Microsoft File Formats".

https://chatgpt.com/share/690c9855-0260-8010-93e7-4a10aed54f37

jzwolak avatar Nov 06 '25 12:11 jzwolak

I prefer the existing description. I am a native English speaker. Format is an adjective for me and POI is about reading and writing files. Adjectives come before the noun (file) and 'Microsoft Format' can be regarded as an adjective.

I think Format as a noun is not right in this case.

pjfanning avatar Nov 06 '25 14:11 pjfanning

I hear your preference. The correct order is definitely "file format". If you prefer to put "format" before "file", you could write it like this "Microsoft Formatted Files", though that is not the common way people write this phrase, but it would convey the meaning well. Neither "File" nor "Format" are adjectives, so the adjective argument does not apply here.

See this GPT chat for more on how nouns can be placed before other nouns as "noun adjuncts" https://chatgpt.com/share/6913ab8d-c268-8010-a86e-60cd80c8bdeb

jzwolak avatar Nov 11 '25 21:11 jzwolak

One other point I just noticed is the README.md for Apache POI uses "file format" and has no instance of "format file"

jzwolak avatar Nov 19 '25 20:11 jzwolak