pipey icon indicating copy to clipboard operation
pipey copied to clipboard

Needs api documentation

Open phenax opened this issue 7 years ago • 9 comments

The api is pretty simple but still a formal api documentation is required for the project explaining what the function does, it's example use cases and it's type signature. The documentation should be kept inside the /docs directory as markdown files.

phenax avatar Oct 27 '18 12:10 phenax

Hi I am a professional technical writer - can I contribute?

rjseymour66 avatar Nov 03 '18 04:11 rjseymour66

@rjseymour66. Definitely! If you have any questions regarding the specifics of the api, you can leave them on this thread.

phenax avatar Nov 03 '18 04:11 phenax

Are you using REST APIs? If so, I might be able to help. I would need to know the base path and endpoints. Also, a list of possible methods and parameters. And of course an API Key if one is required.

aredshaw avatar Dec 20 '18 18:12 aredshaw

@aredshaw, We're not using any REST APIs. Thanks for the offer tho!

phenax avatar Dec 21 '18 03:12 phenax

@phenax would it be a good idea to use gatsby? If so, I could've give it a try.

onluiz avatar Feb 15 '19 02:02 onluiz

@onluiz This library only needs 1 page of documentation so I feel like gatsby would be an overkill. Just one markdown file documenting the api signature and usage example.

phenax avatar Feb 16 '19 02:02 phenax

Hi there, I'm new to GitHub. While I've done aspects of technical writing in previous job roles, I'm now looking to get into technical writing professionally, which is why I'm trying to find open source RESTful API projects to help contribute documentation towards. I was wondering if you might have any issues that you may still need some help with?

Silks-road avatar Jun 26 '19 21:06 Silks-road

Looks like this is done, is it not? @phenax

mearns avatar Oct 02 '19 10:10 mearns

@mearns, @Silks-road, The docs have been added but improvements are always welcome. :smile:

phenax avatar Oct 02 '19 10:10 phenax