user_docs 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +26 -34
  3. data/lib/user_docs/version.rb +1 -1
  4. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f228c6cb3ca1e8592a67e4e0ee6dc8e6a209544606772749a246502176babe6c
4
- data.tar.gz: e4ba2e9cda4db54c58b119bcce3dcd10d8885c67e3b624d540b987b16464b0ac
3
+ metadata.gz: 849b042e18e7828b3c9ddfc27ed4e91c2dd27a173e340207f4c2cfe344945692
4
+ data.tar.gz: 1d66be1ffade7ce1df335826fe15af8c183c40bb8440bc3d7bb01903793c883f
5
5
  SHA512:
6
- metadata.gz: cb27d9911c94b771df7694184f2d15cd608deba4502e95b4691d6572367739112e982e63095367707fed1f14aa940b615dc50a31cc41532b4d8a263edaa75ef1
7
- data.tar.gz: 5dd84a8f0cd6fe49236d5af72fe7189a89cf7f11cec57486acc42d80bed7bf8ba18f729a3ec6ff3c6d8278a896358d48b45560ad55234c37d76591976d1c931f
6
+ metadata.gz: b522e44a349e0772df9f00455a7191315f245ab7499669ffd41de91565f55bbb25141b6cc584e44f7f0fd98c78ed19ad2556fa82a0a2b247f9389941e2fa2f66
7
+ data.tar.gz: 594b24f70aad792d1f0952fcc3a1f7e14b633d0661d9da9c39574d5c21f12d10be6274a9d17c3f24ac4fa90a3557d8df371ae951cfb2a65647feefb32618e663
data/README.md CHANGED
@@ -3,43 +3,35 @@ UserDocs is an semi-autonomous way to create end-user documentation for your Rai
3
3
 
4
4
  ## Installation
5
5
  0. Ensure you have the VERSION constant defined for your project.
6
- 1. Add this line to your application's Gemfile:
7
- ```ruby
8
- gem 'user_docs'
9
- ```
10
- And then execute:
11
- ```bash
12
- $ bundle
13
- ```
14
- 3. Install the required files:
15
- ```bash
16
- $ rails g user_docs:install
17
- ```
18
- 4. Include the UserDocs module in your system tests:
19
- ```ruby
20
- class ExampleTest < ApplicationSystemTestCase
21
- include UserDocs
22
-
23
- test "foo" do
24
- end
25
- end
26
- ```
27
- 5. Generate documentation by running your system tests:
28
- ```bash
29
- $ rails test:system
30
- ```
31
- 6. Push changes to master.
32
- 7. [Enable GitHub Pages docs folder.](https://help.github.com/en/articles/configuring-a-publishing-source-for-github-pages#publishing-your-github-pages-site-from-a-docs-folder-on-your-master-branch)
33
- 8. Your documentation should be viewable in the given url within a couple minutes.
6
+ 1. Add this line to your application's Gemfile: `gem 'user_docs'`
7
+ 2. And then execute: `bundle`
8
+ 3. Create procedures, for example: `/docs/feature_two_procedure.rb`
9
+
10
+ #!ruby
11
+ require_relative '../test/application_system_test_case.rb'
12
+
13
+ class FeatureOneProcedure < ApplicationSystemTestCase
14
+ include UserDocs
15
+
16
+ test 'action one' do
17
+ visit '/'
18
+ accept_alert
19
+ comment 'Hotel'
20
+ end
21
+ end
22
+
23
+ 4. Generate documentation by running your system tests: `rails user_docs:build_site`
24
+ 5. Documentation viewable at `/docs`
34
25
 
35
26
  ## Usage
36
27
  Here are the following methods you can use to create documentation:
37
- * `accept_alert`
38
- * `click_on`
39
- * `fill_in`
40
- * `choose`
41
- * `save_screenshot`
42
- * `comment`
28
+
29
+ * `accept_alert`
30
+ * `click_on`
31
+ * `fill_in`
32
+ * `choose`
33
+ * `save_screenshot`
34
+ * `comment`
43
35
 
44
36
  ## License
45
37
  The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module UserDocs
4
- VERSION = "0.7.0"
4
+ VERSION = "0.8.0"
5
5
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: user_docs
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.7.0
4
+ version: 0.8.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - jtopgi
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-05-28 00:00:00.000000000 Z
11
+ date: 2020-06-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: capybara