From 704e13c18fcc6967ef8c066f5513804b16751c13 Mon Sep 17 00:00:00 2001 From: William Sandner Date: Sun, 1 Aug 2021 15:15:57 +0200 Subject: [PATCH] Fix linter warnings --- Installation-Guide.md | 15 ++++++++------- Interview-Checklist.md | 1 + Interview-Notes.md | 1 + Legal.md | 5 +++-- License.md | 4 ++-- Project-Plan.md | 5 +++-- Proposal.md | 17 +++++++++-------- QA-Plan.md | 17 ++++++++++------- Release-Checklist.md | 1 + Release-Notes.md | 33 +++++++++++++++++---------------- Resource-Needs.md | 3 ++- Review-Meeting-Checklists.md | 4 ++-- Review-Meeting-Notes.md | 6 ++++-- Risks.md | 9 +++++---- SDM.md | 3 ++- SRS.md | 7 ++++--- Status-Report.md | 23 ++++++++++++----------- Summary.md | 23 ++++++++++++----------- Target-and-Benefits.md | 19 ++++++++++--------- Test-Case-Format.md | 2 +- Test-Cases.md | 5 +++-- Test-Run-Suite.md | 3 ++- Test-Runs.md | 3 +-- Test-Suite.md | 2 ++ Use-Case-Format.md | 2 +- Use-Case-Suite.md | 8 +++++--- Use-Cases.md | 9 +++++---- User-Guide.md | 3 ++- User-Needs.md | 5 +++-- Workflows.md | 3 ++- 30 files changed, 135 insertions(+), 106 deletions(-) diff --git a/Installation-Guide.md b/Installation-Guide.md index 73de2a3..13a8d0c 100644 --- a/Installation-Guide.md +++ b/Installation-Guide.md @@ -1,24 +1,25 @@ + *TODO: Fill in information about this product. Make sure to use the **product** name and **external** release number, not internal information.* -##### Product: +##### Product ::PRODUCT-NAME -##### Release Number: +##### Internal Release Number ::X.Y.Z -##### Release Date: +##### Release Date ::YEAR/MONTH/DAY -##### Customer Support: +##### Customer Support -:: For more information or support, please visit our -[website](http://www.COMPANY.com/products/PRODUCT-NAME/) or -email us at +:: For more information or support, please visit our +[website](::http://www.COMPANY.com/products/PRODUCT-NAME/) or +email us at <::support@COMPANY.com> --- diff --git a/Interview-Checklist.md b/Interview-Checklist.md index aaa1d59..19d3686 100644 --- a/Interview-Checklist.md +++ b/Interview-Checklist.md @@ -1,3 +1,4 @@ + ##### Related Documents - [User Needs](User-Needs) diff --git a/Interview-Notes.md b/Interview-Notes.md index afc20b7..ff74ac9 100644 --- a/Interview-Notes.md +++ b/Interview-Notes.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) diff --git a/Legal.md b/Legal.md index 221e334..4698876 100644 --- a/Legal.md +++ b/Legal.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) @@ -6,14 +7,14 @@ ::X.Y.Z -##### Release Audience: +##### Release Audience - ::General availability release || - ::Customer-specific release: CUSTOMER(S) || - ::Developer release (Internal usage only) || - ::Early access release (Controlled external access) -##### Intended Product License: +##### Intended Product License ::Commercial license diff --git a/License.md b/License.md index de58cd1..417553e 100644 --- a/License.md +++ b/License.md @@ -1,4 +1,4 @@ - + Do not modify or delete this file. This file describes the license under which you may use the ReadySET templates. @@ -62,7 +62,7 @@ same license. No, but it would be very welcome. Even if you don't modify the templates, you can share your "words of wisdom". For more -information on contributing, see the +information on contributing, see the [ReadySET home page](http://readyset.tigris.org/). #### ReadySET seems too good to be true. What is the catch? Why would anyone buy a commercial version? diff --git a/Project-Plan.md b/Project-Plan.md index 2b89511..64c382c 100644 --- a/Project-Plan.md +++ b/Project-Plan.md @@ -1,12 +1,13 @@ + ##### Project ::[PROJECT-NAME](Home) -##### Project Time-frame: +##### Project Time-frame ::START-DATE - END-DATE -##### Attached worksheets: +##### Attached worksheets - Plan > [Resource Needs](Resource-Needs) diff --git a/Proposal.md b/Proposal.md index da70be1..b7e0435 100644 --- a/Proposal.md +++ b/Proposal.md @@ -1,16 +1,17 @@ + ##### Project ::[PROJECT-NAME](Home) -##### Project Time-frame: +##### Project Time-frame ::2003/1/16 to 2003/3/19 -##### Summary: +##### Summary ::2-4 SENTENCE SUMMARY -##### Attached Worksheets: +##### Attached Worksheets Project Proposal > [Target audience and benefits](Target-and-Benefits) @@ -63,8 +64,8 @@ motivated or honest in their evaluations. There are already some clan directory web sites, but they are not automated so they are always out of date and do not rate the quality of the websites. -- ::[Example of current manually maintained clan website](#) -- ::[Link to existing competitor](#) +- ::[Example of current manually maintained clan website](#tbd) +- ::[Link to existing competitor](#tbd) #### Why is this problem worth solving or worth solving better? @@ -99,9 +100,9 @@ those advantages. ::The following pages provide additional background and motivation: -- ::[Magazine article on this topic](#) -- ::[Industry analysis's report on massive-multi-player game market](#) -- ::[Quotes from game players](#) +- ::[Magazine article on this topic](#tbd) +- ::[Industry analysis's report on massive-multi-player game market](#tbd) +- ::[Quotes from game players](#tbd) ### Goal diff --git a/QA-Plan.md b/QA-Plan.md index 2cd3702..6072c6b 100644 --- a/QA-Plan.md +++ b/QA-Plan.md @@ -1,3 +1,6 @@ + + + *TODO: For each release, update this file by filling in answers to the questions. In cases where multiple answers are already written, delete those answers that do not apply.* @@ -6,18 +9,18 @@ those answers that do not apply.* ::[PROJECT-NAME](Home) -##### Internal Release Number: +##### Internal Release Number ::X.Y.Z -##### Release Audience: +##### Release Audience - ::General availability release || - ::Customer-specific release: CUSTOMER(S) || - ::Developer release (Internal usage only) || - ::Early access release (Controlled external access) -##### Attached Worksheets: +##### Attached Worksheets - QA plan > [Review meeting notes](Review-Meeting-Notes) - QA plan > [System test case suite](Test-Suite) @@ -67,7 +70,7 @@ coordinate all the QA activities. #### What is the scope of this QA plan? -::All components and aspects of the system will be evaluated in +::All components and aspects of the system will be evaluated in this release. ::There are many quality goals and approaches to assuring them. Since @@ -141,7 +144,7 @@ achieve. If you do not plan to perform an activity, write "N/A".* |--------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ::Preconditions | | ::We will use if-statements at the beginning of public methods to validate each argument value. This helps to document assumptions and catch invalid values before they can cause faults. | | ::Assertions | | ::Assertions will be used to validate all arguments to private methods. Since these methods are only called from our other methods, arguments passed to them should always be valid, unless our code is defective. Assertions will also be used to test class invariants and some postconditions. | -| ::Static analysis | | ::We will use source code analysis tools to automatically detect errors. Style checkers will help make all of our code consistent with our coding standards. XML validation ensures that each XML document conforms to its DTD. Lint-like tools help detect common programming errors. E.g.: [lint](http://www.freebsd.org/cgi/man.cgi?query=lint), [lclint/splint](http://www.splint.org/), [jlint](http://artho.com/jlint/), [checkstyle](http://sourceforge.net/projects/checkstyle/), [Jcsc](http://sourceforge.net/projects/jcsc), [PyLint](https://www.pylint.org/), [PyChecker](http://pychecker.sourceforge.net/), [Tidy](http://www.html-tidy.org/) | +| ::Static analysis | | ::We will use source code analysis tools to automatically detect errors. Style checkers will help make all of our code consistent with our coding standards. XML validation ensures that each XML document conforms to its DTD. Lint-like tools help detect common programming errors. E.g.: [lint](http://www.freebsd.org/cgi/man.cgi?query=lint), [lclint/splint](http://www.splint.org/), [jlint](http://artho.com/jlint/), [checkstyle](http://sourceforge.net/projects/checkstyle/), [Jcsc](http://sourceforge.net/projects/jcsc), [PyLint](https://www.pylint.org/), [PyChecker](http://pychecker.sourceforge.net/), [Tidy](http://www.html-tidy.org/) | | ::Buddy review | | ::Whenever changes must be made to code on a release branch (e.g., to prepare a maintenance release) the change will be reviewed by another developer before it is committed. The goal is to make sure that fixes do not introduce new defects. | | ::Review meetings | | ::We will hold review meetings where developers will perform formal inspections of selected code or documents. We choose to spend a small, predetermined amount of time and try to maximize the results by selecting review documents carefully. In the review process we will use and maintain a variety of checklists. | | ::Unit testing | | ::We will develop and maintain a unit test suite using the JUnit framework. We will consider the boundary conditions for each argument and test both sides of each boundary. Tests must be run and passed before each commit, and they will also be run by the testing team. Each public method will have at least one test. And, the overall test suite will exercise at least 75% of all executable statements in the system. | @@ -267,7 +270,7 @@ and tracked to completion.* this plan as needed. ::No, this plan leaves open several quality risks that have been noted - in the [Risk Management](Project-Plan#Risk-Management) section of the + in the [Risk Management](Project-Plan#Risk-Management) section of the [Project Plan](Project-Plan). #### Have human resources been allocated to carry out the QA activities? @@ -300,5 +303,5 @@ is welcome. ::No, some developers are not aware of the quality goals and planned QA activities for this release. This is a risk that is noted in the -[Risk Management](Project-Plan#Risk-Management) section of the +[Risk Management](Project-Plan#Risk-Management) section of the [Project Plan](Project-Plan). diff --git a/Release-Checklist.md b/Release-Checklist.md index 448e215..5a8b5ed 100644 --- a/Release-Checklist.md +++ b/Release-Checklist.md @@ -1,3 +1,4 @@ + *TODO: For each release, copy this file and fill in answers to the questions. In cases where multiple answers are already written, delete those answers that do not apply.* diff --git a/Release-Notes.md b/Release-Notes.md index 449308a..4ca4c13 100644 --- a/Release-Notes.md +++ b/Release-Notes.md @@ -1,3 +1,4 @@ + *TODO: For each release, copy this file and fill in the needed information.* @@ -6,11 +7,11 @@ number, not internal information.* ##### Product -::[PRODUCT-NAME](http://www.COMPANY.com/products/PRODUCT-NAME/) +::[PRODUCT-NAME](http://www.COMPANY.com/products/PRODUCT-NAME/) ##### Release Number -::X.Y.Z +::X.Y.Z ##### Release Date @@ -18,8 +19,8 @@ number, not internal information.* ##### Customer Support -::For more information or support, please visit our -[website](http://www.COMPANY.com/products/PRODUCT-NAME/) or email us +::For more information or support, please visit our +[website](http://www.COMPANY.com/products/PRODUCT-NAME/) or email us at --- @@ -149,13 +150,13 @@ prior to generating the report, if you notice that they are incorrect. You may exclude or summarize changes that might give away valuable proprietary information.* -- ::FIX [09823](#) Screen frozen when caps-lock is on -- ::FIX [09912](#) Static heard while downloading -- ::FIX [10923](#) Repeat-mode cannot play more than 99 times -- ::ENHANCEMENT [08237](#) Scratch DJ-mode -- ::ENHANCEMENT [08238](#) Chill DJ-mode -- ::ENHANCEMENT [08259](#) Retro stereo-mode -- ::ENHANCEMENT [10202](#) Techno-mode +- ::FIX [09823](#tbd) Screen frozen when caps-lock is on +- ::FIX [09912](#tbd) Static heard while downloading +- ::FIX [10923](#tbd) Repeat-mode cannot play more than 99 times +- ::ENHANCEMENT [08237](#tbd) Scratch DJ-mode +- ::ENHANCEMENT [08238](#tbd) Chill DJ-mode +- ::ENHANCEMENT [08259](#tbd) Retro stereo-mode +- ::ENHANCEMENT [10202](#tbd) Techno-mode ### Known Problems and Workarounds @@ -164,11 +165,11 @@ defects discovered in this release, or in previous releases that are still not resolved. Include information on workarounds from the issues. Otherwise, same as above.* -- ::DEFECT [07293](#) Player skips on very loud playback. +- ::DEFECT [07293](#tbd) Player skips on very loud playback. - ::WORKAROUND: Limit volume to settings 1 through 9. -- ::DEFECT [10509](#) Cannot switch directly from random play mode to +- ::DEFECT [10509](#tbd) Cannot switch directly from random play mode to Internet play-list. - - ::WORKAROUND: Switch to local play-list first. Click [here](#) for + - ::WORKAROUND: Switch to local play-list first. Click [here](#tbd) for detailed instructions. -- ::DEFECT [10589](#) Static heard while booting -- ::DEFECT [10944](#) Repeat-mode cannot play more than 999 times +- ::DEFECT [10589](#tbd) Static heard while booting +- ::DEFECT [10944](#tbd) Repeat-mode cannot play more than 999 times diff --git a/Resource-Needs.md b/Resource-Needs.md index a8e801e..fc3ed33 100644 --- a/Resource-Needs.md +++ b/Resource-Needs.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) @@ -6,7 +7,7 @@ ::X.Y.Z -##### Project Time-frame: +##### Project Time-frame ::START-DATE - END-DATE diff --git a/Review-Meeting-Checklists.md b/Review-Meeting-Checklists.md index 6987d56..f495714 100644 --- a/Review-Meeting-Checklists.md +++ b/Review-Meeting-Checklists.md @@ -4,9 +4,9 @@ ## Checklists for Types of Artifacts -- ::[Checklists for peer reviews](http://processimpact.com/pr_goodies.shtml) +- ::[Checklists for peer reviews](http://processimpact.com/pr_goodies.shtml) by Karl E. Wiegers -- ::[Checklists for UML design](http://www.modelingstyle.info/) +- ::[Checklists for UML design](http://www.modelingstyle.info/) by Scott W. Ambler ## Style Guides diff --git a/Review-Meeting-Notes.md b/Review-Meeting-Notes.md index 150bb61..aaaebac 100644 --- a/Review-Meeting-Notes.md +++ b/Review-Meeting-Notes.md @@ -1,3 +1,5 @@ + + ##### Project ::[PROJECT-NAME](Home) @@ -30,8 +32,8 @@ ### Documents and Code Reviewed at this Meeting -- ::[Feature list section of requirements](#) -- ::[Multi-user section of requirements](#) +- ::[Feature list section of requirements](#tbd) +- ::[Multi-user section of requirements](#tbd) - ::[Hello.java](/source/browse/PROJECT-NAME/src/Hello.java) - ::[HelloStream.java](/source/browse/PROJECT-NAME/src/HelloStream.java) - ::[HelloPanel.java](/source/browse/PROJECT-NAME/src/HelloPanel.java) diff --git a/Risks.md b/Risks.md index 6e1d6c1..a4613da 100644 --- a/Risks.md +++ b/Risks.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) @@ -11,7 +12,7 @@ - [Project plan](Project-Plan) - [Software development methodology](SDM) -##### References: +##### References - [Risk Management during Requirements](http://www.systemsguild.com/pdfs/s5req.lo%201.pdf) by Tom DeMarco and Tim Lister - [Taxonomy-Based Risk Identification](http://www.sei.cmu.edu/pub/documents/93.reports/pdf/tr06.93.pdf) by Carr, Konda, Monarch, Ulrich, and Walker (SEI) @@ -55,7 +56,7 @@ take away our lessons learned and any valuable project bi-products. pretend everything is fine and hope that none of the stakeholders notice. -#### Risks that consume development resources. +#### Risks that consume development resources ::The project has a fixed deadline. The requirements are prioritized. If we lose time, we will reduce project scope. @@ -76,7 +77,7 @@ delivery date. | Name | Description | Likelihood | Impact | Plan | Status | Owner | |-----------------|---------------------------------------------------------------------------------------------------------------------------------|------------|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|-------------------| | ::Requirements | Requirements are only partly known at project start. Customers may not allocate sufficient resources to exploring requirements. | Medium | Critical to Catastrophic | Requirements will be detailed first for the top priority goals. Indicator: Track the rate at which requirements are discovered. Contingency: request more customer effort. | Amber | Requirements Lead | -| ::Goals | Stakeholders goals may conflict. | Medium | Critical | Keep an explicit list of stakeholders goals. The project manager will report progress to each declared goal. | Green | Customers | +| ::Goals | Stakeholders goals may conflict. | Medium | Critical | Keep an explicit list of stakeholders goals. The project manager will report progress to each declared goal. | Green | Customers | | ::Communication | Communication problems in development team. They are dispersed among several sites, and have not worked together before. | Medium | Critical | Use these [tools](SDM#communication) to help communication. The main indicator of miscommunication will be software defects detected by our [QA activity](qa-plan). | Green | QA lead | | ::Acceptance | Customer may accept delivery of the system although it does not really meet their goals. | Medium | Critical | Customers are asked to declare acceptance criteria as each release is planned. | Green | Customers | | ::Scope | The total features requested may be beyond what the development team can deliver in the time available. | High | Marginal | Assign levels of important to the use cases. Make the first review of project scope after 12 months. | Green | Customers | @@ -173,4 +174,4 @@ the project could deliver. RISKNAME RISKNAME and strength of character of RISKNAME -RISKNAME \ No newline at end of file +RISKNAME diff --git a/SDM.md b/SDM.md index fdcce2f..3ff0713 100644 --- a/SDM.md +++ b/SDM.md @@ -1,5 +1,6 @@ + *TODO: This template is not done yet. Feel free to contribute your ideas.* A Software Development Methodology is always specific to a given company, but the outline of that document could be reused, as could some -sections on common practices such as version control procedures. \ No newline at end of file +sections on common practices such as version control procedures. diff --git a/SRS.md b/SRS.md index a67bed0..aff26c1 100644 --- a/SRS.md +++ b/SRS.md @@ -1,3 +1,4 @@ + ##### Project ::PROJECT-NAME @@ -6,7 +7,7 @@ ::X.Y.Z -##### Attached worksheets: +##### Attached worksheets - SRS > [Use case suite](Use-Case-Suite) - SRS > [Feature set](Feature-Set) @@ -249,8 +250,8 @@ Details: - ::The system will store all data in a standard SQL database, where it can be accessed by other programs. -- ::The system will store all data in an XML file, using a +- ::The system will store all data in an XML file, using a [standard DTD](LINK-TO-STANDARD). -- ::The system will read and write valid .XYZ files used by +- ::The system will read and write valid .XYZ files used by OTHER APPLICATION - ::DETAIL diff --git a/Status-Report.md b/Status-Report.md index ee2d3ac..4ed5709 100644 --- a/Status-Report.md +++ b/Status-Report.md @@ -1,3 +1,4 @@ + *TODO: Copy this file for each status report. Fill in the information below. Email a notification to stakeholders when this report is made available.* @@ -25,29 +26,29 @@ examples are given, you should select/edit only one.* - ::Change Since Last Report: Slipped 2 days - ::Change Since Last Report: Saved 4 days -##### Open Issues (needing development): +##### Open Issues (needing development) - ::[17 defects](ISSUE-TRACKER-QUERY) -- ::[8 enhancements](#) +- ::[8 enhancements](#tbd) -##### Resolved Issues (pending verification): +##### Resolved Issues (pending verification) -- ::[0 defects](#) -- ::[2 enhancements](#) +- ::[0 defects](#tbd) +- ::[2 enhancements](#tbd) -##### Closed Issues: +##### Closed Issues -- ::[34 defects](#) -- ::[3 enhancements](#) +- ::[34 defects](#tbd) +- ::[3 enhancements](#tbd) -##### Resources used this period: +##### Resources used this period - ::PERSON-NAME: 18 hours. - ::PERSON-NAME: 15 hours. - ::PERSON-NAME: 10 hours. - ::PERSON-NAME: 12 hours. -##### Status Summary: +##### Status Summary - ::Project completed. This is the final status report. - ::Low risk. Project on track. @@ -110,7 +111,7 @@ possible.* - ::Fix [issue 130](ISSUE-TRACKER-URL) - ::Fix [issue 133](ISSUE-TRACKER-URL) -- ::Verify [issue 102](ISSUE-TRACKER-URL), [issue 103](ISSUE-TRACKER-URL), +- ::Verify [issue 102](ISSUE-TRACKER-URL), [issue 103](ISSUE-TRACKER-URL), [issue 107](ISSUE-TRACKER-URL), and [issue 109](ISSUE-TRACKER-URL) - ::Conduct regular team meeting: Tuesday, 1 hour - ::Conduct review meeting: Wednesday, 2 hours diff --git a/Summary.md b/Summary.md index baf6bbc..14894ca 100644 --- a/Summary.md +++ b/Summary.md @@ -1,6 +1,7 @@ + ### Mission and Scope -*TODO: Answer these questions in your own words. This is condensed +*TODO: Answer these questions in your own words. This is condensed from the project [Home](Home).* #### What problem does this project address? @@ -35,7 +36,7 @@ functionality and a wider set of testers. ### Resources and schedule *TODO: Briefly describe the project resources and schedule. This is -condensed from the [project plan](Project-Plan), [resource needs](Resource-Needs), +condensed from the [project plan](Project-Plan), [resource needs](Resource-Needs), and [legal issues](legal.html) documents.* #### What are the deadlines for this project? @@ -66,10 +67,10 @@ and [legal issues](legal.html) documents.* ### Requirements -*TODO: Briefly describe the most important system requirements. This is -condensed from the [user needs](User-Needs), -[interview notes](interview-notes.html), [SRS](SRS), -[use case suite](Use-Case-Suite), +*TODO: Briefly describe the most important system requirements. This is +condensed from the [user needs](User-Needs), +[interview notes](interview-notes.html), [SRS](SRS), +[use case suite](Use-Case-Suite), and [feature set](Feature-Set) documents.* #### Who are the project stakeholders? @@ -102,7 +103,7 @@ worksheets.* 1. ::Correctness - ::This design correctly matches the given requirements. -2. ::Feasibility +2. ::Feasibility - ::This design can be implemented and tested with the planned amount of time and effort. 3. ::Understandability @@ -207,18 +208,18 @@ Where is the user documentation? the team would not already know them. This is condensed from the [glossary](Glossary) documents.* -##### ::TECHNICAL TERM 1 +#### ::TECHNICAL TERM 1 ::DEFINITION -##### ::TECHNICAL TERM 2 +#### ::TECHNICAL TERM 2 ::DEFINITION -##### ::TECHNICAL TERM 3 +#### ::TECHNICAL TERM 3 ::DEFINITION -##### ::TECHNICAL TERM 4 +#### ::TECHNICAL TERM 4 ::DEFINITION diff --git a/Target-and-Benefits.md b/Target-and-Benefits.md index 8c4b88f..8b9c98e 100644 --- a/Target-and-Benefits.md +++ b/Target-and-Benefits.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) @@ -33,7 +34,7 @@ examples. Delete them and answer in your own words.* ::Open source development tools for SQL database design. -#### What is the target market for this product? Include specific defining characteristics. +#### What is the target market for this product? Include specific defining characteristics? ::Experienced console game players age 13-35 who enjoy first-person shooter games with detailed character animation models and @@ -43,22 +44,22 @@ cinematic segments. games, and other content to high-end phones and who are concerned about the potential for viruses. -#### What is the size of the total available market? Cite references for facts. +#### What is the size of the total available market? Cite references for facts? -::10,000 users \[[magazine article](#)\]. +::10,000 users \[[magazine article](#tbd)\]. -::$10M, growing annually at 4% \[[industry analyst](#)\]. +::$10M, growing annually at 4% \[[industry analyst](#tbd)\]. #### What are some other customer options or leading products that address the same needs? -- ::[Competitor 1](#) -- ::[Competitor 2](#) -- ::[Do-it-yourself solutions](#) +- ::[Competitor 1](#tbd) +- ::[Competitor 2](#tbd) +- ::[Do-it-yourself solutions](#tbd) #### Are there any known customers for this product? -- ::[MegaCorp, corporate I.T. department](#) -- ::[Worldwide Global Corporation](#) +- ::[MegaCorp, corporate I.T. department](#tbd) +- ::[Worldwide Global Corporation](#tbd) - ::Our own in-house application software developers and server operations team - ::Our own marketing, sales, and customer support departments diff --git a/Test-Case-Format.md b/Test-Case-Format.md index c701309..1349130 100644 --- a/Test-Case-Format.md +++ b/Test-Case-Format.md @@ -1,4 +1,4 @@ - + ##### Related Documents - [QA Plan](QA-Plan) > [Test Suite](Test-Suite) > Test Case Format diff --git a/Test-Cases.md b/Test-Cases.md index 496baee..1544bdb 100644 --- a/Test-Cases.md +++ b/Test-Cases.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) @@ -187,8 +188,8 @@ values are written in set notation, one per line. E.g.: **Purpose:** -::Short sentence or two about the aspect of the system is -being tested. If this gets too long, break the test case +::Short sentence or two about the aspect of the system is +being tested. If this gets too long, break the test case up or put more information into the feature descriptions. **Prerequisite:** diff --git a/Test-Run-Suite.md b/Test-Run-Suite.md index 5965284..3fe91c8 100644 --- a/Test-Run-Suite.md +++ b/Test-Run-Suite.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) @@ -26,7 +27,7 @@ assess risk, and focus ongoing testing efforts. - *Review the [target audience](Target-and-Benefits), [environmental requirements](SRS#environmental), and [possible - deployments](Design-Architecturel#deployment) to understand the + deployments](Design-Architecture#deployment) to understand the set of possible system configurations that could be tested.* - *Use a table or list to describe that set of possible configurations. Mark each possibility with Pending, N/A, or Waived.* diff --git a/Test-Runs.md b/Test-Runs.md index 6a8cb99..8824b4c 100644 --- a/Test-Runs.md +++ b/Test-Runs.md @@ -1,5 +1,4 @@ -##### Project - +##### Project ::[PROJECT-NAME](Home) ##### Internal Release Number diff --git a/Test-Suite.md b/Test-Suite.md index 6b0b593..520c26c 100644 --- a/Test-Suite.md +++ b/Test-Suite.md @@ -1,3 +1,5 @@ + + ##### Project ::[PROJECT-NAME](Home) diff --git a/Use-Case-Format.md b/Use-Case-Format.md index 948dfeb..c4294f7 100644 --- a/Use-Case-Format.md +++ b/Use-Case-Format.md @@ -1,4 +1,4 @@ - + ##### Related Documents - [SRS](SRS) > [Use Case Suite](Use-Case-Suite) > Use Case Format diff --git a/Use-Case-Suite.md b/Use-Case-Suite.md index 21547bb..7d2b712 100644 --- a/Use-Case-Suite.md +++ b/Use-Case-Suite.md @@ -1,3 +1,5 @@ + + ##### Project ::[PROJECT-NAME](Home) @@ -30,9 +32,9 @@ visible blanks on this page if you are missing use cases. E.g., see "Scalability and availability". Choose one or more of the organizations show below.* -*TIP: Refer back to the user stories in your [user needs](User-Needs) -document. Use them for ideas and make sure that you cover all of them. -Remember that use cases are more precise than user stories, and there +*TIP: Refer back to the user stories in your [user needs](User-Needs) +document. Use them for ideas and make sure that you cover all of them. +Remember that use cases are more precise than user stories, and there may be several use cases for a given user story.* *TIP: The use case suite can be organized into nested lists according to diff --git a/Use-Cases.md b/Use-Cases.md index 685cd8d..102e9b5 100644 --- a/Use-Cases.md +++ b/Use-Cases.md @@ -1,3 +1,4 @@ + ##### Project ::PROJECT-NAME @@ -47,7 +48,7 @@ detail.* actually writing the use case in detail. Document the most important use cases first and come back to less important ones later.* -*TIP: See detailed tips in the +*TIP: See detailed tips in the [guidelines for writing use cases](Use-Case-Format#further-information).* --- @@ -85,8 +86,8 @@ cases first and come back to less important ones later.* **Notes and Questions:** -- ::How will administrators know the right timezone abbreviation? - - They would know it if they live in that timezone. Maybe we could +- ::How will administrators know the right timezone abbreviation? + - They would know it if they live in that timezone. Maybe we could provide a drop-down list of all choices, but each would need some explanation. --- @@ -152,7 +153,7 @@ cases first and come back to less important ones later.* ### UC-03: Edit user profile -** Summary:** +**Summary:** ::Users can edit their own account preferences. diff --git a/User-Guide.md b/User-Guide.md index c3a6abc..02b0f78 100644 --- a/User-Guide.md +++ b/User-Guide.md @@ -1,3 +1,4 @@ + *TODO: Fill in information on this product. Make sure to use the **product** name and **external** release number, not internal information.* @@ -16,7 +17,7 @@ information.* ##### Customer Support -::For more information or support, please visit our +::For more information or support, please visit our [website](http://www.COMPANY.com/products/PRODUCT-NAME/) or email us at diff --git a/User-Needs.md b/User-Needs.md index 987512b..b50b598 100644 --- a/User-Needs.md +++ b/User-Needs.md @@ -1,3 +1,4 @@ + ##### Project ::[PROJECT-NAME](Home) @@ -44,7 +45,7 @@ will be hyper-linked from here. ### Environment *TODO: Briefly describe various aspects of the environment where the -software will be used. Describe the environment as it *is* or *will be*, +software will be used. Describe the environment as it \*is\* or \*will be\*, not what you would wish it to become. The text below gives a few examples.* @@ -182,7 +183,7 @@ it here.* *TODO: Write brief user stories to explain how various actors would interact with the system (directly and indirectly) to accomplish a -real-world goal. User stories are *not* use cases: user stories are +real-world goal. User stories are \*not\* use cases: user stories are brief (3-5 sentences) paragraphs that describe one specific scenario in concrete terms. In this description of user needs, do not make assumptions about details of the system, instead focus on the users. diff --git a/Workflows.md b/Workflows.md index 636cae6..c69ca39 100644 --- a/Workflows.md +++ b/Workflows.md @@ -1,3 +1,4 @@ + ### By Activity 1. Project Planning @@ -123,5 +124,5 @@ - [Download template archive](http://readyset.tigris.org/servlets/ProjectDocumentList), or - Use CVS to [check out](http://readyset.tigris.org/servlets/ProjectSource) project - "readyset" or clone from [ReadySet GFM](https://github.com/bike-bill/readyset-gfm/wiki) + "readyset" or clone from [ReadySet GFM](https://github.com/bike-bill/readyset-gfm/wiki) on Github.