Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id DC379200CC2 for ; Tue, 20 Jun 2017 11:40:57 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id DADCA160BE1; Tue, 20 Jun 2017 09:40:57 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 3CFD1160BD3 for ; Tue, 20 Jun 2017 11:40:57 +0200 (CEST) Received: (qmail 97405 invoked by uid 500); 20 Jun 2017 09:40:56 -0000 Mailing-List: contact commits-help@brooklyn.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@brooklyn.apache.org Delivered-To: mailing list commits@brooklyn.apache.org Received: (qmail 97390 invoked by uid 99); 20 Jun 2017 09:40:56 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 20 Jun 2017 09:40:56 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 54D60DFA83; Tue, 20 Jun 2017 09:40:56 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: drigodwin@apache.org To: commits@brooklyn.apache.org Date: Tue, 20 Jun 2017 09:40:56 -0000 Message-Id: X-Mailer: ASF-Git Admin Mailer Subject: [1/3] brooklyn-docs git commit: minor tweaks to docs setup as i just did it on a new machine archived-at: Tue, 20 Jun 2017 09:40:58 -0000 Repository: brooklyn-docs Updated Branches: refs/heads/master b86635c2e -> 23c890191 minor tweaks to docs setup as i just did it on a new machine Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/28f91f5f Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/28f91f5f Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/28f91f5f Branch: refs/heads/master Commit: 28f91f5f1d71be3af8fc8856595f6eef5dee834b Parents: b86635c Author: Alex Heneveld Authored: Thu Apr 13 17:35:29 2017 +0100 Committer: Alex Heneveld Committed: Tue Jun 20 10:36:14 2017 +0100 ---------------------------------------------------------------------- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/28f91f5f/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index 21ab6a3..5e560a0 100644 --- a/README.md +++ b/README.md @@ -29,16 +29,16 @@ The Brooklyn documentation uses [Jekyll](https://jekyllrb.com/) to process the s This in turn requires Ruby and gems as described in the `Gemfile`: install [RVM](http://rvm.io/) to manage Ruby installations and sets of Ruby gems. - \curl -sSL https://get.rvm.io | bash -s stable + \curl -sSL https://get.rvm.io | bash -s stable --auto-dotfiles Close your shell session and start a new one, to get the new environment that RVM has configured. Change directory to the location where -you checked out your repository and then to the `docs/` subdirectory (where this file is located). +this project is (where this file is located). RVM should detect its configuration inside `Gemfile` and try to configure itself. Most likely it will report that the required version of Ruby is not installed, and it will show the command that you need to run to install the correct version. -Follow the instructions it shows. +Follow the instructions it shows, typically something like `rvm install ruby-2.1.2`. Once the correct version of Ruby is installed, change to your home directory and then change back (`cd ~ ; cd -`). @@ -50,7 +50,7 @@ at the correct versions: bundle install Any time you need to reset your Ruby environment for `jekyll` to run correctly, -return to the `_build` directory and re-run the above command. +go to this directory (or the `_build` subdir) and re-run the above command. On some platforms there may be some fiddling required before `jekyll` runs without errors, but the ecosystem is fairly mature and most problems can be resolved with a bit of googling. @@ -69,7 +69,7 @@ You can download it from [here](http://wkhtmltopdf.org/downloads.html) or use th Seeing the Website and Docs --------------------------- -To build and most of see the documentation, run this command in your `docs` folder: +To build and most of see the documentation, run this command in this folder: jekyll serve