From DANSE

Overall: use active voice, not the passive.

Introduction

• par 1: prose needs tightening: Eliminate every possible word.
  • s 1: What is a framework? This has a somewhat technical definition, and new users should know it. The definition will also help frame explanation at this stage. Replace "connects various components together" with "connects components": 'connects' implies 'together', 'various' adds nothing.
  • s2: 'manages' is the central action, not 'assumes': "Pyre manages the components, providing a uniform sequence of steps for instantiating and initializing components."

• p2 Passive voice everywhere!
  • s1 Huh?
  • s5 "primarily...conceptual"? Why not just state the major differences, and leave statements like this out? This and later statements seem to diminish the differences between applications and components. The differences should be emphasized so that beginners can choose the correct class for their needs.

Generating a Template Pyre Application

Generate an empty pyre application? Generate from a template? You're not generating the template--you're using the template to generate a fully functioning application.

Note that in pyre-0.8, "run" is renamed "main", "main" becomes "run". Also, by 0.8 (earlier I think), inventory is put at the top of the application--inventory is a component's (and thus an application's) primary public interface. --Tim 09:09, 28 Feb 2005 (PST)