<Cesar Harada> Open Architecture is written in AcademiXML, a custom markup format developed to enable multiple authors to contribute on the same document without loosing authorship.
In academia, documents without specified author (like Wikipedia articles) cannot be cited since tracing the author (responsible) is unclear. You CAN cite openarchitecture.cc, you know who is the author, you can contribute (request permission).
You don't need to be a coder to understand and use AcademiXML - it is super super super simple, just relax and read below.
Being able to have a document with different "voices" has many advantages :
- it is lively like a conversation, similar to theater.
- contradictory opinions can be expressed in the same paragraph by different people.
- a sentence can be started by someone (1), interrupted by someone else (2), ended by somebody else (many more).
- not having a "discussion page" or "hidden comments" : everything is on the same document (similar to google wave in many ways)
- the content of the website becomes easier to search/index by search engines.
- we can automate computer extraction of one specific author declarations.
- we avoid anonymous trolls :)
We can formulate together complex ideas while remaining simple and readable on a single level.
The Section "Contributors and syntax" specifies the real names (preferred) of the authors, dates of contributions, and author marker as <FirstName Name>.
We like the authors to share an email at which they can be reached if we have questions from visitors/ contributors/ admin/ publishers.
For those who refuse to use AcademiXML but still want to contribute, you can comment at the bottom of each page. Thanks.
Common mistake : BAD ! Don't do that.
Mistake in insertion :
This is wrong :( Impolite.
Don't put declaration inside someone else's declaration. Close the previous declaration, open yours, close yours, re-open the other's person's declaration :
This is right :) Polite, one after the other, listening to each other, a discussion.
Inconsistent markup :
This is not good, because the marker at the beginning is different from the marker at the end, so it won't be properly indexed / parsed if the document is analyzed for specific author automated extraction. Ideally the real name is the <name> - again, for authenticity and academic value.
If you have any questions, please feel free to contact me <contact [at] cesarharada [dot] dom>.
Of course AcademiXML1.0 is Public Domain, so feel free to use, modify, fork, distribute, format your academic papers in this format.
The fist AcademiXML1.0 document that has been officially been accepted in academia is "20090315open_architecture" available at the Royal College of Art, London, written under the kind supervision of Prof. Sarah Teasley, Critical History Tutor. Hiromi Ozaki (aka Sputniko) also wrote her RCA MA dissertation in AcademiXML2.0 also kept at the RCA central librairy . </Cesar Harada>