Thanks Andrea :) It is confusing indeed. And to my embarrassment, I only skimmed the precis.
Note that my understanding here was that the sample/documents are mostly aimed at new/casual users (who may well not know about the finer points) and would probably find the description docx more recognisable than ooxml. But looking at the other thread, samples/documents now seems to be moving towards being a developer stash of useful edge cases. In which case our tree probably needs yet another split, one for users to allow them to just try out Corinthia with 1-2 simple test cases of the supported formats that convert 1-1 into each other, and another tree for devs who are more interested in a collection of edge cases than a simple sample and stuff like bindings. Maybe what we need is: $ tree . └── samples ├── dev │ ├── code │ │ └── bindings │ └── documents │ ├── html │ ├── odt │ ├── ooxml │ └── tex └── user ├── docx ├── html ├── latex └── odf where I am assuming that the user has no requirements for code samples. G On Wed, Apr 29, 2015 at 7:02 PM, Andrea Pescetti <pesce...@apache.org> wrote: > Gabriela Gibson wrote: > >> The thing is though, when you do a web search for ooxml, the top link (at >> least in Ireland) is this: >> " >> Office Open XML (OOXML) is an XML-based file format used for representing >> word processing documents, spreadsheets, and presentations. It is >> conceptually similar to ODF in many respects, though a lot of the details >> differ. ... >> https://wiki.openoffice.org/wiki/Office_Open_XML >> So, by that definition, docx is not ooxml >> > > Why? Are you falling into the usual trap of confusing "Office Open XML" > and "Open Office XML"? Yes, .docx is OOXML (see below for a clarification) > and everything you quoted seems correct. While the page you cite comes from > the OpenOffice wiki, the page describes the Microsoft Word 2007 (and later) > format. > > Now, this is a simplification, since OOXML is the standard (the theory) > while the actual implementation (i.e., the thing that Microsoft Word writes > in the .docx file) has slight deviations from the standard depending on the > Microsoft Word version and settings. But, to a large degree of > approximation, .docx files are OOXML files and are completely different > from "OpenOffice" (i.e., ODF) files, while both formats are XML-based. > > Regards, > Andrea. > -- Visit my Coding Diary: http://gabriela-gibson.blogspot.com/