summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPatricia Arbona <arbonap@gmail.com>2017-08-10 15:03:30 -0700
committerPatricia Arbona <arbonap@gmail.com>2017-08-10 15:52:55 -0700
commit833350fa0d2458884fc9e53f8e93f9752b89f431 (patch)
treef0cfc686796111702bb8b237c3f51527123fb842 /doc
parent5f5a2f77f305655a1703b63df9cfebb8c3863670 (diff)
downloadbundler-833350fa0d2458884fc9e53f8e93f9752b89f431.tar.gz
Explain how to write docs for bundler.io
Diffstat (limited to 'doc')
-rw-r--r--doc/documentation/README.md2
-rw-r--r--doc/documentation/WRITING.md13
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
+---
+```