thoughtworks / pacto

93%

master: 70%

LAST BUILD ON BRANCH readme_personified

branch: readme_personified

CHANGE BRANCH

x

Reset

• readme_personified
• avoid_generate
• better_header_validation_msgs
• builder
• clarify_how_to_run_single_tests
• class_cleanup
• cleanup
• cleanup_fixes
• colors
• contracts_for
• cops
• coverage
• coverage_fix
• deep_glob
• docco
• examples
• experimental
• expose_response
• faraday
• fix_138
• fix_issue_47
• fix_validation_rake_task
• forensics
• gem_updates
• generate_request
• generator_upgrade
• guidelines
• hashie
• http_method
• improve_body_only_validation_tests
• improve_logging
• issue25
• issue26
• issue32
• issue_58
• load_all
• location_header
• markdown_changelog
• master
• meta-validation
• middleware
• modes
• multi_json
• naming
• nested_resource
• new_readme
• new_stubbing_syntax
• no_tags
• override_body
• pacto-server
• pacto_generator
• polytrix
• recursive_locking_workaround
• reel
• refactor_header_validation
• refactor_processors
• relish
• remove_should_from_specs
• remove_stub_provider
• request_id_placeholders
• request_validation
• restore_contract_generation
• rspec_issue35
• rubcop_reactivation
• ruby_18_spike
• samples
• schema_uri
• schema_validation
• static_analysis
• stenographer
• swagger
• swagger_subclass
• tech_debt
• templating
• tokenization
• turn_contract_list_into_a_class
• uri_bug
• uri_templates
• v0.3.0
• v0.3.0.pre
• v0.3.0.rc
• v0.3.1
• v0.3.2
• v0.4.0.rc1
• v0.4.0.rc2
• v0.4.0_docs
• validate_without_stubbing
• validation
• validations
• windows

Build # 399

Build Type

push

travis-ci

Committed by maxlinc

Commit Message

Pacto personified

I rewrote the intro to Pacto with a central metaphor/personification: Pacto a a judge who arbitrates contract disputes.

I don't want to fall into a trap of writing "legalese" instead of simple English, but I think borrowing some real-world metaphors and terms like **clauses** or **breach of contract** could help clarify the components of Pacto - both for users and contributors.  I think we've spent too much time mixing up an actual request with a **request clause**, which describes the obligations a request must meet, but is not a valid request itself.

It's a bit long, and could use some images (I've been creating some for the site), but what do you think?

Run Details

747 of 799 relevant lines covered (93.49%)

19.51 hits per line