i050803a: Pattern Templates

Status	Date	Description




	2005-12-23	I noticed that I was afraid about setting down actual patterns. I need to conquer that. My first idea was to post some pattlets, any pattlets, to get going with it. I notice my angst is about having incomplete and unconnectedelements, although that doesn't dissuade me with InfoNotes, FAQtips and the like. I am concerned that I will be drawn into a bad distraction. Yet, when I notice patterns, my work is improved by it. I think the thing to do is start the catalog and make a couple of simple patterns, such as the ones around colophon and attribution. Anything, actually.
	2005-12-21	Appleton mentions patlets (no "tt") as proto-patterns but the Hillside group link on the topic doesn't seem to work.
	2005-12-21	In refactoring this folio, I have a classic configuration-management case around cross references and having sub-pages have their own "latest" as well as a version progression. In this case, i050803b is the master structure and the proper threading is an interesting problem. Any archive-package versions track the master versions. Notice the contrast with the approach used with the NuovoDoc /products and the separate document-engineering structures and professional-appearance (latest) versions.
	2005-12-21	There's a pattern followed in how versions of this material are developed. It is folio to capture basic material and vent as much as I like, then blog-post/thesis-section then back to the folio adjusted/refactored as needed, and maybe then around again. There is a logistic wrinkle to having tables, images, and other structural elements built in web pages first, then moving those results into blog pages (with links to images and other content) or documents (with links in the bibliographic citations, notes, and figures).
	2005-12-21	When version 0.50 is posted, scrape the completed work items into an archive of this page.
	2005-09-23	This pattern template coverage exhibits a number of patterns important for TROSTing. They can be tied in at some point.
	2005-09-23	Find trustworthiness materials that are useful to reference under considerations.
	2005-09-23	Check on some useful references to McConnell and maybe Sommerville too. Not sure about PMBOK, although some of it applies.
	2005-09-23	Include reference on risk management (e.g., in PMBOK3, p.237 - Chapter 11)
	2005-09-23	Reference Dijkstra on separation of concerns, related methodologies
	2005-09-23	The pattlet might be shown with nicer formatting, including a boxed archetype using the symbol for trust or some generic symbol about patterns. That would be fun. [dh:2005-12-21 The technique employing document engineering and the professional-appearance views may be applicable here too.]
	2005-09-23	The attribution pattern needs to be explained and referenced from i050803c attribution discussion
	2005-09-23	The version pattern needs to be explained and referenced from i050803c version discussion.
	2005-09-22	The summary/pattlet case should be illustrated as well. Maybe by pruning from Garfinkel. [dh:2005-12-21 I think I meant having exemplary instances, not the format, in this item.]
	2005-09-22	Examples of the kinds of things itemized in the format will be useful. These can be see-alsos to worked cases. That would be very useful.
	2005-09-21	Add the pattern terms into the glossary
	2005-08-22	I suppose there are record pattern or identify pattern or document pattern patterns. I would like to not go there at this point. [dh:2005-09-23 I am thinking of records management, identifiers and their management, etc.]
	2005-08-22	It looks like a pattern is a specialized InfoNote that has a pattern summary (the cover or the b-page?) and then has back-up pages that provide details on the various aspects, implementation sketches, examples, etc. Because there are pattern interdependencies, I need to figure out a structure that is a good carrier and that also allows patterns to be revised. Or, should this be like interface contracting where the next version is a different pattern (and then I get to worry about how they're identified). I tend to favor the progressive account of versions style, myself.
done	2005-12-22	Link to the blog post from the description see-also.
done 2005-12-22	2005-12-21	Post a version of the 0.50 overview with additional explanation and credit to Grady Booch for inspiring me to do this cleanup.
done 2005-12-22	2005-12-21	Indent the bibliographic citations on the Pattlet Template page.
done	2005-12-22	Put links to the respective templates under approach Tables 1-2.
done	2005-12-22	Add link in approach section A.3 to the Pattern Description Template.
not done	2005-12-21	Spell patlet without double-t. Why not patlette? Is it pattlet like applet? Maybe so.
done 0.50 2005-12-21	2005-09-25	Review the thesis version for improvements and corrections in the version here. Accumulate those changes as version 0.31 or later. [dh:2005-12-12 I am going to refactor to accommodate that, ending up with an 0.50.]
done 0.50	2005-12-21	Adjust i050803c to reflect edits and elevation to 0.50.
done 0.50	2005-12-21	Bring back the citation annotations on i050803f to i050803c.
done 0.50	2005-12-21	On the pattlet summary, restore the references and then annotate them more with regard to the points of citation in the format sections.
done 0.50	2005-12-21	Scrape the pattlet template onto a different page and tie it into 0.50.
done	2005-09-25	Start marking edited pages as part of the 0.31 inclusion of errata and improvements from the thesis version.
done	2005-09-25	Incorporate content from i050803d-e 0.30 into a thesis appendix.
done 2005-09-24	2005-09-23	i050803c errata: 7.0.4 is not anchored with a permalink.
done 2005-09-24	2005-09-23	i050803c errata: 5.7.1 correct reference to archetype is section 1.6, not 1.5.
done 2005-09-24	2005-09-23	i050803c errata: 1.5.1 ";" not "," needed between citations at end of the paragraph
done 2005-09-24	2005-09-23	i050803d errata: 5. In the TROST column, the prerequisite link goes to rationale instead.
done 0.30	2005-09-23	Update the site and proof-read what we have. [notes in notebook #47.104]
done 0.30	2005-09-23	Update the catalog entry to reflect the status of this material.
done 0.30	2005-09-23	Update i050803 to be more than a placeholder and publish that too.
done 0.30	2005-09-23	Settle on the overall name, tied to i050803e, as TROST Pattern Description Approach.
done 0.30	2005-09-23	i050803e: Give it a table of content and make a 3rd section be a link to the detailed pattern description template.
done 0.30 2005-09-23	2005-08-22	I want a format that has a summary that is a short page, like the ones in Garfinkel, and that are then expanded on supporting pages. The whole thing must be manageable and versioned as a folio. I must then deal with dependencies among these and on their elements from other elements.
done 0.30 2005-09-23	2005-08-22	I want something like "Based On" or history or background that is different than "References." It might be more "Related Patterns." [dh:2005-08-03 we're settling on the related patterns and also the alias, for now.]
done 0.30 2005-09-23	2005-08-20	There's a table of contents [needed] for all of this and also a pattern summary template, plus supporting material for a full pattern template. The table for the comparisons of different templates can go here too. [dh:2005-09-17 in i050803d]
done 0.30	2005-09-23	Put the i050803e 0.30 at the i050803b current-version slot, and it can carry links to the other material.
done 0.30	2005-09-23	Put in see-also and brief discussion at the top of i050803c 0.30.
done 0.30	2005-09-23	i050803e: provide statement of organization and relationship of pattlet to the full pattern description template.
done 0.30 2005-09-23	2005-09-21	Add i050803e with the summary/pattlet version of the pattern format. [dh:2005-09-23 clone i050803c 0.30 draft and turn it into the summary template.]
done 0.30	2005-09-23	Use i-accessions, not Q-accessions throughout.
done 0.30	2005-09-23	i050803d complete the see also entries.
done 0.30 2005-09-23	2005-09-22	Tie the i050803d 0.30 topics and subtopics for TROST to the point of coverage in i050803c 0.30.
done 0.30	2005-09-23	Attribution and comment about licensing under sources.
done 0.30 2005-09-23	2005-09-22	Put in where the concerns are to be balanced: Approach, Rationale, where? [dh:2005-09-23 put under rationale (brief) and consequences.
done 0.30	2005-09-21	Add Topical names for the TROST classifications in the i050803d comparison table, use "topic" where I used "category" before.
done 0.30	2005-09-21	Add permalinks to the comparison table
done 0.30 2005-09-21	2005-09-17	For context need "situation" as the category, for examples need something (#47.64) [dh:2005-09-21 chose "usage"].
done 0.30 2005-09-21	2005-09-17	i050803d errata: Put line break in between sources and references at the bottom [#47.64 dh:2005-09-21 I made source the category.]
done 2005-09-21	2005-09-17	Double check whether Hay's pattern discussion uses any particular pattern format [dh:2005-09-21 Only in the dead-crow forms. There is no structure for presentation of patterns themselves.
done	2005-09-21	Review Notebooks for additional material to cover here
done 0.30 2005-09-17	2005-08-22	I am getting screwed up around related patterns, context, and participants/subordinate/constituent patterns and how I put them in different places. Reconcile this before it gets messy to do. [dh:2005-09-23 this was handled by a careful splitting of them. We'll see how it goes.]
done 2005-09-17	2005-08-21	Cross-reference to the Pattern Resources i050808c page and capture anything else that is needed that isn't reflected in the table.
done 2005-09-17	2005-09-14	Connect to i050901: TROST Pattern Language too.
done	2005-09-17	Add something on the IBM Pattern Solutions work to the comparison table.
done	2005-09-16	Normalize for use in TROST Pattern Languages
done	2005-09-16	Add the Microsoft PatternShare and Enterprise Solution Patterns to the tables
done	2005-09-15	Add the Pattern Language for Pattern Formats to the comparison table
done	2005-08-22	Add "Core J2EE Patterns" next.
done	2005-08-21	On the d-page, start a table with resources used and begin with the Christopher Alexander and GoF formats. [dh:2005-08-21 I added Garfinkel right away]
done	2005-08-21	The <head> title of i050803c needs to be customized.
done	2005-08-21	Make a page for the feature comparison of pattern-language templates.
done 2005-08-21	2005-08-20	Customize page b and begin development on c, with any archive and progressive versioning later.
done 2005-08-20	2005-08-19	Create this page ready for recording Diary & Job Jar items of this InfoNote.