You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@whimsical.apache.org by cu...@apache.org on 2017/04/26 15:47:48 UTC
[whimsy] branch master updated: Minor doc clarifications
This is an automated email from the ASF dual-hosted git repository.
curcuru pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/whimsy.git
The following commit(s) were added to refs/heads/master by this push:
new 960e39a Minor doc clarifications
960e39a is described below
commit 960e39ae90bf75c84eeb7ec64890415666a65447
Author: Shane Curcuru <as...@shanecurcuru.org>
AuthorDate: Wed Apr 26 11:47:43 2017 -0400
Minor doc clarifications
---
DEVELOPMENT.md | 41 ++++++++++++++++++++++++-----------------
MACOSX.md | 2 ++
2 files changed, 26 insertions(+), 17 deletions(-)
diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index 6a25415..02cc993 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -7,13 +7,6 @@ testing, you will need access to a machine on which you are willing to install
libraries which do things like access LDAP, XML parsing, ASF Subversion repos,
composing mail and the like for full functionality.
-While some tools may work on Microsoft Windows, many don't currently.
-Alternatives include a Docker image, a custom Vagrant VM, and a Kitchen/Puppet
-managed Vagrant VM (as the live instance does). The primary advantage
-of using an image or a VM is isolation. The primary disadvantage is that
-you will need to install your SVN credentials there and arrange to either
-duplicate or mount needed SVN directories.
-
Contents :books:
-------
@@ -24,6 +17,7 @@ Contents :books:
- [Server Configuration](DEPLOYMENT.md)
- [Further Reading](#further-reading)
- [How To / FAQ](#how-to-faq)
+- [Running Whimsy on Windows](#whimsy-on-windows)
Architecture Overview
========
@@ -65,21 +59,21 @@ This section is for those desiring to run a whimsy tool on their own machine.
If you use a system provided version of Ruby, you may need to prefix
certain commands (like gem install) with `sudo`. Alternatives to using
the system provided version include using a Ruby version manager like
- rbenv or rvm. Rbenv generally requires you to be more aware of what you
- are doing (e.g., the need for shims). While rvm tends to be more of a set
- and forget operation, it tends to be more system intrusive (e.g. aliasing
- 'cd' in bash).
+ `rbenv` or `rvm`. Rbenv generally requires you to be more aware of what you
+ are doing (e.g., the need for rbenv shims). Rvm tends to be more of a set
+ and forget operation, but it tends to be more system intrusive (e.g. aliasing
+ 'cd' in bash). Note the Whimsy server currently uses **ruby 2.3+**.
For more information:
- 1. [Understanding Shims](https://github.com/sstephenson/rbenv#understanding-shims)
- 2. [Understanding Binstubs](https://github.com/sstephenson/rbenv/wiki/Understanding-binstubs)
- 3. [Ruby Version Manager](https://rvm.io/)
+ 1. [Understanding rbenv Shims](https://github.com/sstephenson/rbenv#understanding-shims)
+ 2. [Understanding rbenv Binstubs](https://github.com/sstephenson/rbenv/wiki/Understanding-binstubs)
+ 3. [Ruby Version Manager - rvmah](https://rvm.io/)
2. **Install ruby gems:** `whimsy-asf` and `bundler`:
- `gem install whimsy-asf bundler`
+ `gem install whimsy-asf bundler` (mail and listen may be needed too)
3. **SVN checkout ASF repositories** into (or linked to from)
`/srv/svn`
@@ -95,6 +89,7 @@ This section is for those desiring to run a whimsy tool on their own machine.
- /home/rubys/svn/committers
4. **Configure LDAP** servers and certificates:
+<a name="ldapconfig"> </a>
1. The model code determines what host and port to connect to by parsing
either `/etc/ldap/ldap.conf` or `/etc/openldap/ldap.conf` for a line that
@@ -131,7 +126,8 @@ This section is for those desiring to run a whimsy tool on their own machine.
`ruby examples/board.rb`
It should print out an HTML page with current board members.
- See comments in that file for running the script as a standalone server.
+ See comments in the `board.rb` file for running the script as a
+ standalone server to view in a local web browser.
6. **Configure mail sending** :mailbox_with_mail: (_optional_):
@@ -169,7 +165,8 @@ Running Whimsy Applications :car:
If there is a `Gemfile` in the directory containing the script or application
you wish to run, dependencies needed for execution can be installed using the
-command `bundle install`.
+command `bundle install`. Similarly, if starting from scratch you
+may need `gem install rake`.
1. CGI applications can be run from a command line, and produce output to
standard out. If you would prefer to see the output in a browser, you
@@ -256,6 +253,16 @@ class to access files from Subversion on the server, then check:
- Default SVN checkouts: [repository.yml](repository.yml)
+Whimsy On Windows
+=================
+
+While some tools may work on Microsoft Windows, many don't currently.
+Alternatives for Windows include a Docker image, a custom Vagrant VM, and a Kitchen/Puppet
+managed Vagrant VM (as the [live instance](DEPLOYMENT.md) does). The primary advantage
+of using an image or a VM is isolation. The primary disadvantage is that
+you will need to install your SVN credentials there and arrange to either
+duplicate or mount needed SVN directories.
+
Further Reading
===============
diff --git a/MACOSX.md b/MACOSX.md
index f802175..c39bb9f 100644
--- a/MACOSX.md
+++ b/MACOSX.md
@@ -5,6 +5,7 @@ Step by step instruction on getting a full whimsy test environment up and
running on Mac OS/X. Not all steps are required for every tool, but steps
common to many tools are included here, and additional steps required for
specific tools are linked at the bottom of these instructions.
+See Also the general DEVELOPMENT.md configuration notes.
Install Homebrew
----------------
@@ -132,6 +133,7 @@ cn: Sam Ruby
Notes:
+ * See DEVELOPMENT.md for more [LDAP configuration](DEVELOPMENT.md#ldapconfig).
* To pick up the latest code, the above needs to be run from the directory
you issued the `git clone` command. Alternately, provide the full path
to the `whimsy/lib` directory on the `ASF::LDAP.configure` command.
--
To stop receiving notification emails like this one, please contact
['"commits@whimsical.apache.org" <co...@whimsical.apache.org>'].
Re: [whimsy] branch master updated: Minor doc clarifications
Posted by sebb <se...@gmail.com>.
On 26 April 2017 at 16:47, <cu...@apache.org> wrote:
> This is an automated email from the ASF dual-hosted git repository.
>
> curcuru pushed a commit to branch master
> in repository https://gitbox.apache.org/repos/asf/whimsy.git
>
> The following commit(s) were added to refs/heads/master by this push:
> new 960e39a Minor doc clarifications
> 960e39a is described below
>
> commit 960e39ae90bf75c84eeb7ec64890415666a65447
> Author: Shane Curcuru <as...@shanecurcuru.org>
> AuthorDate: Wed Apr 26 11:47:43 2017 -0400
>
> Minor doc clarifications
> ---
...
> + 3. [Ruby Version Manager - rvmah](https://rvm.io/)
rvmah ??