[hand with pencil]
2004 Summer Tour
About
Blog
Class Stuff
Email Me
Events
Gallery
Home
Info Ark
Products
In The Press
Newsletter
Services
Smalltalk
Veggie Van Gogh

Credits
© 2002,
Bytesmiths

[this is simply a banner and menu bar]

Please patronize sponsors of this page!

Bytesmiths no longer is involved in software consulting. Maintenance of this web site is currently subsidised by unrelated business activities. Please pass the word to other interested folks, so I can continue to host this page!
  • Bytesmiths Editions -- large, archival, fine-art photography on unusual materials
  • Bytesmiths Press -- artists' services: web design/hosting, jury slides, giclee reproductions, opening announcements, brochures, etc.
  • Champagne Beadworks -- handcrafted jewelry and beadwork
  • Crafted By Carol -- handcrafted jewelry and beadwork
  • EcoReality, an organization devoted to establishing a sustainable ecovillage
  • Ecovillage Newsletter -- Diana Leafe Christian's news of her travels.
  • Gemini Gypsy -- Carole Good-Hanson's fused glass frames
  • Green Chipper -- light forestry and environmental services.
  • Salt Spring Island Society for Community Education -- community education on our island of 10,000.
  • Veggie Van Gogh -- two artists' mobile warehouse and living quarters, petroleum-free!
  • Veggiemog -- life and times of Kelly O'Toole's Unimog, running on biodiesel
    Your site could be listed here, for as little as $12 per month! Go to Bytesmiths Press for details.

    This site has been selected by PC Webopaedia as one of the best on this topic!
    This site has been awarded a Links2Go Key Resource Award in the Smalltalk category!

    More about ...

    SmallDoc™

     

    We've found the "public/private" facility of ENVY to be somewhat limited, and have developed a simple facility for explicitly declaring inter-module interfaces. Only the class/selector is declared; the commentary is automatically pulled from the named method.

    Picture of External Interfaces Browser

    External Interfaces Browser

    Our External Interfaces Browser provides access to this facility, which is easily "rolled up" into a document via hyper-link. The highlighted link in the application comment in the Library Browser shown above would insert in its place when the documentation is "expanded or linearized", all of the methods and their comments that are not italicized in the Methods list of the browser to the left.

    All the facilities of SmallDoc are available via customizable templates at the app/subapp, class, and class extension level. A typical template contains numerous hyper links to documentation components, that when expanded, recursively "rolls up" the hyper links to show a linearized version for printing or browsing.

     

    Picture of Class Browser

    Class Browser showing comment template

    Picture of paste back window

    Paste Back Window

     

    The result of clicking on the highlighted link in the class comment template above is the opening of the template-support window to the left.

    We call this window a "paste back" because that is what happens when the writer accepts the text in the window.

    We also provide an automated template for producing release notes. This cannot, of course, describe the changes, but it does ensure that all differences between any two app/subapp editions are captured for proper documentation.

    Picture of Release Notes window

    Draft Release Notes Window

    This is but a sampling of some of the more salient bits of SmallDoc. SmallDoc is highly customizable, so contact us about your needs!


:::: 2152 Fulford-Ganges Road, Salt Spring Island, British Columbia, V8K 1Z7, Canada (map), +1 250.653.2024 ::::