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

Improve docs part 2 #131

Merged
merged 4 commits into from
Jul 29, 2022
Merged

Improve docs part 2 #131

merged 4 commits into from
Jul 29, 2022

Conversation

aboedo
Copy link
Member

@aboedo aboedo commented Jul 27, 2022

Part 2 of adding docstrings to public methods in the Purchases class.

Public members of other public classes don't have docstrings yet, but I might add them later on after having released this.

@aboedo aboedo requested a review from a team July 27, 2022 20:26
@aboedo aboedo self-assigned this Jul 27, 2022
@aboedo aboedo marked this pull request as ready for review July 27, 2022 20:26
Comment on lines -11 to -15
public delegate void LogInFunc(CustomerInfo customerInfo, bool created, Error error);

public delegate void GetOfferingsFunc(Offerings offerings, Error error);

public delegate void CheckTrialOrIntroductoryPriceEligibilityFunc(Dictionary<string, IntroEligibility> products);
Copy link
Member Author

Choose a reason for hiding this comment

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

I moved these closer to where they're actually used, so it's much easier to understand what they actually do

Comment on lines +692 to +699
/// <summary>
/// Subscriber attributes are useful for storing additional, structured information on a user.
/// Since attributes are writable using a public key they should not be used for
/// managing secure or sensitive information such as subscription status, coins, etc.
/// </summary>
///
/// <remarks>Key names starting with "$" are reserved names used by RevenueCat. For a full list of key
/// restrictions refer [to our guide](https://docs.revenuecat.com/docs/subscriber-attributes)
Copy link
Member Author

Choose a reason for hiding this comment

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

most of these docstrings are adapted from iOS

@aboedo aboedo mentioned this pull request Jul 27, 2022
Base automatically changed from improve_docs to main July 29, 2022 15:17
@aboedo
Copy link
Member Author

aboedo commented Jul 29, 2022

@RevenueCat/core-sdk bump

@aboedo aboedo mentioned this pull request Jul 29, 2022
Copy link
Contributor

@taquitos taquitos left a comment

Choose a reason for hiding this comment

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

One tiny change, but then 📖🖋️🐐
image

/// </remarks>
///
/// <param name="products"> The <see cref="StoreProduct"/> for which you want to compute eligibility.</param>
/// <param name="callback"> The <see cref="CheckTrialOrIntroductoryPriceEligibilityCallback"/> callback. </param>
Copy link
Contributor

Choose a reason for hiding this comment

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

CheckTrialOrIntroductoryPriceEligibilityCallback -> CheckTrialOrIntroductoryPriceEligibilityFunc

Copy link
Member Author

Choose a reason for hiding this comment

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

great catch, thanks!!

@aboedo aboedo merged commit b13ac2d into main Jul 29, 2022
@aboedo aboedo deleted the improve_docs_part_2 branch July 29, 2022 17:47
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