Simple Solutions to Complex Problems
  • Simple Solutions
    • Documents Live Once
    • Good JIgs
    • Polya and Friends
  • Long Term Relations
    • Customers & Projects >
      • APU OverView >
        • APU Early Years
        • APU Middle Years
        • APU Late Years
      • AQMD >
        • DataGeneral v Hewlett Packard
      • Big Lots
      • The Federate Group >
        • Stabilizing the System
        • The Cash Register System
        • Later Projects
      • Munson Management Systems
      • National Electronics
      • Richey Electronics
      • Sierra Pacific Investments
      • Other Customers
  • Diagonal Method
    • D2-M2 >
      • Diagonal differs from Agile
      • Maintenance Projects
      • Manufacturing Projects
      • Research Projects
    • Data Structures >
      • Data Levels
      • Data Logging
      • Data Merging
      • Data Input Buffers
      • Data Sorting
      • Data Deltas
    • Readable Source Code >
      • Readable Code Modifications
      • Readable Paradigms
      • Readable Style
    • Critical Path Method >
      • CPM Data Tasks
      • CPM Menu and Security
      • CPM External Tasks
      • CPM: Early Calculations
      • CMP Stem to Stern >
        • Work Units
    • Semi-Interpretive Mindset >
      • Simple Semi-Interpretive Case Study 1
      • Semi-Interpretive Case Study 1 -- Semesters 2 and 3
      • More Thorough and Efficient
      • Software Research Northwest
    • Semi-Interpretive Methods
    • Concepts and Practices >
      • Data Changes
      • Data Stacks
      • Data Tokens and Loose Linking
    • Diagrams & Examples >
      • Venn Diagrams
      • Music Score as a Diagram
      • Cause & Effect Diagrams
    • Dictionary and Lexicon
  • Programmers
    • Tools and Languages >
      • python considerations
      • program names, like sa5comm
    • Perspectives of a Manager
    • ToDo
    • HTML testing
    • Private Thoughts
    • Leads
  • Contact Pilgrim
    • Land of the Free
    • Pilgrim Legal Status
    • Index to Pages
  • New Page
  • Stonehenge Simply Done
Complicated: Having asked two girls to the Senior Prom and both say yes.
Complicated: dealing with IRS regulations where the agents disagree
Complicated
: Having a user who wants every screen to function with only one button

Complex: intricate, step-by-step procedures
Complex: the design of the human eye.

Words and more words; little marks on screens that convey sound and meaning.

Consistency, Reward on Investment, Sufficiency, Completeness

CMP

This very valuable technique yields so many good results
Arrow -- precedence
Box -- a task
Task -- some definable chunk of work
Stem -- the very beginning
Stern -- the final ending

Dictionary
The meanings of words and phrases
The correct manner for expressing certain ideas
Phrases to avoid

Diction
Using the correct word in the correct place.

Example
Calculations described in words often benefit from specific examples

Specifications for programs benefit from examples in source code

Specifications for outputs benefit from examples.  Even when the examples result from MS-Word, the example can clarify details.The word prototype might describe such an example.



Lexicon
The general style of programs should follow predictable patterns.  The manager or the director or his appointee should maintain the lexicon.  While many people have preferences and notions about styles and standards, only a few have the gift.  Decisions about the lexicon should involve include suggestions from the entire programming staff, and yet the gifted ones should make the decisions. 




Language Standards
Programs
..declarations
..error trapping
..logic
..nesting
..remarks
Jobs
Records
Files
Security


Documentation Standards

Non-ambiguous Verbs

Nouns with examples or diagrams.  Microsoft has become better about naming icons and widget; specifically, they have begun including more annoted screen shots.

Phrases to Avoid

PCC 1982 - 2014