Mailing-List: contact callback-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: callback-dev@incubator.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: pmuellr@apache.org
To: callback-commits@incubator.apache.org
Subject: weinre commit: doc updates
Message-Id: <20120425140410.6A594E334@tyr.zones.apache.org>
Date: Wed, 25 Apr 2012 14:04:10 +0000 (UTC)

Updated Branches:
  refs/heads/master d1dd91e56 -> 7f27d9a9a


doc updates


Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/commit/7f27d9a9
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/tree/7f27d9a9
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/diff/7f27d9a9

Branch: refs/heads/master
Commit: 7f27d9a9a328fde84dd4390ab02e43442f7e6f7a
Parents: d1dd91e
Author: Patrick Mueller <pmuellr@apache.org>
Authored: Wed Apr 25 10:03:59 2012 -0400
Committer: Patrick Mueller <pmuellr@apache.org>
Committed: Wed Apr 25 10:03:59 2012 -0400

----------------------------------------------------------------------
 weinre.build/new-release-notes.md |   56 ++++++++++++++++++++++---------
 weinre.doc/Home.body.html         |    4 +-
 2 files changed, 42 insertions(+), 18 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/7f27d9a9/weinre.build/new-release-notes.md
----------------------------------------------------------------------
diff --git a/weinre.build/new-release-notes.md b/weinre.build/new-release-notes.md
index cbbbce6..ac58886 100644
--- a/weinre.build/new-release-notes.md
+++ b/weinre.build/new-release-notes.md
@@ -26,17 +26,19 @@ steps to create a new release
 
 - add changelog to `weinre.doc/ChangeLog.body.html`
 
+  - use `weinre.build/scripts/gen-changelog.py` for this
+
 - fix other doc as necessary
 
 - perform full build with:
 
-   - cd into `weinre.build` and run ant
+   - cd into `weinre.build` and run `ant build-archives`
 
 - run the smoke test (see below) to ensure delicious smoky flavor
 
-- upload the `weinre-*-x.y.z.zip`
+- upload the archives wherever
 
-- make sure you can download those zip files!
+- make sure you can download those archives!
 
 - commit release changes:
    - `git add .`
@@ -45,14 +47,24 @@ steps to create a new release
 - merge branch onto master:
 
    - `git checkout master`
-   - `git merge release-x.y.z`
+   - `git merge --squash release-x.y.z`
+   - `git commit -m "update for release x.y.z"`
    - `git push`
    - `git tag -a x.y.z`
    - `git push --tags`
 
+- copy archives into temporary download location
+   - currently [http://people.apache.org/~pmuellr/weinre/](http://people.apache.org/~pmuellr/weinre/)
+   - see the [`update-latest.sh`](https://github.com/pmuellr/people.apache.org/blob/master/public_html/weinre/update-latest.sh)
+     file for an example of automating this
+
+- update npm
+   - run `cd weinre.build`
+   - run `npm publish`
+
 - update apache cms pages:
 
-   - not sure how to do this yet
+   - not ready for prime time
 
 - prepare for blessed Apache version
 
@@ -64,23 +76,35 @@ smoke test
 
 The smoke test involves testing the archives:
 
-- `weinre-doc.zip`
-- `weinre-node.zip`
+- `apache-cordova-weinre-{VERSION}-bin.{ARCHIVE}`
+- `apache-cordova-weinre-{VERSION}-doc.{ARCHIVE}`
+- `apache-cordova-weinre-{VERSION}-src.{ARCHIVE}`
+
+The archives are built via `ant build-archives` and are available
+in `weinre.build/out/archives`.
 
+smoke test - bin
+-------------------------------------------------------------------------------
+
+- unzip the `-bin` archive and `cd` into it
+- run `./weinre --help` make sure help works
+- run `weinre`
+- in your browser open the main page, eg [`http://localhost:8080`](http://localhost:8080)
+- poke around the demo, make sure it works
+- should add some variations on starting with used port, etc
 
 smoke test - doc
 -------------------------------------------------------------------------------
 
-- unzip `weinre-doc.zip`
+- unzip the `-doc` archive
 - browse all pages
 
-
-smoke test - node
+smoke test - src
 -------------------------------------------------------------------------------
 
-- unzip `weinre-node.zip`
-- make sure `build-info.txt` looks right
-- run `weinre --help` make sure help works
-- run `weinre` make sure help works
-- poke around the demo, make sure it works
-- should add some variations on starting with used port, etc
\ No newline at end of file
+- unzip the `-src` archive and `cd` into it
+- run `cd weinre.build`
+- run `cp sample.personal.properties personal.properties`
+- run `ant build-archives`
+- run the smoke test on the built archives, recursively
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/7f27d9a9/weinre.doc/Home.body.html
----------------------------------------------------------------------
diff --git a/weinre.doc/Home.body.html b/weinre.doc/Home.body.html
index c3cdae8..1edcae4 100644
--- a/weinre.doc/Home.body.html
+++ b/weinre.doc/Home.body.html
@@ -115,8 +115,8 @@ are listed below:
 
 <ul class="spaced">
 
-<li><span class="weinre">weinre</span> does not make use of any 'native' code,
-it's all JavaScript (and currently Java code for the 'server').
+<li><span class="weinre">weinre</span> does not make use of any 'native' code
+in the browser, it's all plain old boring JavaScript.
 
 <li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
 it's functionality is limited.  For instance, source level debug of JavaScript