|
|
KNotations :: Documentation and development plans from the KnowNet development team
|
Weblog | 84 entries | 23-June-2006 | 1 authors |
|
|
Blog Entry | 0 replies8.43 Kb | 24-January-2005 | Mike Malloch |
Hmmm... the process of upgrading the SIGOSSEE site yesterday inspired (or threw up :o) ideas on many smallish issues which we might otherwise have put off until post-release. Here are some jottings of ideas that came to me overnight. I post them here, instead of to our firstClass documentation conferences, because I'm trying to get into the habit of blogging instead of conferencing for micro-documentation like this.
First off, note that some of the categories for this post have "kind=" prepended to them. This is my way of exploring the social and writing 'feel' of using multiple kinds of metadata for categorising entries and resources. In brief, I feel that my own blogging would be improved by being able to denote for a post not only what it is about, but what it is, what kind of communicative purpose it is intended for - eg whether I worked hard on this as considered prose, or spit it out as micro-documentation. There are many other reasons to want to allow multiple metadata schemata to be used (lord knows I've spent enough time in the dim past on this issue to recognise it :o), but at minimum it allows spontaneous writing while giving the reader a way to sort microdocumentation from serious writing. I've dumped the rest of this long message into the extended text for the entry... Extended text for this entry:Our current system for associating categories with objects in knotes is almost ready to handle this properly. And I have some tried and tested techniques for using SQL to efficiently but generally handle the management of assorted structured metadatas while keeping an efficient association of MD and items. This one we'll likely have to explore later, though, because there are so many user-interface difficulties in presenting that many choices to the user / tagger / searcher. I will want to do a simple exporation of the way we can represent this through the dumb old APIs though - thus we'll be trying to organise things for the API like this kind= gubbins which I hand-edited into my categories, but handling it programmatically in the web interfaces. The semantic terrain to try this on is the one we already treat programmatically - the different sources of categories ( my personal vs blog-specific shared vs site-wide shared (and, a bit later, other-users-added-in-this-blog). It would greatly clarify things to contributors if they could easily see where the different categoriescome from - for one thing it helps them see the communicative/marketing intent of the categories. Other smallish notions: Listings of external-link resourcesWe need a bit of SQL method to quickly fetch the external-link resources for a blog (or any path). This will be crucial when teams or projects are trying to collect shared bookmarks by blogging about external sites; without a quick way to scan the external links that have already been noted, this becomes impossible as soon as there are a couple dozen items in the blog. For now, the following will do:
Terser listings in blog aggregator views when N-items is 'large'Noted this above really - when displaying entries under a category for instance, the number of posts rendered can be large. Instead of handling these like current-posts view (show everything except extended text), show a terser display for each entry. This would also be a good option to have for user to choose for surrent posts - see more posts but less of each. See below for an idea for a sidebar where we could put a link for that option. It would be very nice if we could have an acquirable preference for this kind of thing: how big is 'N'? - how many entries does blog manager shown in current posts view? How many entries before terseness kicks in? Stats sidebar for blogs; stats summaries for Site Content listings of blogsAn easy bit of grinding really - when displaying links to weblogs in site content views, it would be very handy to show:
This would also make a useful sidebar in the blogs. In the case of authors and categories, the entry in the sidebar could be used as the UI affordance for getting interface for discussing categories or viewing author-information. A simple enough query can fetch this on the fly, but since the information will be needed in possibly frequently-hit site content, I suggest we keep this information in an efficient-to-fetch way, possibly adding columns and update-after methods Turning blog entries into organised site content Two bits of background:
In local server development, we've already begun adding features for moderators like 'summarise this thread', but much more needs to be done. In fast_folders on local server tests, it is very easy and convenient to do cut / paste, move-up etc gestures, but in the case of blog entries or discussion into site content, we'd also need to change the portal type of the new objects, etc. This is a biggish problem and will take a lot of experimenting to get right with end-users. Bit I predict that it will be one of our main efforts later this spring. Other questions include whether some kind of categorising might be co-optable into virtual content structures (like the Plone Topic way...) Controlling trackbacks with acquirable propertiesWe now have a checkbox in the TTW edit form for knlinks. Soon we'll pay attention to the API on this per-post pref. But we do not yet havea way to control whether trackbacks are attempted at a folder-level or blog-level. I noted in an extensive email last week why this is crucial for really 'private' weblogs or work areas. It occurred to me yesterday while working on the SIGOSSEE resource-collecting blog that this will also be very useful for non-private but in-development blogs and areas. The particular case I have in mind is as follows: SIGOSSEE's resource collecting weblog has a few dozens of items imported from the old plone links. We'll be training the members (ha!) to effect link-collection with blog entries now. Since I use ecto and have the ectoise bookmarklet ready in my browsers' bookmarks bar, I could very easily collect a few hundreds more in spare time. But I would definitely not want to swamp the existing entries with that lot; rather I'd want to keep them in a temporary blog of my own for illustration purposes, and then later move them into the real shared weblog. (By the way, here's another way that Zope/CMF?Plone pay off bigtime - you really can cut and paste blog entries between blogs). But the cut/paste entries approach falls doen where posting has implications beyond our system. IE trackbacks sent to remote sites. It would be great to be ble to extend the TB standard to allow retraction or moving of originating content, but til then the natural answer is to not try TB within the temporary blog. When pasted into the real blog, the pasted knlinks will generate their own trackbacks. So I want a way to at least set the default pref on entries in an acquirable way - and that has to apply to entries through the API. Well... enough of these notes... this blogging takes a lot longer than my old 'throw text into FC conferences' method :o( |