Frequently Asked Questions
What is a snippet?
What is the difference between tags and properties?
Tags are simple attributes of snippets, used to search for an exact match (or 'LIKE' behavior with jolly characters). Properties add scope to the features of the snippets, and the capability to search with '>' and '<' operators. In this way, a snippet with a property like "Windows Version = WindowsXP" will match the search "Windows Version < Windows7". You can also create your own properties, to expand the management capabilities of your basket of snippets!
What is a Group?
A Group is a set of users who can share snippets just among themselves. A snippet shared with a group is visible only by the members of this group. Users who join a group can be administrators or members. Snippets shared in the group can be edited only by administrators and by the creator of the snippet itself, while simple members may only view and comment. The purpose of the group designation is to preserve the knowledge of a team, without allowing strangers to put their hands on precious pearls of wisdom!
What is a Channel?
A Channel is a repository of public snippets linked together by a common topic. A user may follow a channel in order to be notified on the latest news about the topic. Anyone may create and administer a channel, maybe providing some special introduction as a description of the channel and related topic. This is the ideal place to gather the highest visibility for your coolest snippets!
How do I use the Visibility field?
The Visibility field determines who can see your snippet. There are 3 classes of visibility. "Only me" makes the snippet private for the creator, and nobody else will have access to it. "Everyone" exposes the snippet to the outside world, so anyone on the Internet will be able to see it. The other choices allow you to share the snippet with one of your groups; in this case, only members of this group will be able to access it (and only you and the group administrators will be able to edit it).
How can I share my snippets with my friends and colleagues?
You may share your snippets with a group of friends and/or colleagues from the Snippet View page: here, press the "SHARE" button and select one of your groups. If you don't have any groups, you may create your own and invite your friends to join it! In this way, only you and your group members will be able to see your shared snippets.
How can I make the world aware of my software knowledge?
Are you a software guru? Make the world a better place by posting your coolest snippets! First, publish your snippets on one or more channels: from the Snippet View page, press the "PUBLISH" button and select one or more channels where your snippet may be seen by tons of other developers. Then, you may achieve further visibility by posting your cool stuff onto social networks like Facebook, Twitter and LinkedIn: from the Snippet View Page, press one of the buttons near "Snippet Posting Options" and shareyour new rocking tweet, your best LinkedIn article, or your glorious Facebook post!
What are the most basic fields of a snippet?
At minimum, a snippet is defined by the title, the code content, and the visibility.
How can I make my snippet easier to retrieve?
Snip2Code search works with a pattern matching technique with respect to the tags, a full-text search with respect to the description of the snippet, and a proprietary algorithm applied to the properties. So, the best way to denote a snippet is to write a good description - just like the comments written on top of classes or public methods. Snip2Code automatically detects some properties and tags from the content and the title of the snippet, but no automatic discovery can replace your knowledge of the code. So, add the tags you think can best describe your snippet, and improve its semantic definition by adding other properties. In this way, your snippet will be very easy to find and will reflect exactly what you are searching for! No more hours spent in useless searches around dozens of forums!!