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

Document the ProductOpener::URL.pm module #3046

Merged
merged 3 commits into from
Mar 16, 2020

Conversation

areeshatariq
Copy link
Contributor

@areeshatariq areeshatariq commented Mar 16, 2020

Description:

Documentation of the ProductOpener::URL.pm module in perlpod format

Related issues and discussion:
fixes #3044
#2203


=head3 Arguments

A scalar variable needs to be passed as an argument.
Copy link
Contributor

@stephanegigandet stephanegigandet Mar 16, 2020

Choose a reason for hiding this comment

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

In addition to its type, we need to indicate was the argument is.

Suggested change
A scalar variable needs to be passed as an argument.
A scalar variable to indicate the subdomain (e.g. "us" or "static") needs to be passed as an argument.

Copy link
Contributor

Choose a reason for hiding this comment

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

Same for the other functions.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

Copy link
Contributor

@stephanegigandet stephanegigandet left a comment

Choose a reason for hiding this comment

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

Looks good, thank you!
For the functions argument, can you indicate that the argument is the subdomain?

@areeshatariq
Copy link
Contributor Author

@stephanegigandet I've made the suggested changes. Does it look fine now?

Copy link
Contributor

@stephanegigandet stephanegigandet left a comment

Choose a reason for hiding this comment

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

Looks great, thank you!

@stephanegigandet stephanegigandet merged commit d27cfca into openfoodfacts:master Mar 16, 2020
@teolemon teolemon added the 📚 Documentation Documentation issues improve the project for everyone. label Aug 27, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📚 Documentation Documentation issues improve the project for everyone.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document the ProductOpener::URL.pm module in perlpod format
3 participants