Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

releasing Rails no longer needs triggering docs generation by hand [c…

…i skip]

GitHub is now able to notify tag creation, I have configured the webhook
for the docs server to receive that event. Therefore, we no longer need
to trigger docs generation manually when releasing.
  • Loading branch information...
1 parent 2ec916b commit ba68e75a50eb6ed278fe3e165507d9bdeb1458c3 @fxn fxn committed
Showing with 0 additions and 36 deletions.
  1. +0 −31 RELEASING_RAILS.rdoc
  2. +0 −5 Rakefile
@@ -203,34 +203,3 @@ There are two simple steps for fixing the CI:
2. Fix it
Repeat these steps until the CI is green.
-=== Manually trigger docs generation
-We have a post-receive hook in GitHub that calls the docs server on pushes.
-It triggers generation and publication of edge docs, updates the contrib app,
-and generates and publishes stable docs if a new stable tag is detected.
-The hook unfortunately is not invoked by tag pushing, so once the new stable
-tag has been pushed to origin, please run
- rake publish_docs
-You should see something like this:
- Rails master hook tasks scheduled:
- * updates the local checkout
- * updates Rails Contributors
- * generates and publishes edge docs
- If a new stable tag is detected it also
- * generates and publishes stable docs
- This needs typically a few minutes.
-Note you do not need to specify the tag, the docs server figures it out.
-Also, don't worry if you call that multiple times or the hook is triggered
-again by some immediate regular push, if the scripts are running new calls
-are just queued (in a queue of size 1).
5 Rakefile
@@ -83,11 +83,6 @@ end
# * if there's a new stable tag, generates and publishes stable docs
# Everything is automated and you do NOT need to run this task normally.
-# We publish a new version by tagging, and pushing a tag does not trigger
-# that webhook. Stable docs would be updated by any subsequent regular
-# push, but if you want that to happen right away just run this.
desc 'Publishes docs, run this AFTER a new stable tag has been pushed'
task :publish_docs do'', 8080).start do |http|

0 comments on commit ba68e75

Please sign in to comment.
Something went wrong with that request. Please try again.