Explain how to write docs for bundler.io

2 files changed, 15 insertions, 0 deletions

diff --git a/doc/documentation/README.md b/doc/documentation/README.md
index 43ca6f7587..bc2e1ceac6 100644
--- a/doc/documentation/README.md
+++ b/doc/documentation/README.md
@@ -27,3 +27,5 @@ Just like Bundler, we have a grand plan (really, a wish list of sorts) for Bundl
 ## Translations
 
 We don't currently have any translations, but please reach out to us if you would like to help get this going.
+
+Please feel free to reach out to [@arbonap](https://github.com/arbonap) if you'd like to help localize Bundler in Spanish.
diff --git a/doc/documentation/WRITING.md b/doc/documentation/WRITING.md
index bc678b7c55..e3acf5de48 100644
--- a/doc/documentation/WRITING.md
+++ b/doc/documentation/WRITING.md
@@ -52,3 +52,16 @@ We have tests for our documentation! The most important test file to run before
 $ bin/rspec ./spec/commands/help_spec.rb
 $ bin/rspec ./spec/quality_spec.rb
 ```
+
+# Writing docs for [the Bundler documentation site](bundler.io)
+
+If you'd like to submit a pull request for any of the primary commands or utilities on [the Bundler documentation site](bundler.io), please follow the instructions above for writing documentation for man pages from the `bundler/bundler` repository. They are the same in each case.
+
+Note: Editing `.ronn` files from the `bundler/bundler` repository for the primary commands and utilities documentation is all you need 🎉. There is no need to manually change anything in the `bundler/bundler-site` repository, because the man pages and the docs for primary commands and utilities on [the Bundler documentation site](bundler.io) are one in the same. They are generated automatically from the `bundler/bundler` repository's `.ronn` files from the `rake man/build` command. In other words, after updating `.ronn` file and running `rake man/build` in `bundler`, `.ronn` files map to the auto-generated files in the `source/man` directory of `bundler-site`.
+
+Additionally, if you'd like to add a guide or tutorial: in the `bundler/bundler-site` repository, go to `/bundler-site/source/current_version_of_bundler/guides` and add [a new Markdown file](https://guides.github.com/features/mastering-markdown/) (with an extension ending in `.md`). Be sure to correctly format the title of your new guide, like so:
+```
+---
+title: RubyGems.org SSL/TLS Troubleshooting Guide
+---
+```