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

uri: Updated documentation #10373

Merged
merged 13 commits into from
Jan 19, 2019
Merged

Conversation

ThomasTJdev
Copy link
Contributor

Updated documentation for uri module:

  • Intro text
  • Code samples
  • Runnable examples

refs #10330
CC @narimiran

lib/pure/uri.nim Outdated Show resolved Hide resolved
lib/pure/uri.nim Show resolved Hide resolved
lib/pure/uri.nim Outdated Show resolved Hide resolved
@narimiran narimiran self-assigned this Jan 19, 2019
@narimiran
Copy link
Member

Yesterday I removed the deprecated procs from this module — could you rebase your branch against the latest devel?

Copy link
Member

@narimiran narimiran left a comment

Choose a reason for hiding this comment

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

I know that some of things I mentioned are in the docs from before, but now is the perfect time to fix all those things.

lib/pure/uri.nim Outdated Show resolved Hide resolved
lib/pure/uri.nim Outdated Show resolved Hide resolved
lib/pure/uri.nim Outdated Show resolved Hide resolved
lib/pure/uri.nim Outdated
@@ -56,6 +85,10 @@ proc encodeUrl*(s: string, usePlus=true): string =
##
## As a special rule, when the value of ``usePlus`` is true,
## spaces are encoded as ``'+'`` instead of ``'%20'``.
Copy link
Member

Choose a reason for hiding this comment

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

General remark: I would love to see "See also:" section which will give links to similar procs. Some examples: strutils.indent, tables.getOrDefault, etc.

Here, specifically, a link to decodeUrl would be useful. (And vice-versa)

See if you can do the same for some other procs too.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ok? ba767c5

lib/pure/uri.nim Show resolved Hide resolved
lib/pure/uri.nim Outdated Show resolved Hide resolved
@narimiran narimiran merged commit bfeade9 into nim-lang:devel Jan 19, 2019
ThomasTJdev added a commit to ThomasTJdev/Nim that referenced this pull request Jan 27, 2019
@ThomasTJdev ThomasTJdev deleted the good-documentation-uri branch June 15, 2019 05:14
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.

4 participants