Hi Lenya devs,

a while ago, we started to discussed the repository API terminology.
I think it's time that we agree on something, because that will
make further discussions easier.

That's not a vote, but it would be appreciated if you could state
your opinion. I'd like to emphasize that this discussion is not
about the API itself, but only about the terms we use. So please
don't go and complain about the concept of areas or language versions.
These issues can be discussed later on.


----

A website in Lenya is called a

- publication [+1]
- site
- ...

----

The resources of a website can exist at the same time in several

- areas [+1]
- ...

----

The entirety of plain information (without structuring) is called

- content [+1]
- resources
- ...

----

The set of language versions of a piece of information is called

- content node
- content item [+1]
- document
- resource
- ...

----

A specific language version is called

- content item
- language version [+1]
- document
- ...

----

A version in the history of a language version is called

- (history) version [+1]
- ...

----

The structuring information (there may be several of them) are

- sites
- structures [+1]
- navigations

(maybe we have to make a distinction between "structure" and "navigation")

----

A node in the structure is called

- (structure) node [+1]
- site node
- navigation item
- ...


For me, the following text sounds quite good:

In Lenya, a website, or an independent part of a large website, or a collection
of documents to manage, is called a *publication*. The content of a
publication is stored in *areas* to allow different versions to exist
at the same time (e.g., authoring, staging, and live).

Lenya stores the actual *content* in a non-hierarchical way.
Each *content item* consists of a set of *language versions*.
Each *version* of the history of a language version can be viewed and
rolled back to.

To create navigation widgets, sitemaps etc., *structures* can be created.
The *structure nodes* reference the content items or specific language versions.



WDYT?

-- Andreas


--
Andreas Hartmann
Wyona Inc.  -   Open Source Content Management   -   Apache Lenya
http://www.wyona.com                      http://lenya.apache.org
[EMAIL PROTECTED]                     [EMAIL PROTECTED]


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to