user_docs 0.7.0 → 0.8.0

Sign up to get free protection for your applications and to get access to all the features.
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