Return-Path: X-Original-To: apmail-cordova-commits-archive@www.apache.org Delivered-To: apmail-cordova-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 4D7B31847C for ; Sat, 29 Aug 2015 01:05:10 +0000 (UTC) Received: (qmail 96377 invoked by uid 500); 29 Aug 2015 01:05:10 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 96275 invoked by uid 500); 29 Aug 2015 01:05:10 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 96241 invoked by uid 99); 29 Aug 2015 01:05:10 -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; Sat, 29 Aug 2015 01:05:10 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id D6EEFE0985; Sat, 29 Aug 2015 01:05:09 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: dblotsky@apache.org To: commits@cordova.apache.org Date: Sat, 29 Aug 2015 01:05:12 -0000 Message-Id: <7081cdeac95344b3ad84d80c4e3a54ac@git.apache.org> In-Reply-To: <57080e40333544ad8ef196f6ead5a905@git.apache.org> References: <57080e40333544ad8ef196f6ead5a905@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [4/5] docs commit: Updating formatting Updating formatting Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/cd99fd80 Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/cd99fd80 Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/cd99fd80 Branch: refs/heads/cordova-website Commit: cd99fd809b8ac58ef5b4ee312decab43e133e673 Parents: 34d7e64 Author: Raghav Katyal Authored: Thu Aug 27 16:36:15 2015 -0700 Committer: Dmitry Blotsky Committed: Fri Aug 28 17:58:14 2015 -0700 ---------------------------------------------------------------------- README.md | 42 ++++++++---------------------------------- 1 file changed, 8 insertions(+), 34 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cd99fd80/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index f9a068b..033f57b 100644 --- a/README.md +++ b/README.md @@ -129,34 +129,26 @@ Ask for help on the IRC channel: #cordova on irc.freenode.net. Writing a Blog Post =================== - # Pull down the latest website codebase for the current posts +1. Pull down the latest website codebase for the current posts git pull - # Create a new entry in the www/_posts directory. +2. Create a new entry in the www/_posts directory. - # Use an earlier post an a template. Edit your md file to remove undesired markdown links. If there is a phrase in square brackets that isn't a CB-xxxx reference, escape it with backslashes. Otherwise, heruko might error out and fail to build all the html. +3. Use an earlier post an a template. Edit your md file to remove undesired markdown links. If there is a phrase in square brackets that isn't a CB-xxxx reference, escape it with backslashes. Otherwise, heruko might error out and fail to build all the html. [CB-1234] \[iOS\] \[Camera\] add a whizzbang to the snarfblat - # Set a marker where the summary on the home page should stop displaying. Add the following html comment line to your md file at the desired cutoff point: +4. Set a marker where the summary on the home page should stop displaying. Add the following html comment line to your md file at the desired cutoff point: - # In the front matter of your blog entry, set the `date:` field to the desired date that you want to appear near the title. Be aware that the date (explicit here or implied via the filename) will be used to generate the relative path to this html file (i.e., "/announcements/2014/09/22/cordova-361.html"), as will the `categories:` front matter value. +5. In the front matter of your blog entry, set the `date:` field to the desired date that you want to appear near the title. Be aware that the date (explicit here or implied via the filename) will be used to generate the relative path to this html file (i.e., "/announcements/2014/09/22/cordova-361.html"), as will the `categories:` front matter value. date: 2014-09-22 categories: releases - # Preview it locally by running the site using gulp +6. Run gulp link-bugs to linkify - # copy blog www/_posts directory + linkify - $ grunt updateBlog +7. Preview it locally by running the site using gulp - # preview it locally - cd .. - rake build - rake serve - - # add the full text of your new generate blog entry to svn - svn add public/announcements/2014/09/08/cordova-361.html - svn commit +8. Raise a Pull Request with the changes **Types of Posts** @@ -198,24 +190,6 @@ To print the list of plugin versions tested: 2. Run: for d in *-plugin-*; do ( cd $d && echo "* $(basename $PWD): $(grep version plugin.xml|grep -v encoding|cut -d'"' -f2)" ) ; done | grep '^\*' -**Getting Approval:** - -Each blog post must be approved by at least one committer other than yourself, and must be available for all to see before going live. To request a review: - -1. Run: `svn add www/_posts/your_post.md` -2. Run: `post-review` [download page](http://www.reviewboard.org/docs/rbtools/dev/) -3. Review it yourself, then click the `publish` button. -4. Wait for someone to approve it via the `Ship it` button. - -_Alternative steps (if post-review tool fails)_ - -1. From the root directory, run: `svn diff > new_post.diff` -2. Create a new request on http://reviews.apache.org. - a. Point it at your `new_post.diff` file - a. Set the directory to `/` - a. Add the group `cordova` - a. Click `publish` - [ruby_linux]: https://www.ruby-lang.org/en/documentation/installation/#package-management-systems [homebrew]: http://brew.sh/ [linux_node]: https://nodesource.com/blog/nodejs-v012-iojs-and-the-nodesource-linux-repositories#installing-node-js-v0-12 --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org For additional commands, e-mail: commits-help@cordova.apache.org