<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta content="text/html;charset=UTF-8" http-equiv="Content-Type"></head><body ><div style='font-size:10pt;font-family:Verdana,Arial,Helvetica,sans-serif;'>This is a great discussion.<br><br><div id="message"></div>Regarding Eliot's and Subbu's comments<br id="br3"><div id="signature"></div><div id="content"><br> ---- On Mon, 23 Mar 2020 01:23:33 -0400 <b> kksubbu.ml@gmail.com </b> wrote ----<br><br><blockquote style="border-left: 1px solid rgb(204, 204, 204); padding-left: 6px; margin-left: 5px;"><div>On 23/03/20 3:29 AM, Eliot Miranda wrote:<br>> What I think Subbu’s analysis and this scaling problem implies is<br>> that the Help Browser is a great central location to go to to find<br>> documentation, but the Help Browser will be better if it is able to<br>> display class comments and documentation methods as well as its own<br>> help pages.  My vote is to make the Help Browser multi-modal and<br>> about indexing tool for accessing help and documentation in as many<br>> turns as possible, including pointers to web pages and videos.<br><br><br><br>In short, help topics should be a live and direct view into the object <br>graph of both machine-readable code and human readable text so every <br>code is browsed within this larger context. This will reduce most of the <br>tedium of keeping code and doc in sync.<br><br>Regards .. Subbu</div><div><br></div><div><br></div><div>__------_-----------snip</div><div><br></div><div><br></div><div>In Seaside doc, I encabsulate a bit of knowkedge into Doclets .Doclets get their information from anywhere...class comment, Help page, Swiki page, (comments on topics like in stack exchange) and they live in image.</div><div><br></div><div>Collecting and storing them is easy,  Per Subbu's point, having them self organize is the key to creating the structures Tim listed in another thread.</div><div><br></div><div>The other very important principle is that they are displayable anywhere, and (ignoring security for now). Writable from any where.</div><div><br></div><div>I.e. an entry on the swiki becomes a docket in the system and is viewable in the Help Browser and visa versa.</div><div><br></div><div>Tl;dr....decouble the knowledge from the presentation, store it in image as its own system, ask it to organize it's doclets to organize themselves conceptually...i.e terse guide, book paragraph, design pattern...Subbu's and Tim's taxonomy.</div><div><br></div><div>Presentation and content creation become interface agnostic..Class comment, Help stuff, web based.</div><div><br></div><div><br></div><div>Cheers</div><div><br></div><div>Tty</div><div><br></div><div><br></div></blockquote></div></div><br></body></html>