pact_broker icon indicating copy to clipboard operation
pact_broker copied to clipboard

Create generated documentation for the Pact Broker classes

Open bethesque opened this issue 3 years ago • 2 comments

RDoc would be the preference, unless there is a good reason to try something else.

http://rdoc.sourceforge.net/

bethesque avatar Nov 18 '21 06:11 bethesque

If you are looking for an alternative Yardoc is the one. It has blessing words from Mike Perham creator of sidekiq as well :D https://www.mikeperham.com/2010/12/16/using-rdoc/

In the meantime I'll look into generating the doco with RDoc.

I guess we would only want to generate RDoc for pact_broker/lib/pact_broker, wouldn't we?

bangn avatar Nov 18 '21 11:11 bangn

note the support for Markdown-formatted README files, which RDoc does not have

Having markdown would be great. I think it's worth looking at Yardoc then.

There are a few other modules in that top level, so I'd say pact_broker/lib/

bethesque avatar Nov 19 '21 00:11 bethesque