Product Template: Difference between revisions

From Open Source Ecology
Jump to navigation Jump to search
No edit summary
(Attempt at complete instructions for documenting tools - please improve!)
Line 5: Line 5:
This can be used for any of the tools; just insert the name of the tool in place of 'CEB Press' and the software will generate the rest of it based on [[Template:ToolTemplate|this]].
This can be used for any of the tools; just insert the name of the tool in place of 'CEB Press' and the software will generate the rest of it based on [[Template:ToolTemplate|this]].


This template generates links the following pages. We will have to gather the information on each tool under the following standard page titles:
This template generates links to the following pages. All information on the tools should be put on the wiki under the following standard page titles:


Bold links to:
*'''ToolName Intro'''. This should assume the reader has no prior knowledge and explain -
#What the machine does. The very first sentence of the Intro page should be a one sentence description of the machine in plain English. e.g. "The Liberator is a machine that makes building blocks out of soil", "RepRap is a 3D printer; it can make plastic objects of any chosen shape."
##Problem Statement. Explain the advantages of this sort of technology. Why did we want to build it? What issue the tool is aiming to address e.g. "building a low-cost, high performance CEB press at $3k in materials, where the competition charges $45k for the finished product, to increase access to this environmentally-friendly, low-cost, and high performance building method"
#Design Rationale
##Give a simplified description of how it works. This should usually include a conceptual diagram and/or a conceptual video. (A more detailed description will be given in the Build Instructions, but if the reader gets an entry-level description here, it will be easier to understand the more detailed description later.)
##explain design choices that were made based on [[OSE Specifications]]
#Video and/or photos of the machine in action, plus other interesting footage directly from the project
#Product Ecology - how the tool fits with the other tools of the GVCS; see [[Product Ecologies]]
#Specifications, displayed alongside specifications for a similar commercial machine
#Costs, displayed alongside costs for a similar commercial machine. Include maintenance and running costs where applicable


*'''ToolName Development'''. See [[GVCS Development Template]]
*'''ToolName Development'''. We need to figure out a system of version control. Possibly a graphic indicating prototype number, a chart or number showing the stage of the [[GVCS Development Template]]. Maybe display this as a progress bar [http://labs.nortd.com/images/lasersaur-progress.png like the Lasersaur open development site]. When a tool is in an development stage, this page should be updated frequently and kept up-to-date.
**When a tool is in an development stage, this page should be updated frequently and kept up-to-date  
***progress report
***progress report
***list of unanswered questions
***list of unanswered questions
***current tasks
***current tasks
*'''ToolName Build Instructions'''. See [[Instructional Page Template]]
**funding situation
*'''ToolName user's manual'''.  See [[User Manual Page Template]]
**expected date of completion
 
*'''ToolName Build Instructions'''.  
 
**Instructional Video (A to Z on the fabrication)
Followed by:
**Instructional text and photos (A to Z on the fabrication). This is the same information as in the video, but some people might prefer step-by-step photos (for example, in developing countries where they don't have the bandwidth to stream video)
 
**Augmented Reality instructional material - this is not a necessity, but it is the next generation level of documentation which would allow for rapid teaching of fabrication
*'''ToolName Intro'''. Can include problem statement, design rationale, maybe a video or photos showing the machine in action. It should familiarize newcomers with the machine's abilities. We can include a comparison to existing commercial models here too. (It's impossible to have a separate page for each of these, because it would make the navigation box way too noisy.)
**3D model and CAD file
*Product Icon - icons from Isaiah on blue background such as [[Image:tractorblue.png|100px]]. Entire set will be put up at the [[Product Ecologies]] page
**2D fabrication drawings (metal)
*Status Headline - graphic indicating prototype number, step of completion from the [[Product Development Template]], funding, expected date of completion.  Status Chart (references development template), and refers to [[Master Index]] for overview
**2d Exploded Part Diagram
*Problem Statement - what issue the development of the GVCS tool is aiming to address - such as ''building a low-cost, high performance CEB press at $3k in materials, where the competition charges $45k for the finished product, as a means to increasing access to this environmentally-friendly, low-cost, and high performance building method''
**Machine-readable CAM files
*Performance Analysis vs. Industry Standards (data viz) - list our specifications compared to those of off-shelf counterparts
**Circuit design file to build circuit boards, wiring diagram
*Cost Analysis vs. Industry Standards
**Computer Software Control Code for Automated Devices
*Conceptual Diagram - how does the tool work? Entry-level explanation using quality information architecture
**Hydraulic Circuit Diagram
*Design Rationale - key design features that explain design choices related that were made based on [[OSE Specifications]]
**Calculations (for scaling purposes)
*Product Ecology - how the tool fits with the other tools of the GVCS; see [[Product Ecologies]]
*'''ToolName user's manual'''.
*Demo Video - video documentation taken from the actual build or testing of the device, plus other interesting footage directly from the project
**Operation Procedures
*Demo Photos
**Safety
*'''ToolName Bill of Materials'''.
**Maintenance
**Repair
**Troubleshooting
*'''ToolName Bill of Materials'''. Weblinks to suggested sources. Prices.
*'''Buy ToolName'''. This will raise funds for OSE. We can sell both kits and finished devices. This should be used only for tools with [[Full Product Release]] status.
*'''Buy ToolName'''. This will raise funds for OSE. We can sell both kits and finished devices. This should be used only for tools with [[Full Product Release]] status.
 
*'''ToolNameicon.jpg''' - icons from Isaiah on blue background such as [[Image:tractorblue.png|100px]]. Entire set will be put up at the [[Product Ecologies]] page. Make sure to upload icons as files with names of the format "ToolNameicon.jpg". It won't work if you name it something else, like "ToolName Icon.jpg", "Icon for ToolName.jpg" etc.




[[Category:Standards]][[Category:Templates]]
[[Category:Standards]][[Category:Templates]]

Revision as of 23:19, 20 March 2011


CEB Press
   Home  |  Research & Development  |  Bill of Materials  |  Manufacturing Instructions  |  User's Manual  |  User Reviews    CEB Press.png


You can insert a box like the one above by typing: {{ToolTemplate|ToolName=CEB Press}}

This can be used for any of the tools; just insert the name of the tool in place of 'CEB Press' and the software will generate the rest of it based on this.

This template generates links to the following pages. All information on the tools should be put on the wiki under the following standard page titles:

  • ToolName Intro. This should assume the reader has no prior knowledge and explain -
  1. What the machine does. The very first sentence of the Intro page should be a one sentence description of the machine in plain English. e.g. "The Liberator is a machine that makes building blocks out of soil", "RepRap is a 3D printer; it can make plastic objects of any chosen shape."
    1. Problem Statement. Explain the advantages of this sort of technology. Why did we want to build it? What issue the tool is aiming to address e.g. "building a low-cost, high performance CEB press at $3k in materials, where the competition charges $45k for the finished product, to increase access to this environmentally-friendly, low-cost, and high performance building method"
  2. Design Rationale
    1. Give a simplified description of how it works. This should usually include a conceptual diagram and/or a conceptual video. (A more detailed description will be given in the Build Instructions, but if the reader gets an entry-level description here, it will be easier to understand the more detailed description later.)
    2. explain design choices that were made based on OSE Specifications
  3. Video and/or photos of the machine in action, plus other interesting footage directly from the project
  4. Product Ecology - how the tool fits with the other tools of the GVCS; see Product Ecologies
  5. Specifications, displayed alongside specifications for a similar commercial machine
  6. Costs, displayed alongside costs for a similar commercial machine. Include maintenance and running costs where applicable
  • ToolName Development. We need to figure out a system of version control. Possibly a graphic indicating prototype number, a chart or number showing the stage of the GVCS Development Template. Maybe display this as a progress bar like the Lasersaur open development site. When a tool is in an development stage, this page should be updated frequently and kept up-to-date.
      • progress report
      • list of unanswered questions
      • current tasks
    • funding situation
    • expected date of completion
  • ToolName Build Instructions.
    • Instructional Video (A to Z on the fabrication)
    • Instructional text and photos (A to Z on the fabrication). This is the same information as in the video, but some people might prefer step-by-step photos (for example, in developing countries where they don't have the bandwidth to stream video)
    • Augmented Reality instructional material - this is not a necessity, but it is the next generation level of documentation which would allow for rapid teaching of fabrication
    • 3D model and CAD file
    • 2D fabrication drawings (metal)
    • 2d Exploded Part Diagram
    • Machine-readable CAM files
    • Circuit design file to build circuit boards, wiring diagram
    • Computer Software Control Code for Automated Devices
    • Hydraulic Circuit Diagram
    • Calculations (for scaling purposes)
  • ToolName user's manual.
    • Operation Procedures
    • Safety
    • Maintenance
    • Repair
    • Troubleshooting
  • ToolName Bill of Materials. Weblinks to suggested sources. Prices.
  • Buy ToolName. This will raise funds for OSE. We can sell both kits and finished devices. This should be used only for tools with Full Product Release status.
  • ToolNameicon.jpg - icons from Isaiah on blue background such as Tractorblue.png. Entire set will be put up at the Product Ecologies page. Make sure to upload icons as files with names of the format "ToolNameicon.jpg". It won't work if you name it something else, like "ToolName Icon.jpg", "Icon for ToolName.jpg" etc.