You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/09/03 14:33:00 UTC
[69/87] [abbrv] isis git commit: ISIS-1194: mothballing "site"
resources (everything under ./src).
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/schemas/xhtml-1.0/xhtml1-strict.dtd
----------------------------------------------------------------------
diff --git a/mothballed/src/schemas/xhtml-1.0/xhtml1-strict.dtd b/mothballed/src/schemas/xhtml-1.0/xhtml1-strict.dtd
new file mode 100644
index 0000000..2927b9e
--- /dev/null
+++ b/mothballed/src/schemas/xhtml-1.0/xhtml1-strict.dtd
@@ -0,0 +1,978 @@
+<!--
+ Extensible HTML version 1.0 Strict DTD
+
+ This is the same as HTML 4 Strict except for
+ changes due to the differences between XML and SGML.
+
+ Namespace = http://www.w3.org/1999/xhtml
+
+ For further information, see: http://www.w3.org/TR/xhtml1
+
+ Copyright (c) 1998-2002 W3C (MIT, INRIA, Keio),
+ All Rights Reserved.
+
+ This DTD module is identified by the PUBLIC and SYSTEM identifiers:
+
+ PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ SYSTEM "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
+
+ $Revision: 1.1 $
+ $Date: 2002/08/01 13:56:03 $
+
+-->
+
+<!--================ Character mnemonic entities =========================-->
+
+<!ENTITY % HTMLlat1 PUBLIC
+ "-//W3C//ENTITIES Latin 1 for XHTML//EN"
+ "xhtml-lat1.ent">
+%HTMLlat1;
+
+<!ENTITY % HTMLsymbol PUBLIC
+ "-//W3C//ENTITIES Symbols for XHTML//EN"
+ "xhtml-symbol.ent">
+%HTMLsymbol;
+
+<!ENTITY % HTMLspecial PUBLIC
+ "-//W3C//ENTITIES Special for XHTML//EN"
+ "xhtml-special.ent">
+%HTMLspecial;
+
+<!--================== Imported Names ====================================-->
+
+<!ENTITY % ContentType "CDATA">
+ <!-- media type, as per [RFC2045] -->
+
+<!ENTITY % ContentTypes "CDATA">
+ <!-- comma-separated list of media types, as per [RFC2045] -->
+
+<!ENTITY % Charset "CDATA">
+ <!-- a character encoding, as per [RFC2045] -->
+
+<!ENTITY % Charsets "CDATA">
+ <!-- a space separated list of character encodings, as per [RFC2045] -->
+
+<!ENTITY % LanguageCode "NMTOKEN">
+ <!-- a language code, as per [RFC3066] -->
+
+<!ENTITY % Character "CDATA">
+ <!-- a single character, as per section 2.2 of [XML] -->
+
+<!ENTITY % Number "CDATA">
+ <!-- one or more digits -->
+
+<!ENTITY % LinkTypes "CDATA">
+ <!-- space-separated list of link types -->
+
+<!ENTITY % MediaDesc "CDATA">
+ <!-- single or comma-separated list of media descriptors -->
+
+<!ENTITY % URI "CDATA">
+ <!-- a Uniform Resource Identifier, see [RFC2396] -->
+
+<!ENTITY % UriList "CDATA">
+ <!-- a space separated list of Uniform Resource Identifiers -->
+
+<!ENTITY % Datetime "CDATA">
+ <!-- date and time information. ISO date format -->
+
+<!ENTITY % Script "CDATA">
+ <!-- script expression -->
+
+<!ENTITY % StyleSheet "CDATA">
+ <!-- style sheet data -->
+
+<!ENTITY % Text "CDATA">
+ <!-- used for titles etc. -->
+
+<!ENTITY % Length "CDATA">
+ <!-- nn for pixels or nn% for percentage length -->
+
+<!ENTITY % MultiLength "CDATA">
+ <!-- pixel, percentage, or relative -->
+
+<!ENTITY % Pixels "CDATA">
+ <!-- integer representing length in pixels -->
+
+<!-- these are used for image maps -->
+
+<!ENTITY % Shape "(rect|circle|poly|default)">
+
+<!ENTITY % Coords "CDATA">
+ <!-- comma separated list of lengths -->
+
+<!--=================== Generic Attributes ===============================-->
+
+<!-- core attributes common to most elements
+ id document-wide unique id
+ class space separated list of classes
+ style associated style info
+ title advisory title/amplification
+-->
+<!ENTITY % coreattrs
+ "id ID #IMPLIED
+ class CDATA #IMPLIED
+ style %StyleSheet; #IMPLIED
+ title %Text; #IMPLIED"
+ >
+
+<!-- internationalization attributes
+ lang language code (backwards compatible)
+ xml:lang language code (as per XML 1.0 spec)
+ dir direction for weak/neutral text
+-->
+<!ENTITY % i18n
+ "lang %LanguageCode; #IMPLIED
+ xml:lang %LanguageCode; #IMPLIED
+ dir (ltr|rtl) #IMPLIED"
+ >
+
+<!-- attributes for common UI events
+ onclick a pointer button was clicked
+ ondblclick a pointer button was double clicked
+ onmousedown a pointer button was pressed down
+ onmouseup a pointer button was released
+ onmousemove a pointer was moved onto the element
+ onmouseout a pointer was moved away from the element
+ onkeypress a key was pressed and released
+ onkeydown a key was pressed down
+ onkeyup a key was released
+-->
+<!ENTITY % events
+ "onclick %Script; #IMPLIED
+ ondblclick %Script; #IMPLIED
+ onmousedown %Script; #IMPLIED
+ onmouseup %Script; #IMPLIED
+ onmouseover %Script; #IMPLIED
+ onmousemove %Script; #IMPLIED
+ onmouseout %Script; #IMPLIED
+ onkeypress %Script; #IMPLIED
+ onkeydown %Script; #IMPLIED
+ onkeyup %Script; #IMPLIED"
+ >
+
+<!-- attributes for elements that can get the focus
+ accesskey accessibility key character
+ tabindex position in tabbing order
+ onfocus the element got the focus
+ onblur the element lost the focus
+-->
+<!ENTITY % focus
+ "accesskey %Character; #IMPLIED
+ tabindex %Number; #IMPLIED
+ onfocus %Script; #IMPLIED
+ onblur %Script; #IMPLIED"
+ >
+
+<!ENTITY % attrs "%coreattrs; %i18n; %events;">
+
+<!--=================== Text Elements ====================================-->
+
+<!ENTITY % special.pre
+ "br | span | bdo | map">
+
+
+<!ENTITY % special
+ "%special.pre; | object | img ">
+
+<!ENTITY % fontstyle "tt | i | b | big | small ">
+
+<!ENTITY % phrase "em | strong | dfn | code | q |
+ samp | kbd | var | cite | abbr | acronym | sub | sup ">
+
+<!ENTITY % inline.forms "input | select | textarea | label | button">
+
+<!-- these can occur at block or inline level -->
+<!ENTITY % misc.inline "ins | del | script">
+
+<!-- these can only occur at block level -->
+<!ENTITY % misc "noscript | %misc.inline;">
+
+<!ENTITY % inline "a | %special; | %fontstyle; | %phrase; | %inline.forms;">
+
+<!-- %Inline; covers inline or "text-level" elements -->
+<!ENTITY % Inline "(#PCDATA | %inline; | %misc.inline;)*">
+
+<!--================== Block level elements ==============================-->
+
+<!ENTITY % heading "h1|h2|h3|h4|h5|h6">
+<!ENTITY % lists "ul | ol | dl">
+<!ENTITY % blocktext "pre | hr | blockquote | address">
+
+<!ENTITY % block
+ "p | %heading; | div | %lists; | %blocktext; | fieldset | table">
+
+<!ENTITY % Block "(%block; | form | %misc;)*">
+
+<!-- %Flow; mixes block and inline and is used for list items etc. -->
+<!ENTITY % Flow "(#PCDATA | %block; | form | %inline; | %misc;)*">
+
+<!--================== Content models for exclusions =====================-->
+
+<!-- a elements use %Inline; excluding a -->
+
+<!ENTITY % a.content
+ "(#PCDATA | %special; | %fontstyle; | %phrase; | %inline.forms; | %misc.inline;)*">
+
+<!-- pre uses %Inline excluding big, small, sup or sup -->
+
+<!ENTITY % pre.content
+ "(#PCDATA | a | %fontstyle; | %phrase; | %special.pre; | %misc.inline;
+ | %inline.forms;)*">
+
+<!-- form uses %Block; excluding form -->
+
+<!ENTITY % form.content "(%block; | %misc;)*">
+
+<!-- button uses %Flow; but excludes a, form and form controls -->
+
+<!ENTITY % button.content
+ "(#PCDATA | p | %heading; | div | %lists; | %blocktext; |
+ table | %special; | %fontstyle; | %phrase; | %misc;)*">
+
+<!--================ Document Structure ==================================-->
+
+<!-- the namespace URI designates the document profile -->
+
+<!ELEMENT html (head, body)>
+<!ATTLIST html
+ %i18n;
+ id ID #IMPLIED
+ xmlns %URI; #FIXED 'http://www.w3.org/1999/xhtml'
+ >
+
+<!--================ Document Head =======================================-->
+
+<!ENTITY % head.misc "(script|style|meta|link|object)*">
+
+<!-- content model is %head.misc; combined with a single
+ title and an optional base element in any order -->
+
+<!ELEMENT head (%head.misc;,
+ ((title, %head.misc;, (base, %head.misc;)?) |
+ (base, %head.misc;, (title, %head.misc;))))>
+
+<!ATTLIST head
+ %i18n;
+ id ID #IMPLIED
+ profile %URI; #IMPLIED
+ >
+
+<!-- The title element is not considered part of the flow of text.
+ It should be displayed, for example as the page header or
+ window title. Exactly one title is required per document.
+ -->
+<!ELEMENT title (#PCDATA)>
+<!ATTLIST title
+ %i18n;
+ id ID #IMPLIED
+ >
+
+<!-- document base URI -->
+
+<!ELEMENT base EMPTY>
+<!ATTLIST base
+ href %URI; #REQUIRED
+ id ID #IMPLIED
+ >
+
+<!-- generic metainformation -->
+<!ELEMENT meta EMPTY>
+<!ATTLIST meta
+ %i18n;
+ id ID #IMPLIED
+ http-equiv CDATA #IMPLIED
+ name CDATA #IMPLIED
+ content CDATA #REQUIRED
+ scheme CDATA #IMPLIED
+ >
+
+<!--
+ Relationship values can be used in principle:
+
+ a) for document specific toolbars/menus when used
+ with the link element in document head e.g.
+ start, contents, previous, next, index, end, help
+ b) to link to a separate style sheet (rel="stylesheet")
+ c) to make a link to a script (rel="script")
+ d) by stylesheets to control how collections of
+ html nodes are rendered into printed documents
+ e) to make a link to a printable version of this document
+ e.g. a PostScript or PDF version (rel="alternate" media="print")
+-->
+
+<!ELEMENT link EMPTY>
+<!ATTLIST link
+ %attrs;
+ charset %Charset; #IMPLIED
+ href %URI; #IMPLIED
+ hreflang %LanguageCode; #IMPLIED
+ type %ContentType; #IMPLIED
+ rel %LinkTypes; #IMPLIED
+ rev %LinkTypes; #IMPLIED
+ media %MediaDesc; #IMPLIED
+ >
+
+<!-- style info, which may include CDATA sections -->
+<!ELEMENT style (#PCDATA)>
+<!ATTLIST style
+ %i18n;
+ id ID #IMPLIED
+ type %ContentType; #REQUIRED
+ media %MediaDesc; #IMPLIED
+ title %Text; #IMPLIED
+ xml:space (preserve) #FIXED 'preserve'
+ >
+
+<!-- script statements, which may include CDATA sections -->
+<!ELEMENT script (#PCDATA)>
+<!ATTLIST script
+ id ID #IMPLIED
+ charset %Charset; #IMPLIED
+ type %ContentType; #REQUIRED
+ src %URI; #IMPLIED
+ defer (defer) #IMPLIED
+ xml:space (preserve) #FIXED 'preserve'
+ >
+
+<!-- alternate content container for non script-based rendering -->
+
+<!ELEMENT noscript %Block;>
+<!ATTLIST noscript
+ %attrs;
+ >
+
+<!--=================== Document Body ====================================-->
+
+<!ELEMENT body %Block;>
+<!ATTLIST body
+ %attrs;
+ onload %Script; #IMPLIED
+ onunload %Script; #IMPLIED
+ >
+
+<!ELEMENT div %Flow;> <!-- generic language/style container -->
+<!ATTLIST div
+ %attrs;
+ >
+
+<!--=================== Paragraphs =======================================-->
+
+<!ELEMENT p %Inline;>
+<!ATTLIST p
+ %attrs;
+ >
+
+<!--=================== Headings =========================================-->
+
+<!--
+ There are six levels of headings from h1 (the most important)
+ to h6 (the least important).
+-->
+
+<!ELEMENT h1 %Inline;>
+<!ATTLIST h1
+ %attrs;
+ >
+
+<!ELEMENT h2 %Inline;>
+<!ATTLIST h2
+ %attrs;
+ >
+
+<!ELEMENT h3 %Inline;>
+<!ATTLIST h3
+ %attrs;
+ >
+
+<!ELEMENT h4 %Inline;>
+<!ATTLIST h4
+ %attrs;
+ >
+
+<!ELEMENT h5 %Inline;>
+<!ATTLIST h5
+ %attrs;
+ >
+
+<!ELEMENT h6 %Inline;>
+<!ATTLIST h6
+ %attrs;
+ >
+
+<!--=================== Lists ============================================-->
+
+<!-- Unordered list -->
+
+<!ELEMENT ul (li)+>
+<!ATTLIST ul
+ %attrs;
+ >
+
+<!-- Ordered (numbered) list -->
+
+<!ELEMENT ol (li)+>
+<!ATTLIST ol
+ %attrs;
+ >
+
+<!-- list item -->
+
+<!ELEMENT li %Flow;>
+<!ATTLIST li
+ %attrs;
+ >
+
+<!-- definition lists - dt for term, dd for its definition -->
+
+<!ELEMENT dl (dt|dd)+>
+<!ATTLIST dl
+ %attrs;
+ >
+
+<!ELEMENT dt %Inline;>
+<!ATTLIST dt
+ %attrs;
+ >
+
+<!ELEMENT dd %Flow;>
+<!ATTLIST dd
+ %attrs;
+ >
+
+<!--=================== Address ==========================================-->
+
+<!-- information on author -->
+
+<!ELEMENT address %Inline;>
+<!ATTLIST address
+ %attrs;
+ >
+
+<!--=================== Horizontal Rule ==================================-->
+
+<!ELEMENT hr EMPTY>
+<!ATTLIST hr
+ %attrs;
+ >
+
+<!--=================== Preformatted Text ================================-->
+
+<!-- content is %Inline; excluding "img|object|big|small|sub|sup" -->
+
+<!ELEMENT pre %pre.content;>
+<!ATTLIST pre
+ %attrs;
+ xml:space (preserve) #FIXED 'preserve'
+ >
+
+<!--=================== Block-like Quotes ================================-->
+
+<!ELEMENT blockquote %Block;>
+<!ATTLIST blockquote
+ %attrs;
+ cite %URI; #IMPLIED
+ >
+
+<!--=================== Inserted/Deleted Text ============================-->
+
+<!--
+ ins/del are allowed in block and inline content, but its
+ inappropriate to include block content within an ins element
+ occurring in inline content.
+-->
+<!ELEMENT ins %Flow;>
+<!ATTLIST ins
+ %attrs;
+ cite %URI; #IMPLIED
+ datetime %Datetime; #IMPLIED
+ >
+
+<!ELEMENT del %Flow;>
+<!ATTLIST del
+ %attrs;
+ cite %URI; #IMPLIED
+ datetime %Datetime; #IMPLIED
+ >
+
+<!--================== The Anchor Element ================================-->
+
+<!-- content is %Inline; except that anchors shouldn't be nested -->
+
+<!ELEMENT a %a.content;>
+<!ATTLIST a
+ %attrs;
+ %focus;
+ charset %Charset; #IMPLIED
+ type %ContentType; #IMPLIED
+ name NMTOKEN #IMPLIED
+ href %URI; #IMPLIED
+ hreflang %LanguageCode; #IMPLIED
+ rel %LinkTypes; #IMPLIED
+ rev %LinkTypes; #IMPLIED
+ shape %Shape; "rect"
+ coords %Coords; #IMPLIED
+ >
+
+<!--===================== Inline Elements ================================-->
+
+<!ELEMENT span %Inline;> <!-- generic language/style container -->
+<!ATTLIST span
+ %attrs;
+ >
+
+<!ELEMENT bdo %Inline;> <!-- I18N BiDi over-ride -->
+<!ATTLIST bdo
+ %coreattrs;
+ %events;
+ lang %LanguageCode; #IMPLIED
+ xml:lang %LanguageCode; #IMPLIED
+ dir (ltr|rtl) #REQUIRED
+ >
+
+<!ELEMENT br EMPTY> <!-- forced line break -->
+<!ATTLIST br
+ %coreattrs;
+ >
+
+<!ELEMENT em %Inline;> <!-- emphasis -->
+<!ATTLIST em %attrs;>
+
+<!ELEMENT strong %Inline;> <!-- strong emphasis -->
+<!ATTLIST strong %attrs;>
+
+<!ELEMENT dfn %Inline;> <!-- definitional -->
+<!ATTLIST dfn %attrs;>
+
+<!ELEMENT code %Inline;> <!-- program code -->
+<!ATTLIST code %attrs;>
+
+<!ELEMENT samp %Inline;> <!-- sample -->
+<!ATTLIST samp %attrs;>
+
+<!ELEMENT kbd %Inline;> <!-- something user would type -->
+<!ATTLIST kbd %attrs;>
+
+<!ELEMENT var %Inline;> <!-- variable -->
+<!ATTLIST var %attrs;>
+
+<!ELEMENT cite %Inline;> <!-- citation -->
+<!ATTLIST cite %attrs;>
+
+<!ELEMENT abbr %Inline;> <!-- abbreviation -->
+<!ATTLIST abbr %attrs;>
+
+<!ELEMENT acronym %Inline;> <!-- acronym -->
+<!ATTLIST acronym %attrs;>
+
+<!ELEMENT q %Inline;> <!-- inlined quote -->
+<!ATTLIST q
+ %attrs;
+ cite %URI; #IMPLIED
+ >
+
+<!ELEMENT sub %Inline;> <!-- subscript -->
+<!ATTLIST sub %attrs;>
+
+<!ELEMENT sup %Inline;> <!-- superscript -->
+<!ATTLIST sup %attrs;>
+
+<!ELEMENT tt %Inline;> <!-- fixed pitch font -->
+<!ATTLIST tt %attrs;>
+
+<!ELEMENT i %Inline;> <!-- italic font -->
+<!ATTLIST i %attrs;>
+
+<!ELEMENT b %Inline;> <!-- bold font -->
+<!ATTLIST b %attrs;>
+
+<!ELEMENT big %Inline;> <!-- bigger font -->
+<!ATTLIST big %attrs;>
+
+<!ELEMENT small %Inline;> <!-- smaller font -->
+<!ATTLIST small %attrs;>
+
+<!--==================== Object ======================================-->
+<!--
+ object is used to embed objects as part of HTML pages.
+ param elements should precede other content. Parameters
+ can also be expressed as attribute/value pairs on the
+ object element itself when brevity is desired.
+-->
+
+<!ELEMENT object (#PCDATA | param | %block; | form | %inline; | %misc;)*>
+<!ATTLIST object
+ %attrs;
+ declare (declare) #IMPLIED
+ classid %URI; #IMPLIED
+ codebase %URI; #IMPLIED
+ data %URI; #IMPLIED
+ type %ContentType; #IMPLIED
+ codetype %ContentType; #IMPLIED
+ archive %UriList; #IMPLIED
+ standby %Text; #IMPLIED
+ height %Length; #IMPLIED
+ width %Length; #IMPLIED
+ usemap %URI; #IMPLIED
+ name NMTOKEN #IMPLIED
+ tabindex %Number; #IMPLIED
+ >
+
+<!--
+ param is used to supply a named property value.
+ In XML it would seem natural to follow RDF and support an
+ abbreviated syntax where the param elements are replaced
+ by attribute value pairs on the object start tag.
+-->
+<!ELEMENT param EMPTY>
+<!ATTLIST param
+ id ID #IMPLIED
+ name CDATA #IMPLIED
+ value CDATA #IMPLIED
+ valuetype (data|ref|object) "data"
+ type %ContentType; #IMPLIED
+ >
+
+<!--=================== Images ===========================================-->
+
+<!--
+ To avoid accessibility problems for people who aren't
+ able to see the image, you should provide a text
+ description using the alt and longdesc attributes.
+ In addition, avoid the use of server-side image maps.
+ Note that in this DTD there is no name attribute. That
+ is only available in the transitional and frameset DTD.
+-->
+
+<!ELEMENT img EMPTY>
+<!ATTLIST img
+ %attrs;
+ src %URI; #REQUIRED
+ alt %Text; #REQUIRED
+ longdesc %URI; #IMPLIED
+ height %Length; #IMPLIED
+ width %Length; #IMPLIED
+ usemap %URI; #IMPLIED
+ ismap (ismap) #IMPLIED
+ >
+
+<!-- usemap points to a map element which may be in this document
+ or an external document, although the latter is not widely supported -->
+
+<!--================== Client-side image maps ============================-->
+
+<!-- These can be placed in the same document or grouped in a
+ separate document although this isn't yet widely supported -->
+
+<!ELEMENT map ((%block; | form | %misc;)+ | area+)>
+<!ATTLIST map
+ %i18n;
+ %events;
+ id ID #REQUIRED
+ class CDATA #IMPLIED
+ style %StyleSheet; #IMPLIED
+ title %Text; #IMPLIED
+ name NMTOKEN #IMPLIED
+ >
+
+<!ELEMENT area EMPTY>
+<!ATTLIST area
+ %attrs;
+ %focus;
+ shape %Shape; "rect"
+ coords %Coords; #IMPLIED
+ href %URI; #IMPLIED
+ nohref (nohref) #IMPLIED
+ alt %Text; #REQUIRED
+ >
+
+<!--================ Forms ===============================================-->
+<!ELEMENT form %form.content;> <!-- forms shouldn't be nested -->
+
+<!ATTLIST form
+ %attrs;
+ action %URI; #REQUIRED
+ method (get|post) "get"
+ enctype %ContentType; "application/x-www-form-urlencoded"
+ onsubmit %Script; #IMPLIED
+ onreset %Script; #IMPLIED
+ accept %ContentTypes; #IMPLIED
+ accept-charset %Charsets; #IMPLIED
+ >
+
+<!--
+ Each label must not contain more than ONE field
+ Label elements shouldn't be nested.
+-->
+<!ELEMENT label %Inline;>
+<!ATTLIST label
+ %attrs;
+ for IDREF #IMPLIED
+ accesskey %Character; #IMPLIED
+ onfocus %Script; #IMPLIED
+ onblur %Script; #IMPLIED
+ >
+
+<!ENTITY % InputType
+ "(text | password | checkbox |
+ radio | submit | reset |
+ file | hidden | image | button)"
+ >
+
+<!-- the name attribute is required for all but submit & reset -->
+
+<!ELEMENT input EMPTY> <!-- form control -->
+<!ATTLIST input
+ %attrs;
+ %focus;
+ type %InputType; "text"
+ name CDATA #IMPLIED
+ value CDATA #IMPLIED
+ checked (checked) #IMPLIED
+ disabled (disabled) #IMPLIED
+ readonly (readonly) #IMPLIED
+ size CDATA #IMPLIED
+ maxlength %Number; #IMPLIED
+ src %URI; #IMPLIED
+ alt CDATA #IMPLIED
+ usemap %URI; #IMPLIED
+ onselect %Script; #IMPLIED
+ onchange %Script; #IMPLIED
+ accept %ContentTypes; #IMPLIED
+ >
+
+<!ELEMENT select (optgroup|option)+> <!-- option selector -->
+<!ATTLIST select
+ %attrs;
+ name CDATA #IMPLIED
+ size %Number; #IMPLIED
+ multiple (multiple) #IMPLIED
+ disabled (disabled) #IMPLIED
+ tabindex %Number; #IMPLIED
+ onfocus %Script; #IMPLIED
+ onblur %Script; #IMPLIED
+ onchange %Script; #IMPLIED
+ >
+
+<!ELEMENT optgroup (option)+> <!-- option group -->
+<!ATTLIST optgroup
+ %attrs;
+ disabled (disabled) #IMPLIED
+ label %Text; #REQUIRED
+ >
+
+<!ELEMENT option (#PCDATA)> <!-- selectable choice -->
+<!ATTLIST option
+ %attrs;
+ selected (selected) #IMPLIED
+ disabled (disabled) #IMPLIED
+ label %Text; #IMPLIED
+ value CDATA #IMPLIED
+ >
+
+<!ELEMENT textarea (#PCDATA)> <!-- multi-line text field -->
+<!ATTLIST textarea
+ %attrs;
+ %focus;
+ name CDATA #IMPLIED
+ rows %Number; #REQUIRED
+ cols %Number; #REQUIRED
+ disabled (disabled) #IMPLIED
+ readonly (readonly) #IMPLIED
+ onselect %Script; #IMPLIED
+ onchange %Script; #IMPLIED
+ >
+
+<!--
+ The fieldset element is used to group form fields.
+ Only one legend element should occur in the content
+ and if present should only be preceded by whitespace.
+-->
+<!ELEMENT fieldset (#PCDATA | legend | %block; | form | %inline; | %misc;)*>
+<!ATTLIST fieldset
+ %attrs;
+ >
+
+<!ELEMENT legend %Inline;> <!-- fieldset label -->
+<!ATTLIST legend
+ %attrs;
+ accesskey %Character; #IMPLIED
+ >
+
+<!--
+ Content is %Flow; excluding a, form and form controls
+-->
+<!ELEMENT button %button.content;> <!-- push button -->
+<!ATTLIST button
+ %attrs;
+ %focus;
+ name CDATA #IMPLIED
+ value CDATA #IMPLIED
+ type (button|submit|reset) "submit"
+ disabled (disabled) #IMPLIED
+ >
+
+<!--======================= Tables =======================================-->
+
+<!-- Derived from IETF HTML table standard, see [RFC1942] -->
+
+<!--
+ The border attribute sets the thickness of the frame around the
+ table. The default units are screen pixels.
+
+ The frame attribute specifies which parts of the frame around
+ the table should be rendered. The values are not the same as
+ CALS to avoid a name clash with the valign attribute.
+-->
+<!ENTITY % TFrame "(void|above|below|hsides|lhs|rhs|vsides|box|border)">
+
+<!--
+ The rules attribute defines which rules to draw between cells:
+
+ If rules is absent then assume:
+ "none" if border is absent or border="0" otherwise "all"
+-->
+
+<!ENTITY % TRules "(none | groups | rows | cols | all)">
+
+<!-- horizontal alignment attributes for cell contents
+
+ char alignment char, e.g. char=':'
+ charoff offset for alignment char
+-->
+<!ENTITY % cellhalign
+ "align (left|center|right|justify|char) #IMPLIED
+ char %Character; #IMPLIED
+ charoff %Length; #IMPLIED"
+ >
+
+<!-- vertical alignment attributes for cell contents -->
+<!ENTITY % cellvalign
+ "valign (top|middle|bottom|baseline) #IMPLIED"
+ >
+
+<!ELEMENT table
+ (caption?, (col*|colgroup*), thead?, tfoot?, (tbody+|tr+))>
+<!ELEMENT caption %Inline;>
+<!ELEMENT thead (tr)+>
+<!ELEMENT tfoot (tr)+>
+<!ELEMENT tbody (tr)+>
+<!ELEMENT colgroup (col)*>
+<!ELEMENT col EMPTY>
+<!ELEMENT tr (th|td)+>
+<!ELEMENT th %Flow;>
+<!ELEMENT td %Flow;>
+
+<!ATTLIST table
+ %attrs;
+ summary %Text; #IMPLIED
+ width %Length; #IMPLIED
+ border %Pixels; #IMPLIED
+ frame %TFrame; #IMPLIED
+ rules %TRules; #IMPLIED
+ cellspacing %Length; #IMPLIED
+ cellpadding %Length; #IMPLIED
+ >
+
+<!ATTLIST caption
+ %attrs;
+ >
+
+<!--
+colgroup groups a set of col elements. It allows you to group
+several semantically related columns together.
+-->
+<!ATTLIST colgroup
+ %attrs;
+ span %Number; "1"
+ width %MultiLength; #IMPLIED
+ %cellhalign;
+ %cellvalign;
+ >
+
+<!--
+ col elements define the alignment properties for cells in
+ one or more columns.
+
+ The width attribute specifies the width of the columns, e.g.
+
+ width=64 width in screen pixels
+ width=0.5* relative width of 0.5
+
+ The span attribute causes the attributes of one
+ col element to apply to more than one column.
+-->
+<!ATTLIST col
+ %attrs;
+ span %Number; "1"
+ width %MultiLength; #IMPLIED
+ %cellhalign;
+ %cellvalign;
+ >
+
+<!--
+ Use thead to duplicate headers when breaking table
+ across page boundaries, or for static headers when
+ tbody sections are rendered in scrolling panel.
+
+ Use tfoot to duplicate footers when breaking table
+ across page boundaries, or for static footers when
+ tbody sections are rendered in scrolling panel.
+
+ Use multiple tbody sections when rules are needed
+ between groups of table rows.
+-->
+<!ATTLIST thead
+ %attrs;
+ %cellhalign;
+ %cellvalign;
+ >
+
+<!ATTLIST tfoot
+ %attrs;
+ %cellhalign;
+ %cellvalign;
+ >
+
+<!ATTLIST tbody
+ %attrs;
+ %cellhalign;
+ %cellvalign;
+ >
+
+<!ATTLIST tr
+ %attrs;
+ %cellhalign;
+ %cellvalign;
+ >
+
+
+<!-- Scope is simpler than headers attribute for common tables -->
+<!ENTITY % Scope "(row|col|rowgroup|colgroup)">
+
+<!-- th is for headers, td for data and for cells acting as both -->
+
+<!ATTLIST th
+ %attrs;
+ abbr %Text; #IMPLIED
+ axis CDATA #IMPLIED
+ headers IDREFS #IMPLIED
+ scope %Scope; #IMPLIED
+ rowspan %Number; "1"
+ colspan %Number; "1"
+ %cellhalign;
+ %cellvalign;
+ >
+
+<!ATTLIST td
+ %attrs;
+ abbr %Text; #IMPLIED
+ axis CDATA #IMPLIED
+ headers IDREFS #IMPLIED
+ scope %Scope; #IMPLIED
+ rowspan %Number; "1"
+ colspan %Number; "1"
+ %cellhalign;
+ %cellvalign;
+ >
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/TOREVIEW/TODO_online-demo.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/TOREVIEW/TODO_online-demo.apt b/mothballed/src/site/apt/TOREVIEW/TODO_online-demo.apt
new file mode 100644
index 0000000..a0b0e52
--- /dev/null
+++ b/mothballed/src/site/apt/TOREVIEW/TODO_online-demo.apt
@@ -0,0 +1,37 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+
+Online Demo
+
+ You can try out [[NAME]] from a users' viewpoint by trying out the expenses app
+ that ships as an example with [[NAME]]. This is the same application that is shown in
+ {{{./expenses-movies.html}movies}}.
+
+[./images/demo-expenses.png] Expenses Application
+
+ The app is deployed to run with the {{{./plugins/html-viewer/index.html}HTML Viewer}}, and you can logon {{{http://demo.isis.apache.org/expenses/}here}}.
+ Log in with a user name of 'sven', or 'bob', or 'dick'; the password in all cases is 'pass'.
+
+ []
+
+ Like all [[NAME]] apps, the UI layer is generated directly from the domain objects; there is no
+ presentation code. The app itself is part of the {{{./downloads.html}downloads}}, or you might want to browse the
+ {{{https://apache.isis.svn/svnroot/trunk/distribution/examples/expenses/dom/src/main/java/org/apache/isis/example/expenses/}source code}} directly.
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/TOREVIEW/naked-objects-pattern-benefits.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/TOREVIEW/naked-objects-pattern-benefits.apt b/mothballed/src/site/apt/TOREVIEW/naked-objects-pattern-benefits.apt
new file mode 100644
index 0000000..173f4d1
--- /dev/null
+++ b/mothballed/src/site/apt/TOREVIEW/naked-objects-pattern-benefits.apt
@@ -0,0 +1,56 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+
+Benefits of the Naked Objects pattern
+
+ Developing a business application using a framework such as Isis that
+ uses the naked objects pattern offers four principal benefits:
+
+ * <<A faster development cycle>>
+
+ ... because there are fewer layers to develop.
+
+ * <<Greater agility>>
+
+ ... referring to the ease with which an application may be altered to
+ accommodate future changes in business requirements.
+
+ In part this arises from the reduction in the number of developed layers that must be kept
+ in synchronisation. Also the enforced 1:1 correspondence between the user presentation and the
+ domain model, forces higher-quality domain object modelling, which in turn improves the agility.
+
+ * <<A more empowering style of user interface>>.
+
+ Object-oriented user interfaces
+ offer the user much greater flexibility than conventional task-oriented user interfaces, but
+ traditionally they have been difficult to write. Apache Isis creates
+ an OOUI for you automatically.
+
+ * <<Easier requirements analysis>>.
+
+ With the naked objects pattern, the domain objects form a
+ common, "ubiquitous" language between users and developers. This common language facilitates the process of
+ discussing requirements - because there are no other representations to discuss. Combined with the faster
+ development cycle, it becomes possible to prototype functional applications in real time.
+
+ []
+
+ These benefits are clearly brought out in the {{{./naked-objects-case-study.html}case study}} on the use of a naked objects system in the
+ Irish government. For a more formal analysis of the benefits, see Richard Pawson's {{{./Pawson-Naked-Objects-thesis.pdf}PhD thesis on Naked
+ Objects}}.
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/TOREVIEW/nof-expenses-movies.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/TOREVIEW/nof-expenses-movies.apt b/mothballed/src/site/apt/TOREVIEW/nof-expenses-movies.apt
new file mode 100644
index 0000000..39f7661
--- /dev/null
+++ b/mothballed/src/site/apt/TOREVIEW/nof-expenses-movies.apt
@@ -0,0 +1,69 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+ -----
+ Tutorial Movies
+ -----
+ The [[NAME]] Team
+ -----
+
+Same application, different GUIs
+
+ Because [[NAME]] automatically generates the GUI for your domain application, it makes it trivial
+ to run your application with different GUIs.
+
+ Why would you want to do this? Well, you might legitimately have different user bases who access the
+ same application through different means. For example, your internal users might use the rich desktop
+ provided by the {{{./plugins/dnd-viewer/index.html}DnD viewer}}, while external users might access the
+ same app (though probably with different permissions) via the web and using the {{{./plugins/html-viewer/index.html}HTML viewer}}.
+
+ Another reason for different GUIs is that you might prefer one for development (the DnD viewer is particularly
+ good at helping to explore a domain), but intend to use a different one for deployment. You might even intend to
+ write your own proprietary viewer, but want to get started on a domain model first.
+
+ The following movies show how the example {{{./demo.html}expenses application}} (that ships with [[NAME]]) is presented by
+ the DnD viewer and by the HTML viewer. In both cases no GUI code was written; the applications you
+ can see are generated entirely from domain objects.
+
+* DnD Viewer
+
+ Using the {{{./plugins/dnd-viewer/index.html}DnD viewer}}:
+
+ * {{{./movies/Retrieving and viewing a Claim (DND UI).htm}Retrieving and viewing a Claim}}
+
+ * {{{./movies/Creating and submitting a new Claim (DND UI).htm}Creating and submitting a new Claim}}
+
+ * {{{./movies/Approving claims (DND UI).htm}Approving claims}}
+
+ []
+
+* HTML Viewer
+
+ Using the {{{./plugins/html-viewer/index.html}HTML viewer}}:
+
+ * {{{./movies/Retrieving and viewing a Claim (HTML UI).htm}Retrieving and viewing a Claim}}
+
+ * {{{./movies/Creating and submitting a new Claim (HTML UI).htm}Creating and submitting a new Claim}}
+
+ * {{{./movies/Approving claims (HTML UI).htm}Approving claims}}
+
+ []
+
+* What Next?
+
+ Next, you might want to try out this same application {{{./demo.html}online}}. Or, start to see how the {{{./tutorial-movies.html}GUI relates}} back to the code. Alternatively, go back to the {{{./index.html}home page}} for other resources.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/architecture.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/architecture.apt b/mothballed/src/site/apt/architecture.apt
new file mode 100644
index 0000000..72ae7db
--- /dev/null
+++ b/mothballed/src/site/apt/architecture.apt
@@ -0,0 +1,75 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+Apache Isis Hexagonal Architecture
+
+ <Apache Isis> is built around the {{{http://alistair.cockburn.us/Hexagonal+architecture}hexagonal architecture}}:
+
+%{snippet|verbatim=false|file=src/site/resources/images/HexagonalArchitectureOverview.png.map}
+
+ []
+
+ In the centre is the same domain model, which is hosted by the framework.
+ <viewer>s, either as a desktop app or as a webapp. Equally, you can
+ choose which <object store> to use in order to persist your domain objects.
+
+
+ As you might imagine, not needing to write any GUI code substantially speeds
+ up development, and shortens the feedback loop to allow you to improve your
+ core domain model without lots of GUI code slowing you down.
+
+ The OOUIs generated by <Apache Isis> are especially suitable to "expert" users, typically those internal to
+ your organization who have a good understanding of the domain and just want to get their job done.
+ But for less expert users (or for a webapp deployed on the internet), a more scripted UI may be called for.
+ Isis therefore lets you customize the user interface according to your users' needs.
+
+ Alternatively, you might want to just use Isis as a design tool. The framework goes to a lot of trouble
+ to ensure that the domain objects you build have no dependencies on the framework: they are basically annotated
+ pojos that follow a number of straightforward programming conventions. So, you can use Isis to rapidly
+ evolve your domain objects, and then deploy them within some other runtime framework if you wish.
+
+Where to Start?
+
+ As you can see from this size of this site, there's quite a lot to
+ <Apache Isis>. To keep things manageable, we've tried to scope information
+ closest to where it's relevant. To help guide you through the
+ framework, we've also prepared a {{{./where-to-start.html}where to start}}.
+ If you want to drill into detail, you can either follow the links in the menu
+ on the left, and/or you can click on the modules on image above.
+
+Promoting Apache Isis
+
+ If you've spent some time playing with Isis and would like to promote it
+ within your organization (at a Brown Bag lunch, say) then we have some
+ presentation material for you to use. The material includes speaker notes
+ and is available as a {{{./presentations/IntroducingApacheIsis.pptx}PPTX}}
+ and {{{./presentations/IntroducingApacheIsis.ppt}PPT}} (Microsoft), an
+ {{{./presentations/IntroducingApacheIsis.odp}ODP}} (OpenDocument) and also
+ as a PDF ({{{./presentations/IntroducingApacheIsis-slides.pdf}slides}} and
+ {{{./presentations/IntroducingApacheIsis-notes.pdf}notes}}). Feel free to
+ edit them to your needs.
+
+Disclaimer
+
+ <Apache Isis is an effort undergoing incubation at The Apache Software Foundation (ASF),
+ sponsored by the Incubator project. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure, communications, and decision
+ making process have stabilized in a manner consistent with other successful ASF projects.
+ While incubation status is not necessarily a reflection of the completeness or stability
+ of the code, it does indicate that the project has yet to be fully endorsed by the ASF.>
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/automatically-generated-uis.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/automatically-generated-uis.apt b/mothballed/src/site/apt/automatically-generated-uis.apt
new file mode 100644
index 0000000..a2ad009
--- /dev/null
+++ b/mothballed/src/site/apt/automatically-generated-uis.apt
@@ -0,0 +1,37 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+Dynamically Generated Presentation Layer
+
+ If you deploy your domain model on Isis, then you have it
+ dynamically generate either a RESTful back-end for your domain object model,
+ or to dynamically generate a webapp.
+
+ This webapp is a great developers' tool, allowing you to explore your
+ RESTful API without having to use other tools.
+
+ You might also want to deploy this webapp directly for use by end-users.
+ The UIs generated by <Apache Isis> are especially suitable to "expert" users,
+ typically those internal to your organization who have a good understanding
+ of the domain and just want to get their job done.
+
+ For less expert users (or for a webapp deployed on the internet), we recommend
+ that you develop a custom UI. You could either have it call back to the RESTful API,
+ or you could simply take your object model and use it as the domain layer witihn
+ your preferred runtime framework.
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/contributors-deploying.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/contributors-deploying.apt b/mothballed/src/site/apt/contributors-deploying.apt
new file mode 100644
index 0000000..c6f650c
--- /dev/null
+++ b/mothballed/src/site/apt/contributors-deploying.apt
@@ -0,0 +1,76 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+
+Deploying Apache Isis
+
+ These notes are for Isis contributors with responsibility for
+ deploying Isis (either the code artifact via <<<mvn deploy>>> or the site via <<<mvn site-deploy>>>).
+
+ NOTE: plan is to move this content into the DocBook "contributors' guide"
+
+Prereqs
+
+ The instructions given here assume you are running on a UNIX type machine.
+ If you instead use Windows, then we recommend that you install
+ {{{http://cygwin.com}Cygwin}}, to access a UNIX shell and the required
+ UNIX commands.
+
+ When installing Cygwin, we also recommend that you select a couple of
+ additional utilities over and above the defaults:
+
+ * shells group > chere utility
+
+ This can be used to set up a "Bash prompt here" menu item from the
+ Windows Explorer context menu
+
+ * net group > openssh utility
+
+ This provides the ssh client program, used for remoting into hosts securely
+ (needed when uploading generated documentation)
+
+ * net group > rsync utility
+
+ This is used to actually upload generated documentation
+
+ []
+
+ When cygwin has installed, start a Cygwin Bash Shell as administrator
+ (press ctrl+shift), and then run:
+
++-------------------------------------------------------+
+chere -i
++-------------------------------------------------------+
+
+ Switch back to Windows Explorer and you'll find that you should be able to
+ start a bash shell in a new terminal window from any folder.
+
+Process
+
+ For now, we'll just refer to the wiki documentation:
+
+ * {{{https://cwiki.apache.org/confluence/display/ISIS/ManualDeployProcessForSnapshots}Manual deploy process for snapshots}}
+
+ * {{{https://cwiki.apache.org/confluence/display/ISIS/ManualDeployProcessForSite}Manual deploy process for sites}}
+
+ []
+
+ The {{{https://cwiki.apache.org/confluence/display/ISIS/Index}Isis wiki}}
+ also documents a number of other processes. These will be formalized
+ into documentation when they are proven and stable.
+
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/documentation.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/documentation.apt b/mothballed/src/site/apt/documentation.apt
new file mode 100644
index 0000000..64e0a88
--- /dev/null
+++ b/mothballed/src/site/apt/documentation.apt
@@ -0,0 +1,78 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+
+Documentation
+
+ If you're just starting out with Isis, we recommend you look first at:
+
+ * the applib documentation ({{{./applib/docbkx/pdf/isis-applib.pdf}PDF}}, {{{./applib/docbkx/html/guide/isis-applib.html}HTML}})
+
+ * the core documentation ({{{./core/docbkx/pdf/isis-core.pdf}PDF}}, {{{./core/docbkx/html/guide/isis-core.html}HTML}})
+
+ []
+
+ If you're looking to contribute to Isis, we also recommend you look at the
+ contributors documentation ({{{./docbkx/pdf/isis-contributors-guide.pdf}PDF}},
+ {{{./docbkx/html/guide/isis-contributors-guide.html}HTML}})
+
+ Thereafter, we've broken Isis documentation out by component. That means
+ that any given documentation is likely to have just the information you require
+ to use or configure that component. It also makes it easier for us to maintain those
+ documents. The table below lists all the documentation guides available,
+ along with their current status.
+
+*--------------------------------*------------------------------------*--------------------------------------------------*---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|<<Module>> |<<Module Description>> |<<Documentation Title/Subject>> |<<PDF>> |<<HTML>> |<<Status>>|<<Owner>>|
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|applib |Application Library |Developing domain driven applications |{{{./applib/docbkx/pdf/isis-applib.pdf}PDF}} |{{{./applib/docbkx/html/guide/isis-applib.html}HTML}} |Done |Dan,Kevin|
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|core |Core Framework |Architecture, APIs and Customization |{{{./core/docbkx/pdf/isis-core.pdf}PDF}} |{{{./core/docbkx/html/guide/isis-core.html}HTML}} |95% |Dan, Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|progmodels |Programming Models |Configuration and Customization Guide |{{{./progmodels/docbkx/pdf/isis-progmodels.pdf}PDF}} |{{{./progmodels/docbkx/html/guide/isis-progmodels.html}HTML}} |40% |Dan |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|security |Security |Configuration and Deployment Guide |{{{./security/docbkx/pdf/isis-security.pdf}PDF}} |{{{./security/docbkx/html/guide/isis-security.html}HTML}} |60% |Dan,Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|viewers:html |HTML Viewer |Configuration, Customization and Deployment Guide |{{{./viewer/html/docbkx/pdf/isis-html-viewer.pdf}PDF}} |{{{./viewer/html/docbkx/html/guide/isis-html-viewer.html}HTML}} |0% |Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|viewers:restfulobjects |RestfulObjects for Isis |Configuration, Customization and Deployment Guide |{{{./viewer/restfulobjects/docbkx/pdf/isis-restfulobjects-viewer.pdf}PDF}} |{{{./viewer/restfulobjects/docbkx/html/guide/isis-restfulobjects-viewer.html}HTML}} |50% |Dan |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|viewers:junit |JUnit Support |Acceptance Testing using JUnit |{{{./viewer/junit/docbkx/pdf/isis-junit-support.pdf}PDF}} |{{{./viewer/junit/docbkx/html/guide/isis-junit-support.html}HTML}} |20% |Dan |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|viewers:bdd |BDD Integration |Acceptance Testing using BDD Frameworks |{{{./viewer/bdd/docbkx/pdf/isis-bdd-integration.pdf}PDF}} |{{{./viewer/bdd/docbkx/html/guide/isis-bdd-integration.html}HTML}} |Done |Dan |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|viewers:dnd |Drag-n-drop Viewer |Configuration, Customization and Deployment Guide |{{{./viewer/dnd/docbkx/pdf/isis-dnd-viewer.pdf}PDF}} |{{{./viewer/dnd/docbkx/html/guide/isis-dnd-viewer.html}HTML}} |40% |Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|viewers:scimpi |Scimpi Viewer |Configuration, Customization and Deployment Guide |{{{./viewer/scimpi/docbkx/pdf/isis-scimpi-viewer.pdf}PDF}} |{{{./viewer/scimpi/docbkx/html/guide/isis-scimpi-viewer.html}HTML}} |80% |Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|viewers:wicket |Wicket Viewer |Configuration, Customization and Deployment Guide |{{{./viewer/wicket/docbkx/pdf/isis-wicket-viewer.pdf}PDF}} |{{{./viewer/wicket/docbkx/html/guide/isis-wicket-viewer.html}HTML}} |95% |Dan |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|runtimes:dflt |Default Runtime |Programming, Configuration and Deployment Guide |{{{./runtimes/dflt/docbkx/pdf/isis-default-runtime.pdf}PDF}} |{{{./runtimes/dflt/docbkx/html/guide/isis-default-runtime.html}HTML}} |20% |Dan,Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|runtimes.dflt.objectstores:xml |Default Runtime XML Object Store |Configuration and Deployment Guide |{{{./runtimes/dflt/objectstores/xml/docbkx/pdf/isis-xml-objectstore.pdf}PDF}} |{{{./runtimes/dflt/objectstores/xml/docbkx/html/guide/isis-xml-objectstore.html}HTML}} |0% |Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|runtimes.dflt.objectstores:sql |Default Runtime SQL Object Store |Configuration and Deployment Guide |{{{./runtimes/dflt/objectstores/sql/docbkx/pdf/isis-sql-objectstore.pdf}PDF}} |{{{./runtimes/dflt/objectstores/sql/docbkx/html/guide/isis-sql-objectstore.html}HTML}} |Done |Kevin |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|runtimes.dflt.objectstores:nosql|Default Runtime NoSQL Object Store |Configuration and Deployment Guide |{{{./runtimes/dflt/objectstores/nosql/docbkx/pdf/isis-nosql-objectstore.pdf}PDF}}|{{{./runtimes/dflt/objectstores/nosql/docbkx/html/guide/isis-nosql-objectstore.html}HTML}}|0% |Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|runtimes.dflt.profilestores:xml |Default Runtime XML Profile Store |Configuration and Deployment Guide |{{{./runtimes/dflt/profilestores/xml/docbkx/pdf/isis-xml-profilestore.pdf}PDF}} |{{{./runtimes/dflt/profilestores/xml/docbkx/html/guide/isis-xml-profilestore.html}HTML}} |0% |Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|runtimes.dflt:remoting |Remoting (Client/Server) Deployment |Configuration and Deployment Guide |{{{./runtimes/dflt/remoting/docbkx/pdf/isis-remoting.pdf}PDF}} |{{{./runtimes/dflt/remoting/docbkx/html/guide/isis-remoting.html}HTML}} |20% |Rob |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
+|runtimes:embedded |Embedded MetaModel Deployment |Programming, Configuration and Deployment Guide |{{{./runtimes/embedded/docbkx/pdf/isis-embedded-runtime.pdf}PDF}} |{{{./runtimes/embedded/docbkx/html/guide/isis-embedded-runtime.html}HTML}} |80% |Dan |
+*--------------------------------+------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------*------------------------------------------------------------------------------------------*----------*---------+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/downloads.apt.vm
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/downloads.apt.vm b/mothballed/src/site/apt/downloads.apt.vm
new file mode 100644
index 0000000..a815f83
--- /dev/null
+++ b/mothballed/src/site/apt/downloads.apt.vm
@@ -0,0 +1,69 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+ -----
+ Downloads
+ -----
+
+ <Apache Isis> is a full-stack open source application development framework, designed to let you rapidly develop domain-driven business enterprise applications.
+
+Release
+
+ <Apache Isis> is distributed in both source and binary form:
+
+ * the source can be downloaded from
+ {{{http://www.apache.org/dyn/closer.cgi/incubator/isis/${project.version}/isis-${project.version}-source-release.zip}here}}
+ ({{{http://www.apache.org/dist/incubator/isis/${project.version}/isis-${project.version}-source-release.zip.asc}asc}}, {{{http://www.apache.org/dist/incubator/isis/${project.version}/isis-${project.version}-source-release.zip.md5}md5}}, {{{http://www.apache.org/dist/incubator/isis/${project.version}/isis-${project.version}-source-release.zip.sha1}sha1}})
+
+ Details of building <Isis> from source can be found in the contributors guide ({{{./docbkx/html/guide/isis-contributors-guide.html}HTML}} or {{{./docbkx/pdf/isis-contributors-guide.pdf}PDF}})
+ for further details.
+
+ * the binaries can be downloaded from {{{http://search.maven.org}Maven central repo}}, typically by using the <Isis> quickstart archetype.
+
+ See the {{{./quick-start.html}quickstart page}} for details on how to using the quickstart archetype.
+
+ []
+
+ In both cases, you can use the {{{http://www.apache.org/dist/incubator/isis/KEYS}KEYS}} to verify the archives.
+
+Release Notes
+
+ A list of JIRA issues addressed in this release can be found {{{./release-notes-${project.version}.html}here}}.
+
+ Previous releases: {{{./release-notes-0.1.2-incubating.html}0.1.2-incubating}}.
+
+
+Building Isis yourself
+
+ We also invite you to check out the source from Subversion and build it
+ yourself:
+
+----
+svn co https://svn.apache.org/repos/asf/incubator/isis/trunk/framework .
+mvn clean install
+----
+
+ Again, see the contributors guide ({{{./docbkx/html/guide/isis-contributors-guide.html}HTML}} or {{{./docbkx/pdf/isis-contributors-guide.pdf}PDF}})
+ for more details.
+
+
+Icons
+
+ In addition to the source and binary releases, there are also a number of {{{./icons.html}icon sets}} you can use in your own applications.
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/icons.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/icons.apt b/mothballed/src/site/apt/icons.apt
new file mode 100644
index 0000000..960d982
--- /dev/null
+++ b/mothballed/src/site/apt/icons.apt
@@ -0,0 +1,67 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+Icons
+
+ All <Apache Isis> viewers allow icons to be associated with domain
+ objects, typically a different icon for each entity type.
+
+ We provide three different icon sets that you are free to use in your
+ own applications.
+
+ * icons donated by Dan Haywood (download
+ {{{./images/icons/haywood.zip}zip}})
+
+ * icons developed by the
+ {{{http://tango.freedesktop.org/}Tango Desktop Project}}, released
+ to the public domain (download {{{./images/icons/tango.zip}zip}})
+
+ * icons donated by the Naked Objects Group Ltd (download
+ {{{./images/icons/nogl.zip}zip}})
+
+ []
+
+ You can either download the ZIPs, or simply download individual icons
+ directly from this page.
+
+Other icons
+
+ Other places you might look for icons include:
+
+ * {{{http://www.iconarchive.com}Icon Archive}}
+
+ []
+
+Haywood Icons
+
+%{snippet|id=icon-table|verbatim=false|file=src/site/resources/icons/haywood.html}
+
+ []
+
+Tango Icons
+
+%{snippet|id=icon-table|verbatim=false|file=src/site/resources/icons/tango.html}
+
+ []
+
+NOGL Icons
+
+%{snippet|id=icon-table|verbatim=false|file=src/site/resources/icons/nogl.html}
+
+ []
+
+
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/ide-support.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/ide-support.apt b/mothballed/src/site/apt/ide-support.apt
new file mode 100644
index 0000000..15e2feb
--- /dev/null
+++ b/mothballed/src/site/apt/ide-support.apt
@@ -0,0 +1,81 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+
+ We've developed a few simple utilities to help speed up your coding efforts.
+
+Eclipse
+
+* Java Editor Templates
+
+ Download the following links to a temporary directory:
+
+ * {{{./ide/eclipse/templates/isis-templates.xml}isis-templates.xml}}
+
+ * {{{./ide/eclipse/templates/junit4-templates.xml}junit4-templates.xml}}
+
+ * {{{./ide/eclipse/templates/jmock2-templates.xml}jmock2-templates.xml}}
+
+ []
+
+ Now, import using <<Windows > Preferences > Java > Editor > Templates>> and then choose <<Import>>
+
+ The Isis templates are prefixed <<<is>>>, the JUnit templates are prefixed <<<ju4>>>, and the JMock templates prefixed <<<jm2>>>.
+
+
+* Code Folding
+
+ The Isis code templates that we ship are designed to be used with the Coffee Bytes code folder, with <<<\{\{>>> and
+ <<<\}\}>>> being used to define custom regions.
+
+ Unfortunately, though the original code-folding plugin stopped working somewhere around Eclipse 3.3.
+ All is not lost though; Kevin Meyer has helpfully recompiled it against Eclipse 3.5 (tested through to Eclipse 3.7).
+ To use it:
+
+ * download this {{{./com.cb.eclipse.folding.KAM-3.5.zip}zip}}
+
+ * unzip into Eclipse's plugins folder
+
+ * restart Eclipse
+
+ []
+
+ Then, use <<Windows > Preferences > Java > Editor > Folding>> and specify user-defined regions.
+
+* Other Plugins
+
+ The {{{./docbkx/html/guide/ch01.html}Contributors Guide}} also has suggestions for a number of other plugins
+ that you might wish to use.
+
+IntelliJ IDEA
+
+ If your preferred IDE is IntelliJ Idea, then you can use the {{{http://code.google.com/p/eclipse2idea/}eclipse2idea}} project to
+ convert the above Eclipse templates into IDEA's own templates. Thanks to Alexander Krasnukhin for putting this together.
+
+
+Other Tooling
+
+ In the future we hope to revive some Eclipse plugins that was worked on a few
+ years ago, making it easy to apply annotations for example, or refactor
+ methods <and> their supporting methods.
+
+ Another tool on the roadmap is a Maven plugin to allow metamodel validators
+ to be run. For example, this might allow orphaned supporting methods to be
+ identified.
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/index.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/index.apt b/mothballed/src/site/apt/index.apt
new file mode 100644
index 0000000..a24922f
--- /dev/null
+++ b/mothballed/src/site/apt/index.apt
@@ -0,0 +1,57 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+ <Apache Isis> is a framework to let you rapidly develop domain-driven
+ apps in Java. It defines a clean programming model, has BDD and JUnit
+ testing support, and can dynamically (at runtime) generate a representation
+ of that domain model using various presentation technologies.
+
+ You can use Apache Isis in a variety of ways, from initial prototyping
+ all the way through to final deployment:
+
+%{snippet|verbatim=false|file=src/site/resources/images/homepage/IsisUseCases.png.map}
+
+ []
+
+Isis in action
+
+ We've deployed a {{{http://mmyco.co.uk:8180/isis-onlinedemo}simple demo app}}, so you can see
+ Isis in action. The app is deployed with both the RESTful web service and the
+ auto-generated webapp, running against an in-memory object store. To use, you'll need to
+ register an account (the credentials are stored only in memory and are reset nightly).
+
+ The webapp has full documentation to guide you further. It also links to the
+ {{{http://mmyco.co.uk:8180/isis-onlinedemo/doc/xref/index.html}application's source}}
+ so you can see how little code you need to write to get an application up and running with Isis.
+
+Getting Started
+
+ Isis is built with Maven and has a {{{./quick-start.html}quickstart archetype}}
+ to get you going quickly. This will generate a simple one-class domain model, configured
+ to run like the online demo (but with no security).
+
+ After that, please consult the various resources linked from the site menu on the left-hand side.
+
+Disclaimer
+
+ <Apache Isis> is an effort undergoing incubation at The Apache Software Foundation (ASF),
+ sponsored by the Incubator project. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure, communications, and decision
+ making process have stabilized in a manner consistent with other successful ASF projects.
+ While incubation status is not necessarily a reflection of the completeness or stability
+ of the code, it does indicate that the project has yet to be fully endorsed by the ASF.>
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/more-thanks.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/more-thanks.apt b/mothballed/src/site/apt/more-thanks.apt
new file mode 100644
index 0000000..8184d51
--- /dev/null
+++ b/mothballed/src/site/apt/more-thanks.apt
@@ -0,0 +1,33 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+More Thanks
+
+ As well as thanking the {{{http://apache.org/foundation/thanks.html}sponsors of Apache Software Foundation}},
+ we'd also like to thank:
+
+ * {{{http://headwaysoftware.com}Headway Software}}
+
+ for generously providing licenses of their product, Structure101, to allow us to document Isis.
+
+ * {{{http://scootersoftware.com.com}Scooter Software}}
+
+ for providing copies of their file comparison software, BeyondCompare
+
+ []
+
http://git-wip-us.apache.org/repos/asf/isis/blob/11645b5f/mothballed/src/site/apt/newbie.apt
----------------------------------------------------------------------
diff --git a/mothballed/src/site/apt/newbie.apt b/mothballed/src/site/apt/newbie.apt
new file mode 100644
index 0000000..86e9ad5
--- /dev/null
+++ b/mothballed/src/site/apt/newbie.apt
@@ -0,0 +1,97 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+
+For 'Newbie' Contributors
+
+ All the projects in Apache - Isis included - only succeed because of the involvement
+ of their community:
+
+ * For most, that means just using the software, and perhaps reporting the occasional
+ feature request or defect via JIRA.
+
+ * For some, it may also mean blogging or tweeting about using the software, explaining
+ to others (or maybe themselves) about how it solves their particular problems, and
+ in general helping to advertise its existence.
+
+ * And finally there are the contributors to the project: those who have a deep belief
+ in the value of the software, and want to bring their expertise to bear to in its
+ continued development.
+
+ []
+
+ So, suppose you find yourself in this latter group: you'd like to contribute back to
+ Isis, but you're not sure how. On the one hand, there's knowing what the process is;
+ on the other, there's just the difficulty of getting to grips with a large codebase.
+
+Process
+
+ From a process viewpoint, the way it works is:
+
+ * make sure you are subscribed to the isis-users mailing list and to the isis-dev mailing list
+
+ ... and start contributing to the conversation threads
+
+ * register yourself on Apache's {{{https://issues.apache.org/jira}JIRA}} ticket tracking system
+
+ * start contributing patches to existing JIRA issues
+
+ * or, if you have some existing code that you think would be of value to the project,
+ raise a new ticket and attach that code (eg as a zip)
+
+ []
+
+ After a little while, you may be invited to become a committer. Someone in the existing
+ community will ask you if you are interested; if you are, then a vote will be held by the
+ existing committers and project mentors. Assuming that it passes, you'll be granted
+ permission to start committing directly to the source code repository.
+
+JIRA tickets for 'Newbies'
+
+ As noted above, Isis' codebase is quite large, so navigating it and finding existing issues
+ that could you could tackle can be quite a challenge. To help, we've try to identify
+ simple issues with a #newbie label. These issues fall into one of two categories:
+
+ * either they are really relatively trivial to complete
+
+ * or, they represent stand-alone or new features that could be developed without necessarily
+ having to grok all the existing code.
+
+ []
+
+ You can find the current newbie issues by {{{https://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12318871}following this link}}.
+
+ And, before you start, don't forget to consult the {{{./docbkx/html/guide/isis-contributors-guide.html}contributors guide}}
+ to describe how to build Isis from source, and how to configure your development environment.
+
+Not only code
+
+ There are more ways to contribute than to cut code! We'd also appreciate help with:
+
+ * improving documentation (from fixing typos thru to writing how-to guides)
+
+ * screencasts
+
+ * developing example apps
+
+ * writing blog posts
+
+ * writing articles
+
+ * taking part in mailing list discussions
+
+ []