ASPN ActiveState Programmer Network
ActiveState
/ Home / Perl / PHP / Python / Tcl / XSLT /
/ Safari / My ASPN /
Cookbooks | Documentation | Mailing Lists | Modules | News Feeds | Products | User Groups


Recent Messages
List Archives
About the List
List Leaders
Subscription Options

View Subscriptions
Help

View by Topic
ActiveState
.NET Framework
Open Source
Perl
PHP
Python
Tcl
Web Services
XML & XSLT

View by Category
Database
General
SOAP
System Administration
Tools
User Interfaces
Web Programming
XML Programming


MyASPN >> Mail Archive >> komodo-beta
komodo-beta
Re: [Komodo-beta] Changes to the Komodo User Guide
by Eric Promislow other posts by this author
Jun 25 2008 3:52PM messages near this date
view in the new Beta List Site
Re: [Komodo-beta] Changes to the Komodo User Guide | Re: [Komodo-beta] Changes to the Komodo User Guide
I think we could improve the usability of the TOC.  Can we add
a separate tab that sorts the top-level items by alphabetical order.
I'd also tweak the conceptual order of the top-level items, putting
"Find and Replace" after Editing, for example.

Can we map the current page back to the table of contents?  It's
hard to know where you are when you dive in via search.

- Eric

Troy Topnik wrote:
>  Now that Komodo 4.4 is out the door, I'll have a bit of time to focus on
>  larger-scale changes to the Komodo documentation (aka the Komodo User
>  Guide).
>  
>  I've had my head in the User Guide for so long now that I often don't
>  see the difficulties and annoyances that a new user might notice. So,
>  rather than just starting to rewrite and reorganize the parts that *I*
>  think need work, I thought I'd ask all of you what you think could be
>  done to make the documentation better.
>  
>  Here are a few things I have in mind:
>  
>    Some small tutorials on newer features like unit testing,
>    abbreviations, replace in files, change lists, etc.
>  
>    A couple of larger tutorials featuring a web frameworks. We've got
>    one for Rails, perhaps it's time for Drupal and Django tutorials?
>  
>    Reorganizing the table of contents (mostly to move some less important
>    items out of the very large top level) and moving some content to
>    more intuitive locations (preferences for a feature on the page that
>    describes the feature).
>  
>  Thoughts? Suggestions?
>  
>  
>  TT
>  
_______________________________________________
Komodo-beta mailing list
Komodo-beta@[...].com
http://listserv.ActiveState.com/mailman/listinfo/komodo-beta
Thread:
Troy Topnik
Sinner from the Prairy
Eric Promislow
Troy Topnik

Privacy Policy | Email Opt-out | Feedback | Syndication
© ActiveState Software Inc. All rights reserved