Questions tagged [documentation]
The documentation tag is for questions about documentation of processes and projects in the field of project management.
117 questions
1 vote
4 answers
409 views
What are the alternatives to using user stories for documenting system features?
We are an inventory management system product company. We used, and still use, agile user stories for writing requirements and communicating them to the development team. During the initial stages we ...
- 11
0 votes
1 answer
95 views
What is the name of the practice of mapping problems and their inter connected relationships?
Some time ago I saw an article about a model where the different problems or dysfunctions of a team (or company) where identified. Then, once the problems are identified, the relationship between them ...
- 8,714
0 votes
4 answers
755 views
What is the document that must be provided by a client before contracting?
We are a startup company where we work on software projects. To effectively manage our client's projects, I wonder what document we must ask the client to provide us before we both sign the contract. ...
1 vote
2 answers
566 views
How do you get multiple separate software development teams to unify their best practices? [closed]
We have several reasonably well functioning small software development teams working on different areas of the business. Each team has its own lead and roughly 8 other developers on it. The teams have ...
- 11
2 votes
3 answers
250 views
What is the usual process of summarizing the specification documents for review and comparision
My engineering team is gearing up for a bidding on a public project, where the specifications document is huge (~500 pages). I would like to break it down clause by clause in a spreadsheet and then ...
1 vote
3 answers
267 views
Does the client have the privilege to force the vendor on a Business Requirement Document (BRD) format?
Would like to ask: Does the client project manager have the privilege to force the vendor who is selling a SaaS system to use some specific Business Requirement Document (BRD) format and force them to ...
4 votes
5 answers
518 views
How to approach this: A team member with Good technical skills but weak in other areas
My team consists of 7 people and I am the project manager. A teammate of mine has good technical skills, but he struggles with documenting the results of his work and delivering documents to the next ...
- 143
0 votes
1 answer
54 views
Project management with MS Teams and MS Sharepoint in a large enterprise
Before the MS Teams "era", documents for (larger) projects existed as folder structures on huge storages as "master system for documentation". Today, you have got many Sharepoint ...
- 291
0 votes
2 answers
104 views
Example layouts / standards for filesystem folder names in project documentation?
I am new to project management and would like to know, where is a standard either a best practice to define name of project folder tree in the filesystem, or SharePoint. Maybe there is something ...
- 291
0 votes
1 answer
188 views
ISO 9001: a company does not store the customer contracts properly. What ISO requirement is being violated?
As a part of my quality improvement activities, I wanted to fix some of the issues in our company (like contracts not being stored properly). I thought there will be a clear requirement/clause in ISO ...
- 363
1 vote
1 answer
101 views
Defining a unified terminologies for a product?
When my team works on a project they usually come up with multiple names for the same thing. For example, if we have an Apartment entity, you might find some referring to it as an Apartment and others ...
0 votes
1 answer
119 views
How to automate inclusion of confluence design docs in Requirement traceability report on Jira
If an organization is regulated, it has to pass the audit and show that it has implemented a "requirements traceability". This means it has documented the path from a specific requirement to ...
- 131
1 vote
2 answers
182 views
User story/acceptance criteria for page with a lot of content
I've recently been tasked with writing user stories and acceptance criteria (GWT) and would like to ask for advice since I'm relatively new to such approach. A bit of context: Project is a web app ...
- 11
1 vote
2 answers
872 views
Is Change log the same as Change Request log? Aren't there other changes than CRs?
Browsing through some PM topics, I have realized that most sources use the Changelogs and Change Request logs interchangeably. But is that correct? I am not a PM, but aren't there often changes that ...
- 363
2 votes
1 answer
111 views
Design Specification Ownership: how to protect it from obfuscation and excessive adjustments on Enterprise project?
By Design Specification Ownership I mean that nobody can read it right as expected except the author/ideologist/creator. If a person works on the same project for a long time and keeps the same ...
- 303