Changes between Version 15 and Version 16 of Internal/Rbac/OrbitRbacDesign/DesignByWiki

Timestamp:

Oct 10, 2006, 8:30:43 PM (18 years ago)

Author:

anonymous

Comment:

—

Internal/Rbac/OrbitRbacDesign/DesignByWiki

@@ -3 +3 @@
 Wiki pages like these constitute documentation of a work in progress.  In the early stages, the wiki pages may well constitute all the work of a project.  Although it is relatively easy to enter text and create links in a wiki, the first barrier in using one for a large project is determining how to structure the wiki pages to hold the work, i.e., breaking the on-going work into screen size chunks.  Structure matters because wiki page references and links encode the path to them. 
 
-In the initial research phase, it would be nice to build up a list of references where one could click on them to go to an associated pdf.  These references could later be used in bibliographies for papers written about the project.  Wikis do not have the equivalent of BibTeX or Endnote.  Using LaTeX and BibTeX and converting the .bbl intermediate file to a list of wiki references may be done with a Perl program bbl2wiki.pl in /home/hedinger/rbacrefs.  The mkltx.sh shell script there will automatically open the wiki file with Kwrite with an encoding of utf8 to allow lines including Unicode characters to be cut from it and pasted into Trac wiki pages that use utf8 coding internally. 
+In the initial research phase, it is useful to build up a list of references within which one can click to go to an associated pdf.  These references could later be used in bibliographies of reports or papers written about the project.  Wikis do not have the equivalent of BibTeX or Endnote.  Using LaTeX and BibTeX and converting the .bbl intermediate file to a list of wiki references may be done with a Perl program bbl2wiki.pl in /home/hedinger/rbacrefs.  The mkltx.sh shell script there will automatically open the wiki file with Kwrite with an encoding of utf8 to allow lines including Unicode characters to be cut from it and pasted into Trac wiki pages (that use utf8 coding internally). 
 
 Because this work is on an internal wiki page, the numerous PDF files accumulated while researching RBAC might be placed on an internal ftp server to make it easier to click through to access each one without the intervening "HTML preview not available" page when linking to attachments.  Also, lots of attachments clutter the page.
@@ -9 +9 @@
 It seems that only the Trac administrator can remove a Trac attachment.  This raises the cost of playing around with where to put such attachments for references.
 
-How does a group of people review a design in wiki format?  Wiki pages do not print very nicely so that they may be reviewed in hardcopy form in a traditional meeting.
+How does a group of people review a design in wiki format?  Wiki pages do not print very nicely so that they may be reviewed in hardcopy form in a traditional meeting, and it seems a mistake to reformat wiki text with Word.
 
 An incidental problem with a wiki or any hypertext document is that although it should be relatively easy to browse through one they are unlike a book that one can quickly flip through.  Access to each page in a wiki requires a conscious click, and, if one erroneously assumes that one already knows or has already seen what is behind that door, one may well miss lots of information.