incubator-kitty-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r782940 - in /websites/staging/kitty/trunk/content/kitty: getting-Started.html index.html sitemap.html
Date Wed, 12 Jan 2011 20:54:23 GMT
Author: buildbot
Date: Wed Jan 12 20:54:23 2011
New Revision: 782940

Log:
Staging update by buildbot

Added:
    websites/staging/kitty/trunk/content/kitty/getting-Started.html
Modified:
    websites/staging/kitty/trunk/content/kitty/index.html
    websites/staging/kitty/trunk/content/kitty/sitemap.html

Added: websites/staging/kitty/trunk/content/kitty/getting-Started.html
==============================================================================
--- websites/staging/kitty/trunk/content/kitty/getting-Started.html (added)
+++ websites/staging/kitty/trunk/content/kitty/getting-Started.html Wed Jan 12 20:54:23 2011
@@ -0,0 +1,63 @@
+<html>
+<head><title>Getting Started Developing for Apache Kitty</title>
+</head>
+<body>
+<h1>Getting Started Developing for Apache Kitty</h1>
+<div id="content"><p>Kitty is a command line JMX Client written in Groovy. 
+Kitty is currently an Apache Incubator project, and is growing as a JMX administration utility
for applications which support JMX. Kitty is an excellent project to begin contributing to
an open source project, and filing a need amongst Java developers for a handy utility for
managing and monitoring applications through JMX in a way that is intuitive and user friendly.

+<br />
+<h3>What you will learn in this document</h3>
+<br />
+In this document you will learn how to set up your development environment so that you can
begin developing for Kitty. Kitty is currently a very simple project to work on, it is written
in Groovy, which is a fun language to write code in, and a great opportunity for those looking
to begin contributing to an open source project which has immediate usefulness.
+<br />
+<h3>Finding something to work on</h3>
+<br /><br /></p>
+<p>There are many things to be worked on for the Kitty project. The best way to find
out what needs to be done on the project (or any other ASF Incubator project), is to send
a message out to the dev mailing list. You can subscribe to the Kitty-dev mailing list by
sending a blank email to kitty-dev-subscribe@incubator.apache.org. Then you will receive a
confirmation message once you are subscribed to the list. If you don't want to subscribe,
but want to send a message to the list, you can simply send a message to kitty-dev@incbuator.apache.org
and it will be moderated by the mailing list administrators.
+<br />
+If you are interested in being a committer for the project, see http://www.apache.org/dev/new-committers-guide.html.

+<br />
+Also, you may investigate the open issues for Kitty in the ASF JIRA to find out which tasks
and bugs need to be worked on. This is also a great starting point for getting involved and
contributing to the project. https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12311202&amp;status=1
+<br /><br />
+<h3>Setting up your IDE</h3>
+<br /><br />
+It is suggested to download the Eclipse IDE to begin working on Kitty. This allows you to
keep better track of the source code of the project and integrates with Subversion. You may
use any editor or IDE you choose, in this example, Eclipse is used. 
+<br />
+Step 1) Download Eclipse from http://www.eclipse.org/downloads/. I have chosen the "Eclipse
IDE for Java Developers"
+Step 2) Install the Subversive Plugin for Subversion integration by following the instructions
at http://www.eclipse.org/subversive/documentation/gettingStarted/aboutSubversive/install.php
+<br />
+NOTE: You should now see a "SVN Repositories" button on the top right view, or by navigating
to Window-&gt;Show View-&gt;SVN Repositories
+<br />
+NOTE: You will need to change the update site for the Subversive connectors, if you don't
do this it is likely that the connector installation will fail. You should use http://download.eclipse.org/technology/subversive/0.7/update-site/
fro the connectors update site. See http://www.eclipse.org/subversive/downloads.php "Is it
right that version 0.7 is newer than versions 1.1.0 and 1.0.0, which I previously used?" in
the FAQs for a further explanation. If you run into trouble here, send a message to the mailing
list and someone will help you.</p>
+<p>Step 3) Append or use the following .subversion/config file to properly set your
Subversion configuration for ASF/Kitty use. </p>
+<p>Step 4) Download Groovy from http://groovy.codehaus.org/Download
+Step 5) Install the Groovy-Eclipse plugin by following the instructions at http://groovy.codehaus.org/Eclipse+Plugin
under "How to Install"</p>
+<p>Step 6) Navigate to SVN Repositories by clicking the SVN Repositories button in
the top right-hand corner or by going to the menu: "Window-&gt;Show View-&gt;SVN Repositories"</p>
+<p>Step 7) Click the menu: "New-&gt;Repository Location"
+Step 8) Enter https://svn.apache.org/repos/asf/incubator/kitty/ for the URL. Leave all other
fields blank, unless you are a commuter. 
+<br />
+NOTE: Unless you are a committer, you will be unable to commit changes through SVN. If you'd
like to be a committer, send a message out to the kitty-dev@incubator.apache.org mailing list,
our simply attach a patch to the mailing list and one of the committers will check it in.
For guidelines on submitting a patch: see http://subversion.apache.org/docs/community-guide/general.html#patches.

+<br />
+Now you will have set up your development environment for working with Kitty. You will now
need to set up and configure Apache Ant to build the project. 
+<br /><br />
+<h3>Building and running Kitty</h3>
+<br /><br />
+To build the project, you will need to do update your build patch to include the location
of the Groovy binaries. Switch that he Navigator view by going to the menu "Window-&gt;Show
View-&gt;Navigator".</p>
+<p>Step 1) Change the line in the Ant build.xml which shows: 
+        <fileset dir="/Users/msacks/groovy-1.7.4/lib"><br />
+to point to the properly installed path of your Groovy ./lib directory. </p>
+<p>Step 2) Right click the buid.xml file and select "Run As-&gt;Ant build"
+<br /><br /></p>
+<p>You should now see a message in the Eclipse console stating: "BUILD SUCCESSFUL"</p>
+<p>To run Kitty:
+<br /><br />
+Step 1) Navigate to src/org/apache/kitty/
+Step 2) Right click on CmdShell.groovy
+Step 3) Select "Run As-&gt;Groovy script"
+<br /><br /></p>
+<p>Now you will see Kitty running in the Eclipse Console. Type help to see a list of
available commands. Now you may use and test Kitty!</p>
+<p><br /><br />
+NOTE: This document is continuously being improved. For suggestions on updating this document,
send a message to the kitty-dev mailing list. Patches are welcome for the site as well.</p>
+<p><br /><br /></p>
+<p><a href="http://incubator.apache.org/kitty/">Kitty Home</a></p></div>
+</body>
+</html>

Modified: websites/staging/kitty/trunk/content/kitty/index.html
==============================================================================
--- websites/staging/kitty/trunk/content/kitty/index.html (original)
+++ websites/staging/kitty/trunk/content/kitty/index.html Wed Jan 12 20:54:23 2011
@@ -1,20 +1,25 @@
 <html>
-<head><title>Kitty Home Page</title>
+<head><title>Apache Kitty Home Page</title>
 </head>
 <body>
-<h1>Kitty Home Page</h1>
-<div id="content"><h2>Kitty is a lightweight, production focused, Java-based
application server performance diagnostic and management utility designed specifically for
Apache Tomcat.</h2>
+<h1>Apache Kitty Home Page</h1>
+<div id="content"><h2>Kitty is a lightweight, production focused, command-line
JMX Client</h2>
 
 <p><br />
 Quick Links: 
 <a href="https://issues.apache.org/jira/browse/KITTY">Kitty JIRA</a>
 <a href="http://incubator.apache.org/projects/kitty.html">Incubation Status</a>
 <a href="http://www.scribd.com/doc/41349990/Kitty-Apachecon-2010">Kitty ApacheCon 2010</a></p>
+<p>Getting Started in Developing for Apache Kitty: 
+<a href="http://incubator.apache.org/kitty/">Getting Started</a></p>
 <p><br /><br />
 Mailing List: <a href="mailto:kitty-dev@incubator.apache.org>kitty-dev@incubator.apache.org</a>
 To subscribe: <a href="mailto:kitty-dev-subscribe@incubator.apache.org>kitty-dev-subscribe@incubator.apache.org</a>
 <br /><br />
 <strong>History:</strong>
-Originally, kitty was written to provide a simple utility for managing and diagnosting Tomcat
servers in production. It was originally written in Jython, but has since been ported to Groovy
for ease of compilation to Java classes. </p></div>
+Originally, kitty was written to provide a simple utility for managing and diagnosing Tomcat
servers in production. It was originally written in Jython, but has since been ported to Groovy
for ease of compilation to Java classes. 
+<br /><br />
+<strong>Roadmap</strong>
+Coming soon</p></div>
 </body>
 </html>

Modified: websites/staging/kitty/trunk/content/kitty/sitemap.html
==============================================================================
--- websites/staging/kitty/trunk/content/kitty/sitemap.html (original)
+++ websites/staging/kitty/trunk/content/kitty/sitemap.html Wed Jan 12 20:54:23 2011
@@ -4,7 +4,8 @@
 <body>
 <h1>Kitty Sitemap</h1>
 <div id="content"><ul>
-<li><a href="/kitty/index.html">Kitty Home Page</a></li>
+<li><a href="/kitty/getting-Started.html">Getting Started Developing for Apache
Kitty</a></li>
+<li><a href="/kitty/index.html">Apache Kitty Home Page</a></li>
 </ul></div>
 </body>
 </html>



Mime
View raw message