http://git-wip-us.apache.org/repos/asf/incubator-tamaya-site/blob/f5010f82/js/prettify.js ---------------------------------------------------------------------- diff --git a/js/prettify.js b/js/prettify.js new file mode 100644 index 0000000..7b99049 --- /dev/null +++ b/js/prettify.js @@ -0,0 +1,30 @@ +!function(){var q=null;window.PR_SHOULD_USE_CONTINUATION=!0; +(function(){function S(a){function d(e){var b=e.charCodeAt(0);if(b!==92)return b;var a=e.charAt(1);return(b=r[a])?b:"0"<=a&&a<="7"?parseInt(e.substring(1),8):a==="u"||a==="x"?parseInt(e.substring(2),16):e.charCodeAt(1)}function g(e){if(e<32)return(e<16?"\\x0":"\\x")+e.toString(16);e=String.fromCharCode(e);return e==="\\"||e==="-"||e==="]"||e==="^"?"\\"+e:e}function b(e){var b=e.substring(1,e.length-1).match(/\\u[\dA-Fa-f]{4}|\\x[\dA-Fa-f]{2}|\\[0-3][0-7]{0,2}|\\[0-7]{1,2}|\\[\S\s]|[^\\]/g),e=[],a= +b[0]==="^",c=["["];a&&c.push("^");for(var a=a?1:0,f=b.length;a<f;++a){var h=b[a];if(/\\[bdsw]/i.test(h))c.push(h);else{var h=d(h),l;a+2<f&&"-"===b[a+1]?(l=d(b[a+2]),a+=2):l=h;e.push([h,l]);l<65||h>122||(l<65||h>90||e.push([Math.max(65,h)|32,Math.min(l,90)|32]),l<97||h>122||e.push([Math.max(97,h)&-33,Math.min(l,122)&-33]))}}e.sort(function(e,a){return e[0]-a[0]||a[1]-e[1]});b=[];f=[];for(a=0;a<e.length;++a)h=e[a],h[0]<=f[1]+1?f[1]=Math.max(f[1],h[1]):b.push(f=h);for(a=0;a<b.length;++a)h=b[a],c.push(g(h[0])), +h[1]>h[0]&&(h[1]+1>h[0]&&c.push("-"),c.push(g(h[1])));c.push("]");return c.join("")}function s(e){for(var a=e.source.match(/\[(?:[^\\\]]|\\[\S\s])*]|\\u[\dA-Fa-f]{4}|\\x[\dA-Fa-f]{2}|\\\d+|\\[^\dux]|\(\?[!:=]|[()^]|[^()[\\^]+/g),c=a.length,d=[],f=0,h=0;f<c;++f){var l=a[f];l==="("?++h:"\\"===l.charAt(0)&&(l=+l.substring(1))&&(l<=h?d[l]=-1:a[f]=g(l))}for(f=1;f<d.length;++f)-1===d[f]&&(d[f]=++x);for(h=f=0;f<c;++f)l=a[f],l==="("?(++h,d[h]||(a[f]="(?:")):"\\"===l.charAt(0)&&(l=+l.substring(1))&&l<=h&& +(a[f]="\\"+d[l]);for(f=0;f<c;++f)"^"===a[f]&&"^"!==a[f+1]&&(a[f]="");if(e.ignoreCase&&m)for(f=0;f<c;++f)l=a[f],e=l.charAt(0),l.length>=2&&e==="["?a[f]=b(l):e!=="\\"&&(a[f]=l.replace(/[A-Za-z]/g,function(a){a=a.charCodeAt(0);return"["+String.fromCharCode(a&-33,a|32)+"]"}));return a.join("")}for(var x=0,m=!1,j=!1,k=0,c=a.length;k<c;++k){var i=a[k];if(i.ignoreCase)j=!0;else if(/[a-z]/i.test(i.source.replace(/\\u[\da-f]{4}|\\x[\da-f]{2}|\\[^UXux]/gi,""))){m=!0;j=!1;break}}for(var r={b:8,t:9,n:10,v:11, +f:12,r:13},n=[],k=0,c=a.length;k<c;++k){i=a[k];if(i.global||i.multiline)throw Error(""+i);n.push("(?:"+s(i)+")")}return RegExp(n.join("|"),j?"gi":"g")}function T(a,d){function g(a){var c=a.nodeType;if(c==1){if(!b.test(a.className)){for(c=a.firstChild;c;c=c.nextSibling)g(c);c=a.nodeName.toLowerCase();if("br"===c||"li"===c)s[j]="\n",m[j<<1]=x++,m[j++<<1|1]=a}}else if(c==3||c==4)c=a.nodeValue,c.length&&(c=d?c.replace(/\r\n?/g,"\n"):c.replace(/[\t\n\r ]+/g," "),s[j]=c,m[j<<1]=x,x+=c.length,m[j++<<1|1]= +a)}var b=/(?:^|\s)nocode(?:\s|$)/,s=[],x=0,m=[],j=0;g(a);return{a:s.join("").replace(/\n$/,""),d:m}}function H(a,d,g,b){d&&(a={a:d,e:a},g(a),b.push.apply(b,a.g))}function U(a){for(var d=void 0,g=a.firstChild;g;g=g.nextSibling)var b=g.nodeType,d=b===1?d?a:g:b===3?V.test(g.nodeValue)?a:d:d;return d===a?void 0:d}function C(a,d){function g(a){for(var j=a.e,k=[j,"pln"],c=0,i=a.a.match(s)||[],r={},n=0,e=i.length;n<e;++n){var z=i[n],w=r[z],t=void 0,f;if(typeof w==="string")f=!1;else{var h=b[z.charAt(0)]; +if(h)t=z.match(h[1]),w=h[0];else{for(f=0;f<x;++f)if(h=d[f],t=z.match(h[1])){w=h[0];break}t||(w="pln")}if((f=w.length>=5&&"lang-"===w.substring(0,5))&&!(t&&typeof t[1]==="string"))f=!1,w="src";f||(r[z]=w)}h=c;c+=z.length;if(f){f=t[1];var l=z.indexOf(f),B=l+f.length;t[2]&&(B=z.length-t[2].length,l=B-f.length);w=w.substring(5);H(j+h,z.substring(0,l),g,k);H(j+h+l,f,I(w,f),k);H(j+h+B,z.substring(B),g,k)}else k.push(j+h,w)}a.g=k}var b={},s;(function(){for(var g=a.concat(d),j=[],k={},c=0,i=g.length;c<i;++c){var r= +g[c],n=r[3];if(n)for(var e=n.length;--e>=0;)b[n.charAt(e)]=r;r=r[1];n=""+r;k.hasOwnProperty(n)||(j.push(r),k[n]=q)}j.push(/[\S\s]/);s=S(j)})();var x=d.length;return g}function v(a){var d=[],g=[];a.tripleQuotedStrings?d.push(["str",/^(?:'''(?:[^'\\]|\\[\S\s]|''?(?=[^']))*(?:'''|$)|"""(?:[^"\\]|\\[\S\s]|""?(?=[^"]))*(?:"""|$)|'(?:[^'\\]|\\[\S\s])*(?:'|$)|"(?:[^"\\]|\\[\S\s])*(?:"|$))/,q,"'\""]):a.multiLineStrings?d.push(["str",/^(?:'(?:[^'\\]|\\[\S\s])*(?:'|$)|"(?:[^"\\]|\\[\S\s])*(?:"|$)|`(?:[^\\`]|\\[\S\s])*(?:`|$))/, +q,"'\"`"]):d.push(["str",/^(?:'(?:[^\n\r'\\]|\\.)*(?:'|$)|"(?:[^\n\r"\\]|\\.)*(?:"|$))/,q,"\"'"]);a.verbatimStrings&&g.push(["str",/^@"(?:[^"]|"")*(?:"|$)/,q]);var b=a.hashComments;b&&(a.cStyleComments?(b>1?d.push(["com",/^#(?:##(?:[^#]|#(?!##))*(?:###|$)|.*)/,q,"#"]):d.push(["com",/^#(?:(?:define|e(?:l|nd)if|else|error|ifn?def|include|line|pragma|undef|warning)\b|[^\n\r]*)/,q,"#"]),g.push(["str",/^<(?:(?:(?:\.\.\/)*|\/?)(?:[\w-]+(?:\/[\w-]+)+)?[\w-]+\.h(?:h|pp|\+\+)?|[a-z]\w*)>/,q])):d.push(["com", +/^#[^\n\r]*/,q,"#"]));a.cStyleComments&&(g.push(["com",/^\/\/[^\n\r]*/,q]),g.push(["com",/^\/\*[\S\s]*?(?:\*\/|$)/,q]));if(b=a.regexLiterals){var s=(b=b>1?"":"\n\r")?".":"[\\S\\s]";g.push(["lang-regex",RegExp("^(?:^^\\.?|[+-]|[!=]=?=?|\\#|%=?|&&?=?|\\(|\\*=?|[+\\-]=|->|\\/=?|::?|<<?=?|>>?>?=?|,|;|\\?|@|\\[|~|{|\\^\\^?=?|\\|\\|?=?|break|case|continue|delete|do|else|finally|instanceof|return|throw|try|typeof)\\s*("+("/(?=[^/*"+b+"])(?:[^/\\x5B\\x5C"+b+"]|\\x5C"+s+"|\\x5B(?:[^\\x5C\\x5D"+b+"]|\\x5C"+ +s+")*(?:\\x5D|$))+/")+")")])}(b=a.types)&&g.push(["typ",b]);b=(""+a.keywords).replace(/^ | $/g,"");b.length&&g.push(["kwd",RegExp("^(?:"+b.replace(/[\s,]+/g,"|")+")\\b"),q]);d.push(["pln",/^\s+/,q," \r\n\t\u00a0"]);b="^.[^\\s\\w.$@'\"`/\\\\]*";a.regexLiterals&&(b+="(?!s*/)");g.push(["lit",/^@[$_a-z][\w$@]*/i,q],["typ",/^(?:[@_]?[A-Z]+[a-z][\w$@]*|\w+_t\b)/,q],["pln",/^[$_a-z][\w$@]*/i,q],["lit",/^(?:0x[\da-f]+|(?:\d(?:_\d+)*\d*(?:\.\d*)?|\.\d\+)(?:e[+-]?\d+)?)[a-z]*/i,q,"0123456789"],["pln",/^\\[\S\s]?/, +q],["pun",RegExp(b),q]);return C(d,g)}function J(a,d,g){function b(a){var c=a.nodeType;if(c==1&&!x.test(a.className))if("br"===a.nodeName)s(a),a.parentNode&&a.parentNode.removeChild(a);else for(a=a.firstChild;a;a=a.nextSibling)b(a);else if((c==3||c==4)&&g){var d=a.nodeValue,i=d.match(m);if(i)c=d.substring(0,i.index),a.nodeValue=c,(d=d.substring(i.index+i[0].length))&&a.parentNode.insertBefore(j.createTextNode(d),a.nextSibling),s(a),c||a.parentNode.removeChild(a)}}function s(a){function b(a,c){var d= +c?a.cloneNode(!1):a,e=a.parentNode;if(e){var e=b(e,1),g=a.nextSibling;e.appendChild(d);for(var i=g;i;i=g)g=i.nextSibling,e.appendChild(i)}return d}for(;!a.nextSibling;)if(a=a.parentNode,!a)return;for(var a=b(a.nextSibling,0),d;(d=a.parentNode)&&d.nodeType===1;)a=d;c.push(a)}for(var x=/(?:^|\s)nocode(?:\s|$)/,m=/\r\n?|\n/,j=a.ownerDocument,k=j.createElement("li");a.firstChild;)k.appendChild(a.firstChild);for(var c=[k],i=0;i<c.length;++i)b(c[i]);d===(d|0)&&c[0].setAttribute("value",d);var r=j.createElement("ol"); +r.className="linenums";for(var d=Math.max(0,d-1|0)||0,i=0,n=c.length;i<n;++i)k=c[i],k.className="L"+(i+d)%10,k.firstChild||k.appendChild(j.createTextNode("\u00a0")),r.appendChild(k);a.appendChild(r)}function p(a,d){for(var g=d.length;--g>=0;){var b=d[g];F.hasOwnProperty(b)?D.console&&console.warn("cannot override language handler %s",b):F[b]=a}}function I(a,d){if(!a||!F.hasOwnProperty(a))a=/^\s*</.test(d)?"default-markup":"default-code";return F[a]}function K(a){var d=a.h;try{var g=T(a.c,a.i),b=g.a; +a.a=b;a.d=g.d;a.e=0;I(d,b)(a);var s=/\bMSIE\s(\d+)/.exec(navigator.userAgent),s=s&&+s[1]<=8,d=/\n/g,x=a.a,m=x.length,g=0,j=a.d,k=j.length,b=0,c=a.g,i=c.length,r=0;c[i]=m;var n,e;for(e=n=0;e<i;)c[e]!==c[e+2]?(c[n++]=c[e++],c[n++]=c[e++]):e+=2;i=n;for(e=n=0;e<i;){for(var p=c[e],w=c[e+1],t=e+2;t+2<=i&&c[t+1]===w;)t+=2;c[n++]=p;c[n++]=w;e=t}c.length=n;var f=a.c,h;if(f)h=f.style.display,f.style.display="none";try{for(;b<k;){var l=j[b+2]||m,B=c[r+2]||m,t=Math.min(l,B),A=j[b+1],G;if(A.nodeType!==1&&(G=x.substring(g, +t))){s&&(G=G.replace(d,"\r"));A.nodeValue=G;var L=A.ownerDocument,o=L.createElement("span");o.className=c[r+1];var v=A.parentNode;v.replaceChild(o,A);o.appendChild(A);g<l&&(j[b+1]=A=L.createTextNode(x.substring(t,l)),v.insertBefore(A,o.nextSibling))}g=t;g>=l&&(b+=2);g>=B&&(r+=2)}}finally{if(f)f.style.display=h}}catch(u){D.console&&console.log(u&&u.stack||u)}}var D=window,y=["break,continue,do,else,for,if,return,while"],E=[[y,"auto,case,char,const,default,double,enum,extern,float,goto,inline,int,long,register,short,signed,sizeof,static,struct,switch,typedef,union,unsigned,void,volatile"], +"catch,class,delete,false,import,new,operator,private,protected,public,this,throw,true,try,typeof"],M=[E,"alignof,align_union,asm,axiom,bool,concept,concept_map,const_cast,constexpr,decltype,delegate,dynamic_cast,explicit,export,friend,generic,late_check,mutable,namespace,nullptr,property,reinterpret_cast,static_assert,static_cast,template,typeid,typename,using,virtual,where"],N=[E,"abstract,assert,boolean,byte,extends,final,finally,implements,import,instanceof,interface,null,native,package,strictfp,super,synchronized,throws,transient"], +O=[N,"as,base,by,checked,decimal,delegate,descending,dynamic,event,fixed,foreach,from,group,implicit,in,internal,into,is,let,lock,object,out,override,orderby,params,partial,readonly,ref,sbyte,sealed,stackalloc,string,select,uint,ulong,unchecked,unsafe,ushort,var,virtual,where"],E=[E,"debugger,eval,export,function,get,null,set,undefined,var,with,Infinity,NaN"],P=[y,"and,as,assert,class,def,del,elif,except,exec,finally,from,global,import,in,is,lambda,nonlocal,not,or,pass,print,raise,try,with,yield,False,True,None"], +Q=[y,"alias,and,begin,case,class,def,defined,elsif,end,ensure,false,in,module,next,nil,not,or,redo,rescue,retry,self,super,then,true,undef,unless,until,when,yield,BEGIN,END"],W=[y,"as,assert,const,copy,drop,enum,extern,fail,false,fn,impl,let,log,loop,match,mod,move,mut,priv,pub,pure,ref,self,static,struct,true,trait,type,unsafe,use"],y=[y,"case,done,elif,esac,eval,fi,function,in,local,set,then,until"],R=/^(DIR|FILE|vector|(de|priority_)?queue|list|stack|(const_)?iterator|(multi)?(set|map)|bitset|u?(int|float)\d*)\b/, +V=/\S/,X=v({keywords:[M,O,E,"caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END",P,Q,y],hashComments:!0,cStyleComments:!0,multiLineStrings:!0,regexLiterals:!0}),F={};p(X,["default-code"]);p(C([],[["pln",/^[^<?]+/],["dec",/^<!\w[^>]*(?:>|$)/],["com",/^<\!--[\S\s]*?(?:--\>|$)/],["lang-",/^<\?([\S\s]+?)(?:\?>|$)/],["lang-",/^<%([\S\s]+?)(?:%>|$)/],["pun",/^(?:<[%?]|[%?]>)/],["lang-", +/^<xmp\b[^>]*>([\S\s]+?)<\/xmp\b[^>]*>/i],["lang-js",/^<script\b[^>]*>([\S\s]*?)(<\/script\b[^>]*>)/i],["lang-css",/^<style\b[^>]*>([\S\s]*?)(<\/style\b[^>]*>)/i],["lang-in.tag",/^(<\/?[a-z][^<>]*>)/i]]),["default-markup","htm","html","mxml","xhtml","xml","xsl"]);p(C([["pln",/^\s+/,q," \t\r\n"],["atv",/^(?:"[^"]*"?|'[^']*'?)/,q,"\"'"]],[["tag",/^^<\/?[a-z](?:[\w-.:]*\w)?|\/?>$/i],["atn",/^(?!style[\s=]|on)[a-z](?:[\w:-]*\w)?/i],["lang-uq.val",/^=\s*([^\s"'>]*(?:[^\s"'/>]|\/(?=\s)))/],["pun",/^[/<->]+/], +["lang-js",/^on\w+\s*=\s*"([^"]+)"/i],["lang-js",/^on\w+\s*=\s*'([^']+)'/i],["lang-js",/^on\w+\s*=\s*([^\s"'>]+)/i],["lang-css",/^style\s*=\s*"([^"]+)"/i],["lang-css",/^style\s*=\s*'([^']+)'/i],["lang-css",/^style\s*=\s*([^\s"'>]+)/i]]),["in.tag"]);p(C([],[["atv",/^[\S\s]+/]]),["uq.val"]);p(v({keywords:M,hashComments:!0,cStyleComments:!0,types:R}),["c","cc","cpp","cxx","cyc","m"]);p(v({keywords:"null,true,false"}),["json"]);p(v({keywords:O,hashComments:!0,cStyleComments:!0,verbatimStrings:!0,types:R}), +["cs"]);p(v({keywords:N,cStyleComments:!0}),["java"]);p(v({keywords:y,hashComments:!0,multiLineStrings:!0}),["bash","bsh","csh","sh"]);p(v({keywords:P,hashComments:!0,multiLineStrings:!0,tripleQuotedStrings:!0}),["cv","py","python"]);p(v({keywords:"caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END",hashComments:!0,multiLineStrings:!0,regexLiterals:2}),["perl","pl","pm"]);p(v({keywords:Q, +hashComments:!0,multiLineStrings:!0,regexLiterals:!0}),["rb","ruby"]);p(v({keywords:E,cStyleComments:!0,regexLiterals:!0}),["javascript","js"]);p(v({keywords:"all,and,by,catch,class,else,extends,false,finally,for,if,in,is,isnt,loop,new,no,not,null,of,off,on,or,return,super,then,throw,true,try,unless,until,when,while,yes",hashComments:3,cStyleComments:!0,multilineStrings:!0,tripleQuotedStrings:!0,regexLiterals:!0}),["coffee"]);p(v({keywords:W,cStyleComments:!0,multilineStrings:!0}),["rc","rs","rust"]); +p(C([],[["str",/^[\S\s]+/]]),["regex"]);var Y=D.PR={createSimpleLexer:C,registerLangHandler:p,sourceDecorator:v,PR_ATTRIB_NAME:"atn",PR_ATTRIB_VALUE:"atv",PR_COMMENT:"com",PR_DECLARATION:"dec",PR_KEYWORD:"kwd",PR_LITERAL:"lit",PR_NOCODE:"nocode",PR_PLAIN:"pln",PR_PUNCTUATION:"pun",PR_SOURCE:"src",PR_STRING:"str",PR_TAG:"tag",PR_TYPE:"typ",prettyPrintOne:D.prettyPrintOne=function(a,d,g){var b=document.createElement("div");b.innerHTML="<pre>"+a+"</pre>";b=b.firstChild;g&&J(b,g,!0);K({h:d,j:g,c:b,i:1}); +return b.innerHTML},prettyPrint:D.prettyPrint=function(a,d){function g(){for(var b=D.PR_SHOULD_USE_CONTINUATION?c.now()+250:Infinity;i<p.length&&c.now()<b;i++){for(var d=p[i],j=h,k=d;k=k.previousSibling;){var m=k.nodeType,o=(m===7||m===8)&&k.nodeValue;if(o?!/^\??prettify\b/.test(o):m!==3||/\S/.test(k.nodeValue))break;if(o){j={};o.replace(/\b(\w+)=([\w%+\-.:]+)/g,function(a,b,c){j[b]=c});break}}k=d.className;if((j!==h||e.test(k))&&!v.test(k)){m=!1;for(o=d.parentNode;o;o=o.parentNode)if(f.test(o.tagName)&& +o.className&&e.test(o.className)){m=!0;break}if(!m){d.className+=" prettyprinted";m=j.lang;if(!m){var m=k.match(n),y;if(!m&&(y=U(d))&&t.test(y.tagName))m=y.className.match(n);m&&(m=m[1])}if(w.test(d.tagName))o=1;else var o=d.currentStyle,u=s.defaultView,o=(o=o?o.whiteSpace:u&&u.getComputedStyle?u.getComputedStyle(d,q).getPropertyValue("white-space"):0)&&"pre"===o.substring(0,3);u=j.linenums;if(!(u=u==="true"||+u))u=(u=k.match(/\blinenums\b(?::(\d+))?/))?u[1]&&u[1].length?+u[1]:!0:!1;u&&J(d,u,o);r= +{h:m,c:d,j:u,i:o};K(r)}}}i<p.length?setTimeout(g,250):"function"===typeof a&&a()}for(var b=d||document.body,s=b.ownerDocument||document,b=[b.getElementsByTagName("pre"),b.getElementsByTagName("code"),b.getElementsByTagName("xmp")],p=[],m=0;m<b.length;++m)for(var j=0,k=b[m].length;j<k;++j)p.push(b[m][j]);var b=q,c=Date;c.now||(c={now:function(){return+new Date}});var i=0,r,n=/\blang(?:uage)?-([\w.]+)(?!\S)/,e=/\bprettyprint\b/,v=/\bprettyprinted\b/,w=/pre|xmp/i,t=/^code$/i,f=/^(?:pre|code|xmp)$/i, +h={};g()}};typeof define==="function"&&define.amd&&define("google-code-prettify",[],function(){return Y})})();}()
http://git-wip-us.apache.org/repos/asf/incubator-tamaya-site/blob/f5010f82/logos/egg-logo2.png ---------------------------------------------------------------------- diff --git a/logos/egg-logo2.png b/logos/egg-logo2.png new file mode 100644 index 0000000..9d25899 Binary files /dev/null and b/logos/egg-logo2.png differ http://git-wip-us.apache.org/repos/asf/incubator-tamaya-site/blob/f5010f82/release-guide.html ---------------------------------------------------------------------- diff --git a/release-guide.html b/release-guide.html new file mode 100644 index 0000000..0362876 --- /dev/null +++ b/release-guide.html @@ -0,0 +1,558 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";> + +<html xmlns="http://www.w3.org/1999/xhtml";> + <head> + <meta charset="utf-8"/> + <title>Apache Tamaya: Release Guide</title> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <meta name="description" content=""/> + <meta name="author" content=""/> + <meta name="keywords" content=""/> + <meta name="generator" content="'JBake '+'${version}"/> + + <!-- Le styles --> + <link href="css/bootstrap.min.css" rel="stylesheet"/> + <link href="css/asciidoctor.css" rel="stylesheet"/> + <link href="css/base.css" rel="stylesheet"/> + <link href="css/prettify.css" rel="stylesheet"/> + + <!-- HTML5 shim, for IE6-8 support of HTML5 elements --> + <!--[if lt IE 9]> + <script src="js/html5shiv.min.js"></script> + <![endif]--> + + <!-- Fav and touch icons from ASF --> + <link rel="shortcut icon" href="favicon.ico"/> + <link rel="apple-touch-icon" sizes="57x57" href="favicons/apple-touch-icon-57x57.png"/> + <link rel="apple-touch-icon" sizes="60x60" href="favicons/apple-touch-icon-60x60.png"/> + <link rel="apple-touch-icon" sizes="72x72" href="favicons/apple-touch-icon-72x72.png"/> + <link rel="apple-touch-icon" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"/> + <link rel="apple-touch-icon" sizes="114x114" href="favicons/apple-touch-icon-114x114.png"/> + <link rel="apple-touch-icon" sizes="120x120" href="favicons/apple-touch-icon-120x120.png"/> + <link rel="apple-touch-icon" sizes="144x144" href="favicons/apple-touch-icon-144x144.png"/> + <link rel="apple-touch-icon" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"/> + <link rel="apple-touch-icon" sizes="180x180" href="favicons/apple-touch-icon-180x180.png"/> + <link rel="icon" type="image/png" href="favicons/favicon-32x32.png" sizes="32x32"/> + <link rel="icon" type="image/png" href="favicons/favicon-194x194.png" sizes="194x194"/> + <link rel="icon" type="image/png" href="favicons/favicon-96x96.png" sizes="96x96"/> + <link rel="icon" type="image/png" href="favicons/android-chrome-192x192.png" sizes="192x192"/> + <link rel="icon" type="image/png" href="favicons/favicon-16x16.png" sizes="16x16"/> + <link rel="manifest" href="favicons/manifest.json"/> + <link rel="shortcut icon" href="favicons/favicon.ico"/> + <meta name="msapplication-TileColor" content="#603cba"/> + <meta name="msapplication-TileImage" content="favicons/mstile-144x144.png"/> + <meta name="msapplication-config" content="favicons/browserconfig.xml"/> + <meta name="theme-color" content="#303284"/> + </head> + <body onload="prettyPrint()"> + <div id="wrap"> + <div> + + <!-- Fixed navbar --> + <div class="navbar navbar-default navbar-fixed-top" role="navigation"> + <div class="container"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="index.html">Apache Tamaya (incubating)</a> + </div> + <div class="navbar-collapse collapse"> + <ul class="nav navbar-nav"> + <li><a href="start.html">Tamaya in 5 minutes</a></li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="documentation/usecases.html">Use Cases and Requirements</a></li> + <li><a href="documentation/quickstart.html">Quickstart</a></li> + <li><a href="documentation/api.html">API</a></li> + <li><a href="documentation/core.html">Core</a></li> + <li><a href="documentation/extensions.html">Extension Guide</a></li> + <li class="divider"></li> + <li><a href="apidocs/index.html">Javadoc 0.3-incubating-SNAPSHOT (external)</a></li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="development/source.html">Sources</a></li> + <li><a href="development/community.html">Community</a></li> + <li><a href="development/team.html">Project Team</a></li> + <li><a target="_blank" href="https://builds.apache.org/view/S-Z/view/Tamaya/";>CI / ASF Jenkins</a></li> + <li><a target="_blank" href="https://issues.apache.org/jira/browse/TAMAYA";>Issues / ASF Jira</a></li> + <li><a href="devguide.html">Development Guide</a></li> + <li><a href="release-guide.html">Release Guide</a></li> + <li class="divider"></li> + <li><a href="development/possible-contributions.html">Possible Contributions</a></li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Releases <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="download.html">Download</a></li> + <li><a href="history.html">Release History</a></li> + </ul> + </li> +<!-- Example: + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="#">Action</a></li> + <li><a href="#">Another action</a></li> + <li><a href="#">Something else here</a></li> + <li class="divider"></li> + <li class="dropdown-header">Nav header</li> + <li><a href="#">Separated link</a></li> + <li><a href="#">One more separated link</a></li> + </ul> + </li> +--> + <li><a href="sitemap.xml">Sitemap</a></li> + <li><a href="feed.xml">Subscribe</a></li> + </ul> + </div><!--/.nav-collapse --> + </div> + </div> + + </div> + <div class="container"> + + <div class="page-header"> + <h1>Apache Tamaya: Release Guide</h1> + </div> + + <p><em>2017-01-10</em></p> + + <p><div id="preamble"> +<div class="sectionbody"> +<div class="paragraph"> +<p>Performing a release requires several steps. This document describes each step, so everybody in the committer’s +team should be able to perform the release procedure.</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_tell_the_others_you_would_proceed_with_the_release_procedure">1. Tell the others you would proceed with the release procedure</h2> +<div class="sectionbody"> +<div class="listingblock"> +<div class="content"> +<pre>first steps for the next release + +Hi @ all, + +If there are no objections, I'll start with the first steps for +the next release (review, documentation,...). +It would be great to start with the release procedure next week. + +Best regards, +[name]</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_check_everything_is_ready">2. Check everything is ready</h2> +<div class="sectionbody"> +<div class="ulist"> +<ul> +<li> +<p>Check the jenkins builds.</p> +</li> +<li> +<p>Ensure all JIRA-tickets targeting the release are resolved. If not, get in contact with the ticket +owner/assignee to check</p> +<div class="ulist"> +<ul> +<li> +<p>if the ticket can be postponed for the next release</p> +</li> +<li> +<p>how long it takes to resolve it and if one can help.</p> +</li> +</ul> +</div> +</li> +</ul> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_prepare_the_release">3. Prepare the release</h2> +<div class="sectionbody"> +<div class="ulist"> +<ul> +<li> +<p>Create release notes and commit them to <code>tamaya/readme/</code> (format <code>ReleaseNotes-[version].html</code>)</p> +</li> +<li> +<p>Create a release branch in git and switch to this branch:</p> +</li> +</ul> +</div> +<div class="sect2"> +<h3 id="_using_the_release_plugin">3.1. Using the Release Plugin</h3> +<div class="paragraph"> +<p>For performing the release you can use the maven release plugin:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ git checkout -b vote-tamaya-[release version] +$ export MAVEN_OPTS="-Xmx512m -XX:MaxPermSize=200m" +$ mvn release:prepare -DdryRun=true -DperformRelease=true +# optionally pass GPG params for signing with: -Darguments="-Dgpg.keyname=1336D3E6 -Dgpg.passphrase=XXXXXX" +# copy prepared workspace (to continue faster if an upload fails in the next step)</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>If something fails you may switch to the master branch, fix whatever is needed and rebase your release branch to +accommodate the latest changes done.</p> +</li> +<li> +<p>On success you can check the release packages from <code>dist/target</code>.</p> +</li> +<li> +<p>If everything looks good you can proceed with the release:</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ export MAVEN_OPTS="-Xmx512m -XX:MaxPermSize=200m" +$ mvn release:prepare -DperformRelease=true +$ mvn release:perform -DperformRelease=true</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_preparing_the_release_without_the_release_plugin">3.2. Preparing the release without the Release Plugin</h3> +<div class="paragraph"> +<p>The release plugin is great, but in some cases it breaks even, when release:prepare -DdryRun=true was successful. +Preparing the release vote without the release plugin is stright forward:</p> +</div> +<div class="ulist"> +<ul> +<li> +<p>As described checkout a release branch of the current head</p> +</li> +<li> +<p>Then us maven and git commands to prepare the release:</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ git checkout -b vote-tamaya-[release version] +$ export MAVEN_OPTS="-Xmx512m -XX:MaxPermSize=200m" +$ mvn versions:set versions:commit -DnewVersion=[release version] -DperformRelease=true +# build the release locally and sign it with your certs +$ mvn clean install -DperformRelease=true -Dgpg.keyname=1336D3E6 -Dgpg.passphrase=XXXXXX</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Check if everything is in place and correct, when finished you can tag and deploy the release…​</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ mvn deploy -DperformRelease=true -Dgpg.keyname=1336D3E6 -Dgpg.passphrase=XXXXXX</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>check the created commits including user-name and email</p> +</li> +<li> +<p>login to <a href="https://repository.apache.org/"; class="bare" target="_blank">https://repository.apache.org/</a> and go to "Staging Repositories"</p> +</li> +<li> +<p>check the contents of the newly created tamaya staging repository</p> +</li> +<li> +<p><em>close</em> the repository to let Nexus do its validations</p> +</li> +<li> +<p>On success:</p> +</li> +<li> +<p>push the release-branch to the git repo</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ git add -A +$ git commit -m "Release Prepare: Set release version." +$ git tag vote01-[release-version] +$ git push --tags</pre> +</div> +</div> +<div class="paragraph"> +<p>Finally open the next development version:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre># example: newVersion=0.3-incubating-SNAPSHOT +$ mvn version:set versions:commit -DnewVersion=[development-version] +$ git add -A +$ git commit -m "Release Prepare: Open new development version."</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Add the distribution artifacts to the dev repositories:</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ svn co https://dist.apache.org/repos/dist/dev/incubator/tamaya/ +$ mkdir [version] +$ set RELEASE_HOME='pwd'/[version] +$ cd PROJECT_ROOT +$ cp DISCLAIMER $RELEASE_HOME +$ cp NOTICE $RELEASE_HOME +$ cp LICENCE $RELEASE_HOME +$ cp rat.txt $RELEASE_HOME +# Copy everything from +# $STAGING_REPO/distribution/0.2-incubating/tamaya-distribution-[version]-distribution-* into $RELEASE_HOME +$ svn add [version] +$ svn commit --username <apacheId></pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Check contents on <a href="https://dist.apache.org/repos/dist/dev/incubator/tamaya/";>version</a></p> +</li> +</ul> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_start_the_vote">4. Start the vote</h2> +<div class="sectionbody"> +<div class="listingblock"> +<div class="content"> +<pre>[VOTE] Release of Apache Tamaya [version] + +Hi, + +I was running the needed tasks to get the [version] release of Apache Tamaya out. +The artifacts are deployed to Nexus [1] (and [2]) and releases [4]. + +The tag is available at [3] and will renamed once the vote passed. + +Please take a look at the artifacts and vote! + +Please note: +This vote is a "majority approval" with a minimum of three +1 votes (see [5]). + +------------------------------------------------ +[ ] +1 for community members who have reviewed the bits +[ ] +0 +[ ] -1 for fatal flaws that should cause these bits not to be released, and why.............. +------------------------------------------------ + +Thanks, +[name] + +[1] https://repository.apache.org/content/repositories/... +[2] https://repository.apache.org/content/repositories/org/apache/tamaya/tamaya-distribution/[version]/tamaya-[version]-source-release.zip + https://repository.apache.org/content/repositories/org/apache/tamaya/tamaya-distribution/[version]/tamaya-[version]-bin-release.zip +[3] https://git1-us-west.apache.org/repos/asf?p=incubator-tamaya.git;a=commit;h=2910da468fce16210e6dd77d8ba23ddbdd434efe +[4] https://dist.apache.org/repos/dist/dev/incubator/tamaya/[release-version] +[5] http://www.apache.org/foundation/voting.html#ReleaseVotes</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Announce the Vote</p> +<div class="ulist"> +<ul> +<li> +<p>Create a short link to the release at <a href="http://s.apache.org"; class="bare">http://s.apache.org</a> (format Tamaya_[version])</p> +</li> +<li> +<p>Tweet about the vote via <em>@TamayaConf</em></p> +</li> +</ul> +</div> +</li> +<li> +<p>After 72 hours close the vote write a reult email, e.g.</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>[Result] (was: Re: [VOTE] Release of Apache Tamaya [version]) + +Thank you for voting! + +X binding +1 votes (pmc): +[list] + +Y non-binding +1 votes: +[list] + +Z -1 votes +[list]</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>After the vote on the PPMC has been finished and is successful, repeat the voting process on the +incubator mailing list.</p> +</li> +</ul> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_perform_the_release">5. Perform the release</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>If the binding majority approved the vote on both lists continue:</p> +</div> +<div class="ulist"> +<ul> +<li> +<p>Login to <a href="https://repository.apache.org/"; class="bare">https://repository.apache.org/</a> and <em>release</em> the repository</p> +</li> +<li> +<p>Rename the vote branch:</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ git branch -m vote01-tamaya-[release-version] tamaya-[release-version]</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Add a release tag:</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ git tag -a tamaya-[release-version]</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Merge master with the new prepared version:</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ git checkout master +$ git merge tamaya-[release-version] +$ git push origin tamaya-[release-version] +$ git push origin master</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Close the release and corresponding tickets at JIRA</p> +</li> +<li> +<p>Wait some minutes and check <a href="http://repo2.maven.org/maven2/org/apache/tamaya"; class="bare" target="_blank">http://repo2.maven.org/maven2/org/apache/tamaya</a></p> +</li> +<li> +<p>Upload the distribution Artifacts</p> +</li> +</ul> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ svn co https://dist.apache.org/repos/dist/release/incubator/tamaya/ +$ mkdir [version] +# add and commit the artifacts (*source-release.zip, *bin-release.zip + asc, md5, sha1) +# use the artifacts from: +# http://repo1.maven.org/maven2/org/apache/tamaya/tamaya-distribution/[version]/</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_updating_the_tamaya_project_site">6. Updating the Tamaya Project Site</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Basically the new site should be directly deployable, just execute</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>$ mvn site site:deploy</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_announce_the_new_version">7. Announce the new version</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Announce the new version on @TamayaConf and other social media channels. +Also drop a short mail on the mailing list.</p> +</div> +</div> +</div></p> + + <hr /> + </div> + </div> + <div> + <div id="push"></div> + + <div id="footer"> + <div class="container"> + <p class="muted credit">© 2014-2016 Apache Software Foundation | Mixed with <a href="http://getbootstrap.com/";>Bootstrap v3.1.1</a> + | Baked with <a href="http://jbake.org";>JBake <span>v2.5.0</span></a> + at <span>2017-01-15</span> + </p> + <p> + <b>Disclaimer</b> + Apache Tamaya (incubating) is an effort undergoing + incubation at + The Apache Software Foundation (ASF), sponsored by + the name of Apache Incubator. 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.<br /> + <a href="http://incubator.apache.org/guides/website.html"; style="border:0px;" target="_target"><img class="incubator-logo" src="logos/egg-logo2.png"/></a> + </p> + </div> + </div> + + <!-- Le javascript + ================================================== --> + <!-- Placed at the end of the document so the pages load faster --> + <script src="js/jquery-1.11.1.min.js"></script> + <script src="js/bootstrap.min.js"></script> + <script src="js/prettify.js"></script> + + </div> + </body> +</html> http://git-wip-us.apache.org/repos/asf/incubator-tamaya-site/blob/f5010f82/sitemap.xml ---------------------------------------------------------------------- diff --git a/sitemap.xml b/sitemap.xml new file mode 100644 index 0000000..5462fdd --- /dev/null +++ b/sitemap.xml @@ -0,0 +1,154 @@ +<?xml version="1.0" encoding="UTF-8"?> +<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"; xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd";> + <url> + <loc>https://tamaya.incubator.apache.org/start.html</loc> + <lastmod>2017-01-15</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/apidocs/index.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/development/community.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/development/possible-contributions.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/development/source.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/development/team.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/devguide.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/api.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/core.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_builder.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_camel.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_cdi.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_classloader_support.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_collections.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_consul.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_environment.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_etcd.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_events.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_filter.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_formats.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_functions.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_injection.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_jodatime.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_json.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_management.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_metamodel-staged.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_model.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_mutable_config.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_optional.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_osgi.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_remote.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_resolver.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_resources.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_server.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_spi-support.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_spring.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_usagetracker.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_validation.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions/mod_yaml.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/extensions.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/quickstart.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/documentation/usecases.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/download.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/examples.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/highleveldesign.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/history.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/release-guide.html</loc> + <lastmod>2017-01-10</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/blog/2015/introduction.html</loc> + <lastmod>2015-07-01</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/blog/2014/whatistamaya.html</loc> + <lastmod>2014-12-15</lastmod> + </url><url> + <loc>https://tamaya.incubator.apache.org/blog/2014/no-jsr-in-javaee8.html</loc> + <lastmod>2014-09-03</lastmod> + </url> +</urlset> http://git-wip-us.apache.org/repos/asf/incubator-tamaya-site/blob/f5010f82/start.html ---------------------------------------------------------------------- diff --git a/start.html b/start.html new file mode 100644 index 0000000..5b455c8 --- /dev/null +++ b/start.html @@ -0,0 +1,270 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";> + +<html xmlns="http://www.w3.org/1999/xhtml";> + <head> + <meta charset="utf-8"/> + <title>Tamaya in 5 minutes - a short introduction</title> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <meta name="description" content=""/> + <meta name="author" content=""/> + <meta name="keywords" content=""/> + <meta name="generator" content="'JBake '+'${version}"/> + + <!-- Le styles --> + <link href="css/bootstrap.min.css" rel="stylesheet"/> + <link href="css/asciidoctor.css" rel="stylesheet"/> + <link href="css/base.css" rel="stylesheet"/> + <link href="css/prettify.css" rel="stylesheet"/> + + <!-- HTML5 shim, for IE6-8 support of HTML5 elements --> + <!--[if lt IE 9]> + <script src="js/html5shiv.min.js"></script> + <![endif]--> + + <!-- Fav and touch icons from ASF --> + <link rel="shortcut icon" href="favicon.ico"/> + <link rel="apple-touch-icon" sizes="57x57" href="favicons/apple-touch-icon-57x57.png"/> + <link rel="apple-touch-icon" sizes="60x60" href="favicons/apple-touch-icon-60x60.png"/> + <link rel="apple-touch-icon" sizes="72x72" href="favicons/apple-touch-icon-72x72.png"/> + <link rel="apple-touch-icon" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"/> + <link rel="apple-touch-icon" sizes="114x114" href="favicons/apple-touch-icon-114x114.png"/> + <link rel="apple-touch-icon" sizes="120x120" href="favicons/apple-touch-icon-120x120.png"/> + <link rel="apple-touch-icon" sizes="144x144" href="favicons/apple-touch-icon-144x144.png"/> + <link rel="apple-touch-icon" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"/> + <link rel="apple-touch-icon" sizes="180x180" href="favicons/apple-touch-icon-180x180.png"/> + <link rel="icon" type="image/png" href="favicons/favicon-32x32.png" sizes="32x32"/> + <link rel="icon" type="image/png" href="favicons/favicon-194x194.png" sizes="194x194"/> + <link rel="icon" type="image/png" href="favicons/favicon-96x96.png" sizes="96x96"/> + <link rel="icon" type="image/png" href="favicons/android-chrome-192x192.png" sizes="192x192"/> + <link rel="icon" type="image/png" href="favicons/favicon-16x16.png" sizes="16x16"/> + <link rel="manifest" href="favicons/manifest.json"/> + <link rel="shortcut icon" href="favicons/favicon.ico"/> + <meta name="msapplication-TileColor" content="#603cba"/> + <meta name="msapplication-TileImage" content="favicons/mstile-144x144.png"/> + <meta name="msapplication-config" content="favicons/browserconfig.xml"/> + <meta name="theme-color" content="#303284"/> + </head> + <body onload="prettyPrint()"> + <div id="wrap"> + <div> + + <!-- Fixed navbar --> + <div class="navbar navbar-default navbar-fixed-top" role="navigation"> + <div class="container"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="index.html">Apache Tamaya (incubating)</a> + </div> + <div class="navbar-collapse collapse"> + <ul class="nav navbar-nav"> + <li><a href="start.html">Tamaya in 5 minutes</a></li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="documentation/usecases.html">Use Cases and Requirements</a></li> + <li><a href="documentation/quickstart.html">Quickstart</a></li> + <li><a href="documentation/api.html">API</a></li> + <li><a href="documentation/core.html">Core</a></li> + <li><a href="documentation/extensions.html">Extension Guide</a></li> + <li class="divider"></li> + <li><a href="apidocs/index.html">Javadoc 0.3-incubating-SNAPSHOT (external)</a></li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Development <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="development/source.html">Sources</a></li> + <li><a href="development/community.html">Community</a></li> + <li><a href="development/team.html">Project Team</a></li> + <li><a target="_blank" href="https://builds.apache.org/view/S-Z/view/Tamaya/";>CI / ASF Jenkins</a></li> + <li><a target="_blank" href="https://issues.apache.org/jira/browse/TAMAYA";>Issues / ASF Jira</a></li> + <li><a href="devguide.html">Development Guide</a></li> + <li><a href="release-guide.html">Release Guide</a></li> + <li class="divider"></li> + <li><a href="development/possible-contributions.html">Possible Contributions</a></li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Releases <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="download.html">Download</a></li> + <li><a href="history.html">Release History</a></li> + </ul> + </li> +<!-- Example: + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="#">Action</a></li> + <li><a href="#">Another action</a></li> + <li><a href="#">Something else here</a></li> + <li class="divider"></li> + <li class="dropdown-header">Nav header</li> + <li><a href="#">Separated link</a></li> + <li><a href="#">One more separated link</a></li> + </ul> + </li> +--> + <li><a href="sitemap.xml">Sitemap</a></li> + <li><a href="feed.xml">Subscribe</a></li> + </ul> + </div><!--/.nav-collapse --> + </div> + </div> + + </div> + <div class="container"> + + <div class="page-header"> + <h1>Tamaya in 5 minutes - a short introduction</h1> + </div> + + <p><em>2017-01-15</em></p> + + <p><div id="preamble"> +<div class="sectionbody"> +<div class="paragraph"> +<p>Apache Tamaya (incubating) provides a flexible and powerful +configuration solution +for Java developers using Java SE as well as for more complex +usage scenarios like cloud or Java EE. It provides a modern +type-safe property based Configuration API combined with a +powerful environment model and a flexible SPI.</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_features">Features</h2> +<div class="sectionbody"> +<div class="ulist"> +<ul> +<li> +<p>Unified Configuration API</p> +</li> +<li> +<p>Pluggable Configuration Backends</p> +</li> +<li> +<p>Enforceable Configuration Policies</p> +</li> +<li> +<p>Configuration Validation and Documentation</p> +</li> +<li> +<p>Seamless Enterprise Integration</p> +</li> +</ul> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_documentation">Documentation</h2> +<div class="sectionbody"> +<div class="ulist"> +<ul> +<li> +<p><a href="documentation/usecases.html">Use Cases and Requirements</a></p> +</li> +<li> +<p><a href="highleveldesign.html">High Level Design</a></p> +</li> +<li> +<p><a href="documentation/api.html">API</a></p> +</li> +<li> +<p><a href="documentation/core.html">Core</a></p> +</li> +<li> +<p><a href="documentation/extensions.html">Extensions</a></p> +</li> +</ul> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_quickstart">Quickstart</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Using Apache Tamaya is simple:</p> +</div> +<div class="olist arabic"> +<ol class="arabic"> +<li> +<p>Add <code>org.apache.tamaya:tamaya-core:0.3-incubating-SNAPSHOT</code> to your dependencies.</p> +</li> +<li> +<p>Add your config to <code>META-INF/javaconfiguration.properties</code></p> +</li> +<li> +<p>Access your configuration by <code>ConfigurationProvider.getConfiguration()</code> and use it.</p> +</li> +<li> +<p>Look at the [extension modules](extensions.html) to customize your setup!</p> +</li> +<li> +<p>Enjoy!</p> +</li> +</ol> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_rationale">Rationale</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Configuration is one of the most prominent cross-cutting concerns similar to logging. Most of us already have been +writing similar code again and again in each of our projects. Sometimes in a similar way but mostly always slightly +different, but certainly with high coupling to your configuration backends. Given your code is reused or integrated +some how, or deployed by some customers, struggling starts: not supported backends, different policies, missing +combination and validation mechanisms and so on. Tamaya solves all this by defining a common API and backend SPI. +Your code is decoupled from the configuration backend. There is no difference if your code is deployed on your dev box +or in a clustered Docker environment in production, it stays the same!</p> +</div> +</div> +</div></p> + + <hr /> + </div> + </div> + <div> + <div id="push"></div> + + <div id="footer"> + <div class="container"> + <p class="muted credit">© 2014-2016 Apache Software Foundation | Mixed with <a href="http://getbootstrap.com/";>Bootstrap v3.1.1</a> + | Baked with <a href="http://jbake.org";>JBake <span>v2.5.0</span></a> + at <span>2017-01-15</span> + </p> + <p> + <b>Disclaimer</b> + Apache Tamaya (incubating) is an effort undergoing + incubation at + The Apache Software Foundation (ASF), sponsored by + the name of Apache Incubator. 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.<br /> + <a href="http://incubator.apache.org/guides/website.html"; style="border:0px;" target="_target"><img class="incubator-logo" src="logos/egg-logo2.png"/></a> + </p> + </div> + </div> + + <!-- Le javascript + ================================================== --> + <!-- Placed at the end of the document so the pages load faster --> + <script src="js/jquery-1.11.1.min.js"></script> + <script src="js/bootstrap.min.js"></script> + <script src="js/prettify.js"></script> + + </div> + </body> +</html>
