diff options
| -rw-r--r-- | doc/documentation/README.md | 2 | ||||
| -rw-r--r-- | doc/documentation/WRITING.md | 13 |
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 +--- +``` |