Linda icon indicating copy to clipboard operation
Linda copied to clipboard

Add examples to documentation

Open NullSense opened this issue 6 years ago • 6 comments

Examples need to be added to the public items as per Rust documentation guidelines.

NullSense avatar Oct 18 '19 16:10 NullSense

I want to contribute to the repo. Please discuss the details of the issue. Thanks

Rajratnpranesh avatar Oct 18 '19 23:10 Rajratnpranesh

@Rajratnpranesh Thanks for taking up this issue, basically examples of how to use public API functions need to be added to the documentation. The Rust documentation guidelines are a good place to start, you might also want to take a look at other crates, e.g. the http crate request.rs docs.

NullSense avatar Oct 19 '19 09:10 NullSense

@NullSense Can it be any API function that can be used as an example?

Rajratnpranesh avatar Oct 20 '19 06:10 Rajratnpranesh

Yes, there's only a few public ones, feel free to document all of them if you like.

NullSense avatar Oct 20 '19 08:10 NullSense

@NullSense I made a pull request to add API_Documentation.md. Please have a look. I talked about calling GitHub Public API.

Rajratnpranesh avatar Oct 20 '19 14:10 Rajratnpranesh

@Rajratnpranesh Sorry if I didn't make the issue clear, but by documentation of the public facing API, I meant documentation for the Linda project itself not GitHub.

NullSense avatar Oct 20 '19 15:10 NullSense