Test documentation describes the artifacts created before, during, and after testing for the purpose of communicating with stakeholders to solicit feedback, to capture your intended approach to provide guidance for your team, to provide actionable information for business decision makers, and to ...

learn more… | top users | synonyms

14
votes
4answers
2k views

Documenting Unit Tests

We follow a BDD approach to development, we have our testers creating scenarios from a specification, and these are then given to our developers before any work is started. However, we find that some ...
11
votes
5answers
930 views

Test Strategy Documentation

What are the main points that should be included in a test strategy document for a particular project? I'm not looking at details but more from a high level overview. I would like to make it a brief ...
9
votes
5answers
1k views

How to organize test documentation?

Testing process involves plenty of documentation. How to organize it, so that it is easy to get an information that is needed?
8
votes
4answers
3k views

How do you write a great bug report? [closed]

"Is this going to be a stand-up fight sir, or a bug hunt?" - Hudson I've always wondered what the secrets were to writing a great bug report. Over time I've narrowed down the activity to three ...
7
votes
4answers
226 views

What do you do when you encounter overloaded terminology in your workspace?

I've been in many difference sized companies and in many different environments where we've used terms interchangably, Testing Terms, Development Terms and Process types have been overloaded in one ...
7
votes
4answers
7k views

Release Notes Best Practices

What are some tips for writing good release notes? Any best practices or examples? My audience is both my QA department and the executive team.
7
votes
1answer
908 views

Any tricks to using Microsoft Word to build cross-referenceable requirements statements in test plan documentation?

I'm in the process of updating document templates for a customer. Part of the documentation template stack are the usual QA items: Requirements (RS), Architecture (ADD), Test Plan (TP) and Test Report ...
6
votes
0answers
49 views

visualizing the chronology of a discovery process

Meta: this is probably not a question for which there is a single, objective, best answer, but I'm going to ask it here anyway because it's applicable to our jobs and non-obvious. I spent three ...
5
votes
9answers
536 views

Is there some software to document the results of functional software testing?

Can anyone recommend some software that can be used to document the results of functional software testing? This is not at developer level, it is for testers to follow documented procedures/scripts ...
5
votes
3answers
215 views

How can I organize QA documentation within an Agile environment

In Agile we favor immediate communication over documentation. Yes in QA we still have a need and desire to document the process to provide structure and guidance. What high level structure in our ...
3
votes
4answers
593 views

How do you adapt agile testing techniques to a regulated industry?

The StackExchange search seems to think this is a subjective question. I'm not sure about that. It seems pretty straightforward. Agile methodologies of software development involve more than just ...
3
votes
3answers
330 views

What is Bi-directional Traceability Matrix?

How is it different from a Requirement Traceability Matrix (RTM)? Please explain with real life scenarios and examples. Also include or link reference material that might help! Thanks.
3
votes
4answers
165 views

The structure of test logs?

I am working on a project which involves documenting test logs. I want to know the structure of test logs (what should be included).
3
votes
2answers
159 views

What are acceptable time to spend and taks to be done analysing a defect as a tester?

Morning, what are an acceptable time and tasks to analyse a defect as a tester? Following situation: As our QA teams waits for a new client version and our preparations are quite done we had a look ...
3
votes
3answers
128 views

Is a Final Release Report a good way to communicate results?

I'm getting ready to release the next version of our software. In the past when the release is ready to go I will send around an email saying "release xxx is done" and include a basic set of release ...
3
votes
3answers
240 views

Bug reporting on documents

In my job I have to test Markdown documents. This includes looking for bugs related to: The procedure described in the document Typos, grammar mistakes, etc. The HTML version of the document Right ...
2
votes
6answers
1k views

Validation and verification in CMMi, ISO, IEEE. What should I refer to?

Working on my master thesis, today I found this site (I previously asked on programmers) so I hope you will not mind if I ask here to get more great answers. The thing is that I have to classify ...
2
votes
4answers
101 views

What software do you use to write release notes? [closed]

We want to move from MS Word to a web-based tool for our release notes. What software do you use? Ideally, we want to use the same tool to track bugs and generate the Release Notes. Thanks
2
votes
2answers
55 views

How to document my page object

What are some efficient and non-tedious ways to document my page objects? What I first did was take screen shots of my screen and label each page object to its corresponding web element but this ...
2
votes
2answers
100 views

Good resource for a test case document

I am wondering if there is a template for test case documentation online, preferably on excel. After searching for some useful information, I am not finding anything I like. I have written these by ...
2
votes
1answer
80 views

What kind of documentation do I need for testing new site against old?

I'm a Product Manager, not ideally tasked with but enjoying directly managing a new SQA team. AdHoc testing has covered a lot of quick ground, but I think it's now time to implement better ...
2
votes
2answers
59 views

Handling of Test Documents throughout Retests

Community, I'm currently doing development and tests for a Windows Desktop Application that plays together with some PLCs. One of my main tasks is to perform Functional Tests on a System Level for ...
2
votes
1answer
63 views

Creation of bug specification

I am currently testing a piece of vehicle management software. To kill two birds with one stone I am also going to create a user guide, alongside a similar document to point out and describe bugs. ...
1
vote
2answers
8k views

Writing Test cases in an agile approach

I use to develop test cases in the traditional way by defining the following for each test senario:- Test case name. “View Current Transaction” Pre-condition. Valid “Username & password” The ...
1
vote
2answers
666 views

What is UAT Protocol?

I've just wrote an UAT script specifying all of the use cases step by step (quite standard). However the customer is asking us for a UAT protocol and we have no clue on what he means by that. Anyone ...
1
vote
2answers
133 views

Best documentation to start with before starting Automation

We are integrating with an out sourcing team to start automating our regular test cases What is the best type of documents to explain our scenarios to the other team? we want to explain to them how ...
1
vote
1answer
3k views

Is Selenium 2 WebDriver JavaDoc API available offline?

Can I get a offline copy/archive of Selenium Webdriver Javadoc API which is available here so that I can bind the same to my Eclipse IDE for offline use? A ready-made HTML archive will be ...
1
vote
1answer
65 views

Lean documentation

Currently I am the only one responsible for the quality of the company's products, so when I get a requirements elicitation, I don't have time to do all the documentation, i.e. I get the LR and I've ...
1
vote
2answers
172 views

Inputs in test case clarification

In a test case, what qualifies as an input? Must it be what the tester types as input with their keyboard? IEEE 829-2008 only lists values, constants, transaction files, and their storage locations ...
1
vote
2answers
67 views

How do you document the PROCESS of fixing bugs independent of product/technology

It seems relatively easy to find bug tracking tools, but I'm looking for a way to document the process of fixing the defects that will track things such as: who is working on it, being sure that it ...
1
vote
1answer
77 views

What suggestions can people give about creating organized test cases?

Right now my company uses a large excel spreadsheet to create 'tests' for surveys we develop. Each column is one test through the survey. Each field is the answer you should choose. While this ...
1
vote
1answer
50 views

When creating a manual test script, can I reference other test scripts?

I need to write and execute some test scripts and provide evidence on a short time-frame. The basic scenario revolves around creating work requests in one system, and approving or rejecting them in ...
1
vote
1answer
281 views

Where can I find examples of software development and testing documentation?

I am looking for real-life working examples of documentation of a software development project (including testing). According to some standard, there are a couple of documents involved in software ...
1
vote
2answers
105 views

Decision to separate or combine Test Procedure and Test Case documentation

Background: Combining separate Test Procedure and Test Case documentation has advantages, but so does leaving them separate. IEEE std. 829 mentions system level of complexity as a contributing factor ...
1
vote
0answers
33 views

Apigen Netbeans [closed]

I tried used apigen for generate documentation from netbeans i followed all steps from page but when i do this i found a file.txt with things that i do not understand. I did not find a file.html with ...
1
vote
1answer
67 views

Reusing Data Definitions Across Multiple Forms

We're building requirements for some data input that has four different variations. There are some common fields across all four variations, and then some additional fields based on form type. For ...
0
votes
1answer
33 views

Selenium support (native and its bindings)

As far as I am aware, Selenium is an active project that is being developed and heavily used. However, when I look at the defects list on their official site, it looks like there are thousands of ...
0
votes
3answers
70 views

Where are good places to demo + share + show off what I'm working on?

I haven't found many resources where people show-and-tell the quality and testing-related projects they're working on. I don't see the same drive to innovate in the SQA community as I do in others. Is ...
0
votes
1answer
27 views

How to write technical documentation for Android Project? [closed]

I have created SRS document, and little Design document. Now, i am struggling to create Technical document which must be used as Reference for new developers when we assign update task to them. What ...
0
votes
5answers
468 views

Is it recommended to document how selenium automation tests are laid out?

The automation code I'm working with was written by several people before me. It's messy, complex, etc. There are barely any comments within the code. It takes me an extremely long time to figure out ...
0
votes
1answer
183 views

Standards for documenting input validation rules & system/error messages?

I'm building an application at the moment and something I want to do is document input validation rules and system/error messaging in a readable format so that it can be used for SIT/UAT etc. ...
-2
votes
2answers
77 views

how to present a documentation from user point of view? [closed]

I am preparing documentation on a software product for my company. Can anyone provide me suggestions for preparing a better document will help me a lot. Are screenshots necessary while preparing the ...