What are best practices for a bookmarklet? [closed]

Question

I'm creating a social sharing bookmarklet and button that lets users share a link along with an optional text.

What structure is more recommended to use?

this:

http://www.example.com/?share=http://www.example.net&text=hello

or with a folder:

http://www.example.com/share/?url=http://www.example.net&text=hello

(Or a completely different one?)

Answer 1

I personally think that using share as a variable in the URL describes the nature of the link more readily instead of a "folder" called share.

http://www.example.com/?share=http://www.example.net&text=hello

It explicitly implies that the URL following "share=" is the URL being shared as opposed to:

http://www.example.com/share/?url=http://www.example.net&text=hello

which doesn't imply the intended action as well. I also like Kayo's version, it makes for a more descriptive URL while defeating the arbitrary nature of having share as a "folder".

Answer 2

I don't know why the '/share/' sub-directory would be needed. Perhaps be more explicit in your variable names.

http://www.example.com/?shareURL=http://www.example.net&shareText=hello