Specification/Design Document
Web Site
Specification/Design
Document
For
Habitat for Humanity IWV
P.O. Box 2134
Ridgecrest, CA 93556-2134
(760) 446-4151
Revision 2.5
Last Updated: 2/26/2011
Status: Draft
by
Information Systems
118 N. Gwen Dr.
Ridgecrest, CA 93555
769 900 3205
Document Revision History
Much of the project content data provided by Habitat for Humanity IWV for this document is posted on the Habitat Engineering Development Web Site. This data will be referenced in this document. To review the data go to web site:
Revision 1 – 4/15/09
Specification/Design Document Template dated 4/15/09 was assigned to Habitat for Humanity IWV.
Revision 2.0 – 7/5/2010
- Copy from web site baseline 1 was inserted in document for starting point in Section 3.1
- Copied business information proposal document into Section 2
Revision 2.1 – 8/12/2010
Jean Throckmorton provided copy for web pages Home, Giving, Volunteering, Projects, Applying, and Youth.
Revision 2.2 – 8/20/2010
Jean Throckmorton provided content for many web pages located in Section 3.1. Also provided navigation information in Section 3.4
Revision 2.3 - 9/6/2010
Jean Throckmorton provided new navigation information in Section 3.4. Changed the order of the web page copy in Section 3.1 from alphabetical to navigation sequence from left to right and top to bottom. Made business content changes in section 2.
Revision 2.4 – 10/15/2010 (Gene Throckmorton)
Jean Throckmorton revised section 2.3, Business History, section 2.9 visitor profiles and entered and edited content in Section 3.1.
Revision 2.5 – 11/2/2010 (Forrest Lloyd)
Added 1.2 “Required Documents”. Removed presentation information covered by Habitat Web Style Guide.
Document Status
These web software development processes are in constant review and modification to improve product quality, reduce software life cycle cost, and accommodate new technologies. For this reason, these documents are in constant change to reflect process improvement.
Conditions of Use
The software development and project management processes documented in this collection of documents are produced, owned and copyrighted by Information Systems. The documents are made available for use by any interested parties to support web development free of charge. Permission to use does not confer the right of ownership of the processes to the user. Ownership resides only with Information Systems. Users of these processes are encouraged to provide comment on improvement. Incorporated recommendations become property of Information Systems. Users are encouraged to tailor these documents to best accommodate their needs.
Disclaimer of Liability
With respect to images, data, and narrative posted on Information-Systems.biz, neither Information Systems nor any author makes any warranty, express or implied, including the warranties of merchantability and fitness for a particular purpose, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information, apparatus, product, or process disclosed, or represents that its use would not infringe privately owned rights. Neither Information Systems nor the authors shall be liable in any way for loss or damage, of any kind, to you, or any other person, for any inaccuracy, error, omission, or delay in any information posted or otherwise transmitted over Information-Systems.biz.
Table of Contents
1Purpose of Document......
1.1Scope of Document......
1.2Required Documents......
1.3Support Documents......
1.4Support Reports......
1.5Document Development Instructions......
2Business Overview......
2.1Business Name......
2.2Business Point of Contact......
2.3Business History......
2.4Business Mission Statement......
2.5Business Support Documents......
2.6Competitive Position......
2.7Domain......
2.8Server......
2.9Web Site Visitor Profile......
Profile – Web Surfer Equipment......
Profile – Potential Partner Family......
Profile – Volunteer......
Profile – Donor And Casual Browser......
Profile – Project Managers......
2.10Web Site Business Requirements......
2.11Customer In House Web Expertise......
2.12Current Web Site Evaluation......
2.13Web Site Upgrade Goals......
2.14Customer Reference Web Site......
2.15Expected Web Site Impact on Business......
2.16Marketing Plan Update......
3Information Design......
3.1Web Content......
3.1.1Home......
3.1.2Calendar......
3.1.3 Giving......
3.1.4Donors......
3.1.5Volunteering......
3.1.6Group Volunteers......
3.1.7 Projects......
3.1.8Project 1......
3.1.9Project 2......
3.1.10 Project 3......
3.1.11 Applicants......
3.1.12 Shelter......
3.1.13 Income......
3.1.14 Partnering......
3.1.15 Sweat Equity......
3.1.16 Youth......
3.1.17 BHS......
3.1.18 Homeowners......
3.1.19 2010 to 2012......
3.1.20 Kristene and Family......
3.1.21 Jarrod and Kristy and Family......
3.1.22 Brenda and Family......
2.1.23 2007 to 2009......
3.1.24 Darrell and Family......
3.1.25 Tina and Family......
3.1.26 Becky and Family......
3.1.27 Shawna and Family......
3.1.28 Doris and Family......
3.1.29 2004 to 2006......
3.1.30 Jessica and Family......
3.1.31 Tammy and Family......
3.1.32 Kathleen Burnett & JR Cavalos......
3.1.33 Phu and Family......
3.1.34Sandy and Family......
3.1.35 2001 to 2003......
3.1.36 Collette & Mike......
3.1.37 Robin, David, and Family......
3.1.38 Liz and Dave Allen & Family......
3.1.39 About Us......
3.1.40 History......
3.1.41 Leadership......
3.1.42 Committees......
3.1.43 Key People......
3.1.44 Coming Events......
3.1.45 Past Events......
3.1.46 Camplighters......
3.1.47 Katrina......
3.1.48 Builder Blitz......
3.1.49 Blitz Build......
3.1.50 Women Build......
3.1.51 Archives......
3.1.52 Contact Us......
3.1.53 Related Sites......
3.1.54 Privacy Notice......
3.2Sitemapping
3.3Wireframing
3.3.1 All Pages......
3.3.2 Banner......
3.3.3 Footer......
3.4Navigation
Tabbed Navigation......
Nav......
Directed Navigation......
4Visual Design/Presentation......
4.1Define Smart Design......
4.2Review Site Goals......
4.3Developing Concepts......
4.4Designing for Your Audience......
4.5Presenting Design and Gathering Feedback......
4.6Testing Functionality......
4.7Create Graphic Templates......
4.7.1Page Layout......
4.7.2HUD Logo......
4.7.3United Way Logo......
4.8Creating a Design Style Guide......
4.9Copyright Protected Material List......
5Functions......
5.1Search Engine Score Enhancements......
HTML Title tag......
Meta Data – Description......
Meta Data – Keywords......
5.2Meta Tag - Robots......
Search Engine Robot Include Directive......
Search Engine Robot Exclude Directive......
Validate Web Site Syntax......
Out Going Hyperlinks......
In Coming Hyperlinks......
Handicapped Enhancements......
Flash, Shockwave, Real, MP3......
Internal Navigation Links......
Register Web Sites......
5.3Handicapped Enhancements......
Non Text Elements......
Color Only......
Style Sheet Requirements......
Redundant Links......
Client-Side Image......
Table Requirements......
Screen Flicker......
Form Requirements......
Plug-in Links......
Time Extension......
Proper Text Markup......
5.4Visitor statistical Data......
5.5Forms......
5.6Login......
5.7Shopping Cart......
5.8E-Commerce......
5.9Content Management System (CMS)/Database......
6Technical Constraints......
6.1Technical Architecture......
6.2Security......
Cross-site Scripting......
Injection Flows......
Malicious File Execution......
Cross-site request forgery......
Insecure direct object reference......
Information Linkage & Improper Error Handling......
Broken Authentication and session management......
Insecure Cryptographic Storage......
Insecure Communications......
Failure To Restrict URL Crosses......
6.3Server Specifications......
Development Server......
Customer Server......
6.4Visitor Viewing Equipment Requirements......
Viewing Devices......
Browsers/OS/Computer for Screens......
Browser Plug-In/Options......
Screens......
Internet Connections......
7Content Maintenance......
7.1General Information......
7.2Content Related......
7.3Production Expertise......
7.4Promotion......
7.5Content Maintenance Report......
8Design......
8.1Content Partitioning......
8.2Internet Design Technologies......
8.3Validation......
W3C Markup Validation Service of XHTML......
W3C CSS Validation Service of CSS......
Firefox Real Time Error Checker for JavaScript......
9Future Enhancements......
1Purpose of Document
This document defines the requirements and design of the web site baseline “habitat 2”
1.1Scope of Document
This document defines the web site in its entirety. The document is started after the phase I proposal is approved by the customer and is completed prior to web site software coding. As this document is developed, the “Test Plan/Description/Report Document” is also developed. This document is done when the customer approves the document following the “Critical Design Review”.
1.2Required Documents
- Habitat Style Guide ( )
1.3Support Documents
- Web ReDesign 2.0 by Kelly Goto & Emily Cotler (Recommended text book)
- Web Site Evaluation Document (If upgrading a web site)
- Proposal Phase I - Web Site Definition Report
- Test Plan/Description Document (Template)
1.4Support Reports
Reports are generated in parallel with this document and provided to the customer to insure understanding. Customers are expected to review the report and return with comment. Dialogue associated with these reports is designed to minimize rework of documents presented at the design review. The reports include:
- Visitor Profile – Profiles the targeted web site visitors
- Content Maintenance Report – Procedures for keeping web site current
- Style Guide – Defines overall web site appearance
- Viewing Equipment Matrix Report – List of customer web serf equipment
1.5Document Development Instructions
- This document starts out as the Specification/Design Document template. Most template content is required to build all web sites. Instructions are identified with brackets as such {instructions} that provide guidance in completing this document. Remove the instructions from the document as the instructions are executed.
- Section “2 Business Description” has already been completed in the “Project Proposal Phase I – Definition” document. Use copy and past to move the information from one document to the other.
- Section “2.9 Web Site Visitor Profile” is critical information in completing this document. The customer provided this information when the “Project Proposal Phase I – Definition” document was prepared. If there is any drought about the accuracy of this information, make changes and provide this information back to the customer using a “Visitor Profile Report”. Use the same information format for this document and the report.
- Section “7 Web Site Content Maintenance” addresses how often and how much information will change on the web site. It is important to identify this information early in preparing this document. It will impact the web site design. When section 7 is completed, product a “Content Maintenance Report” and have the customer review and approve this section prior to document approval at the “Design Reviw”.
- Section “4.8 Creating a Design Style Guide” captures web style information to maintain presentation consistency throughout the web site life cycle. The style guide is produced in parallel with this document and reviewed and approved by the customer prior to completion of this document. Prototype web pages are developed to help the customer and developer define the web style. The web development team in Phase II will use the document. Web site maintainers will also use the document.
- Section “6.4 Visitor Viewing Equipment Requirements” identifies the equipment this web site will be designed to be viewed by. The lack of rigid browser standards means different browsers render a web site differently. Extra effort is required to make web site render the same on all browsers. To minimize cost, customers are advised to have web sites build to accommodate browsers most used by their customers.
2Business Overview
2.1Business Name
Habitat for Humanity IWV
P.O. Box 2134
Ridgecrest, CA 93556-2134
(760) 446-4151
2.2Business Point of Contact
Jean Throckmorton, Manager
2.3Business History
In February of 2000, Habitat for Humanity of the Indian Wells Valley (HFHIWV) was chartered as a 501(c)(3) Non-Profit Public Benefit Corporation in the State of California. In May of the same year HFHIWV was officially approved as an Affiliate of Habitat for Humanity, International (HFHI). In 2001 the first partner family moved into a rehabilitated house. Since then, 15 houses have been completed, a 16th started and a “House in a Box” was framed and sent to the Mobile, Alabama Affiliate to aid in Hurricane Katrina recovery. HFHIWV continues to raise awareness of inadequate and substandard housing in the Indian Wells Valley, and funds to build houses with low income families in need of decent affordable housing.
2.4Business Mission Statement
HFHIWV partners with God and people of the Indian Wells Valley to advocate for descent housing for all. While recognizing that we cannot meet every need, HFHIWV provides opportunities for partnership to build decent housing and communities so that all can see God’s love in action and allow all to live and grow into all that God intends.”
2.5Business Support Documents
The web master or their equivalent needs the following documents:
- Brochures
- Annual reports
2.6Competitive Position
Since this organization is a 501(c)(3) Not For Profit Corporation dedicated to moving families away from poverty, business competition is not an issue. However, with Habitat for Humanity, US being the leading builder in houses for low to middle income families, it is the responsibility of Habitat and its affiliates to provide leadership in advocacy, developing increased awareness of need and forming partnerships to achieve the vision of no sub-standard housing.
2.7Domain
The domain name is registered with Network Solutions. The owner of the domain name is Habitat for Humanity IWV. The domain name is paid up through July 2013. The domain name point of contact is Jean Throckmorton. The web site access information is:
Username: XXX
Password: XXX
2.8Server
Indian Wells Valley Internet Service Provider (IWVISP) graciously provides free web site hosting to Habitat for Humanity IWV. They also provide host engineering support free of charge. Their business address is:
IWVISP
417 Inyokern Road
Ridgecrest, CA 93555
Customer Support 760 446 5006
2.9Web Site Visitor Profile
Profile – Web Surfer Equipment
- The web site will use a screen size of 1024 X 768 pixels. 20% of the displays in use are 1024 X 768. 76% of the screens are larger than 1024 X 768.
- Web browser support includes: Firefox (45%), Internet Explorer (30%), Google Chrome (17%), Safari (4%), and Opera (3%).
- Platforms will include PC and Mac desktop and portable computers. At a future date handheld devices will be considered.
- Network speeds will include DSL, cable, and 3G. The web site will not be optimized for dial up modems.
- Browsers are assumed to support JavaScript
- Plug-ins will be required to support video and sound if those services are wanted.
- The web Internet connection will meet security requirements for financial transitions and password protected web pages.
Profile – Potential Partner Family
- Parents with children under 18
- Age: 18 and up
- Gender: 90% women, often single parents
- Online frequency: moderate
- Visitors will be looking for this web site because of the geographical area this Habitat chapter serves
- Seeking information about becoming a partner family including applicant information meeting dates.
- Seeking roles and responsibilities of being a partner family
- Geographical areas covered – Indian Wells Valley, Ridgecrest, Inyokern
- Geographical areas not covered – Trona, Red Mountain, Johannesburg, Randsburg
- Contact Habitat leadership
Profile – Volunteer
- Care-a-vanners, group representatives, and people with skills useful for providing a Habitat home or person wishing to help with office work, food preparation, speakers bureau or special events
- Group contact person for churches, organizations and out-of-town volunteers
- Age: 14 and up
- Gender: male and female
- Online frequency: weekly to check construction location and status
- Visitors will be looking for this web site because of the geographical area this Habitat affiliate serves
- The visitor will look for needed skills, job location and work schedule
- The visitor may want to fill out an ‘interests and skills’ form for various types of volunteer work.
- Visitors will want at least 10 day advance notice of work plan
- Download liability release forms and safe practices rules
- Contact Habitat management
Profile – Donor And Casual Browser
- Any person interested in providing resources to Habitat or learn more about the organization
- Age: primarily adult individuals but also churches, organizations and businesses
- Gender: male and female
- Online frequency: low
- Visitors will be looking for this web site because of the geographical area this Habitat chapter services
- The visitor will be looking for testimonials, houses completed, management information, and how to provide money
- Contact Habitat leadership
Profile – Project Managers
The web site is used to distribute information between project managers and committee chairs.
- Habitat leaders managing all aspects of operations
- Age: 18 and up, authorized by Board or Executive Director
- Gender: male and female
- Online frequency: daily to weekly
- Visitors will review project information (including photographic and short video images) and provide updates to web master
- Distribute information to volunteers, donors, potential partner families and the community
- Print out liability release forms
- Print out other forms as necessary – Skills/Interests, Calendars.
2.9.5 Profile - Leaders
- Board of Directors, Executive Director
- Age: 18 and above
- Gender: men and women
- Online frequency: weekly
- Visitors will review project status and review web site content for accuracy
- Visitors will insure proper and adequate web content
2.10Web Site Business Requirements
Partner families are not financially capable of being part of the competitive housing market. However, the corporation is in competition for other humanitarian resources. To compete for these limited resources, Habitat must convince donors their dollars will provide the most benefit to society.
2.11Customer In House Web Expertise
Habitat for Humanity IWV has no paid in house web capability. They depend on volunteers.
2.12Current Web Site Evaluation
A student through class projects has developed the current web site. Most of the focus was on demonstrating web-programming techniques. Consequently, the site has not evolved from a customer specified set of business requirements. Improvements in navigation are most critically needed. Seventy-five percent of the copy can be used in the updated web site. The other twenty-five percent of the data is outdated.
2.13Web Site Upgrade Goals
- Add pull down navigation to all pages (2 levels)
- Add home page banner updated from server file
- Add information page for office, board and committee chairs
- Add recognition for services provided by local businesses
- Add hyperlinks and additional forms
- Expanded photo gallery
2.14Customer Reference Web Site
{List customer reference web sites for design purposes.}
a.
b.
c.
2.15Expected Web Site Impact on Business
- Marketing - The web development effort will require Habitat management to modify the existing marketing plan to accommodate the new web site.
- Advertising – The website should reduce many of the current costs associated with advertising. The budget is small. It is assumed that the web address is already on printed material.
- Operations – This web site should reduce labor associated with managing construction volunteers. Schedules must be kept current. Skill set and number of workers must also be identified. It should make potential partner family interest information easier to obtain and retain over time, reducing challenges of contacting them. It should also provide a more cost effective mechanism for donations when e-commerce is added.
- It is hoped that by recognizing our business partners on the website added synergy between the organizations will be maximized.
- Communications – Time spent educating people about Habitat should be significantly reduced if all the relevant information is adequately communicated on the web site.
- Advocacy and awareness of the need for housing should be improved.
2.16Marketing Plan Update