pact-foundation / pact.io

Pact Foundation Website
http://pact.io
Other
219 stars 92 forks source link

Getting started guides aren't very user friendly #42

Open TimothyJones opened 6 years ago

TimothyJones commented 6 years ago

Pact.io directs new users to the Readme pages of the various pact implementations. It would be an improvement to have step-by-step guides for getting started.

mboudreau commented 6 years ago

Agreed, when are you going to be done? :P

TimothyJones commented 6 years ago

Well, I can get started on the Javascript one when you merge the other PR ;)

Putting these issues in is at least half for me anyway - I don't want to forget things, and putting them on a public todo list seemed better than squirrelling them away in a notebook. Plus, I don't mind if someone else completes any documentation I was planning to do.

TimothyJones commented 6 years ago

PR #46 adds a quickstart guide for Javascript. If it's well received, I can do similar guides for the other languages and frameworks.

YOU54F commented 2 years ago

Totally agree here and want to get this addressed :)

Great work on the JS guide, I've only been able to see it via this PR as this is the current JS quickstart guide on the website.

I think we lost the changes somewhere in the website migration

https://github.com/pact-foundation/pact.io/blob/ce4b5cdccbc0ef5677469ec5068484ed679272c9/implementation_guides/javascript.md

the new location is here

Looking at the history

https://github.com/pact-foundation/docs.pact.io/commits/master/website/docs/implementation_guides/javascript.md

This older page was copied over https://github.com/pact-foundation/docs.pact.io/blob/55f3efaba63e9fbf3722b0950a5792521bd7ef8d/website/docs/implementation_guides/javascript.md

Which makes me wonder what else we missed out along the way 🤔

bethesque commented 2 years ago

Good find!

TimothyJones commented 2 years ago

There's quite a bit of documentation that I wrote that I can't find any more - I just thought it had been moved elsewhere, but maybe it was deleted.