Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updating Client and DataSet docs #410

Closed
wants to merge 9 commits into from
Closed

Updating Client and DataSet docs #410

wants to merge 9 commits into from

Conversation

amandarichardsonn
Copy link
Contributor

@amandarichardsonn amandarichardsonn commented Oct 9, 2023

This PR will merge edits to the SmartRedis Cray docs to make more clear the functionality between the DataSet API and the Client API

amandarichardsonn and others added 2 commits October 6, 2023 18:10
…cript_multiGPU (#407)

* pushing initial changes

* changes to func and tests

* updating changelog

* adding type check

* pushing for bills comments

* pushing revert to old test and adding multigpu t

* pushing bill chnages

* pushing 4 Bills review

* pushing for github actions

* pushing for pylint

* remove trailing white spaces

---------

Co-authored-by: Amanda Richardson <[email protected]>
Co-authored-by: Amanda Richardson <[email protected]>
@amandarichardsonn amandarichardsonn changed the title pushing intial changes Updating Client and DataSet docs Oct 9, 2023
@@ -2,22 +2,24 @@
Data Structures
***************

RedisAI defines three new data structures to be
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You could move those quick summaries of the client and dataset to the top of this file and then go into more detail below

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmmmm I could but then the client API definition would seem a little out of place I feel, what are your thoughts on me describing what a client is? somewhere else in the documentation... like under the smartredis tab?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but also this tab is discussing the data structures we offer and not about the API's

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but it def wouldnt hurt to have the api defs at the top here tbh - i can adapt it to be like data structures work with which api and if they r in mem or not - r these ds sent to the db or something like that, thoughts on that?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm. It sounds like what we really need is an API overview page that talks about what the individual pieces of the API are and then links to the pages for them. I can help you set that up

a PyDataset object
"""Initialize a Dataset object from a PyDataset object

Create a new Dataset object using the data and properties
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Keep text left-justified with block above

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tab tells the rst file to make an indent note, the have this format like below, thoughts?

Copy link
Contributor

@billschereriii billschereriii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally looking really good, thanks for going through and making these updates! Some changes noted, plus you'll need a changelog entry

billschereriii and others added 6 commits October 11, 2023 16:25
Add support for Multiple Databases in SmartRedis. This involves a Client class constructor update -- the type of database is now stored in an environment variable rather than being passed in to the Client constructor. The legacy constructor will remain supported for the short term but will be phased out in favor of the new constructor.
Updated all test cases and examples with the new Client class constructor.
Updated documentation.
[ committed by @billschereriii ]
[ reviewed by @ashao @MattToast ]
Run examples on commit to keep them fresh
[ committed by @billschereriii ]
[ reviewed by @ashao ]
* pushing PR up for review

* pushing edits to dataset name retrival

* pushing bill comments

* adding to docs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants