I think perhaps a little background information about sidewiki might be
in order for anyone who hasn't used it. (I've only started using it the
past few days so I'm no expert!)
Sidewiki is a Google provided facility to post comments regarding
information on a webpage. As other people view the webpage, any entries
made can be viewed without leaving that page. The comments can be made
regarding the whole page or specific items within the page. As an
example I have posted a comment regarding the {OS.time} function in
'System Modules -> Os'.
Viewing the comments is easiest if the Google tollbar is installed
(currently the sidewiki part of google toolbar is available for Internet
Explorer and Firefox browsers). However, according to Google help, there
is a way to view posted articles using what they call a 'bookmarklet'
which avoids the necessity to install Google toolbar.
With the Google toolbar installed, a browser side bar opens whenever a
sidewiki entry is available to view (including a position marker if only
a specific section of the page is commented). Reading the entry simply
involves clicking on the marker.
Reading articles requires no special priviledges but posting new entries
requires at the least a Google sidewiki profile; this may involve an
actual google account being created but I don't suppose that forces
anyone to actually use it for anything else.
I haven't been able to test the 'bookmarklet' option but the toolbar
option seems to work perfectly. It would be good if someone could check
to see if the comment I made about {OS.time} appears properly on their
system.
Regards
Mark
Peter Van Roy wrote:
mark richardson wrote:
Hi everyone,
I hope this isn't going to spark a storm of controversy.
In the past, when I first started using Oz, one of the main problems
I had was with the documentation. Lets say some of it wasn't as clear
as it could be for 'newbies' and there was a lack of clear
'real-world' examples.
I know there's a few examples around if you look hard enough but I
still believe it would be beneficial for new users (and possibly more
experienced ones) to have examples/explanations available directly in
the Mozart documentation; particularly snippets from the user
archives to save searching the archives each time or having similar
questions asked repeatedly.
It's true that there is lots of material that could be helped with
examples. If someone could start up a sidewiki then we could all
pitch in and add things.
I have lots of examples floating around from my various courses that
use Oz. Sometimes they make it into a website but often they don't
(if you haven't seen it, check out the examples on
www.info.ucl.ac.be/~pvr/ds/mitbook.html, for example). A sidewiki
would be a way to capture them.
Peter
_________________________________________________________________________________
mozart-users mailing list
[email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users
_________________________________________________________________________________
mozart-users mailing list
[email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users
