forked from ezsystems/specs
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request ezsystems#27 from DavidLiedle/repo-meta
Repo meta, template stubs and drafts
- Loading branch information
Showing
9 changed files
with
126 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
; top-most EditorConfig file | ||
root = true | ||
|
||
; Unix-style newlines | ||
[*] | ||
end_of_line = LF | ||
|
||
[*.md] | ||
indent_style = space | ||
indent_size = 2 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
# Contributing to this Repository |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
# The contents of this repository are brought to you by: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
COPYRIGHT NOTICE: Copyright (C) 1999-2017 eZ Systems AS, eZ Systems US Inc. | ||
SOFTWARE LICENSE: GNU General Public License v2.0 | ||
NOTICE: | ||
This program is free software; you can redistribute it and/or | ||
modify it under the terms of version 2.0 of the GNU General | ||
Public License as published by the Free Software Foundation. | ||
|
||
This program is distributed in the hope that it will be useful, | ||
but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
GNU General Public License for more details. | ||
|
||
You should have received a copy of version 2.0 of the GNU General | ||
Public License along with this program; if not, write to the Free | ||
Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, | ||
MA 02110-1301, USA. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
# \_templates Folder Contents | ||
|
||
The files in this folder are templates: starting points for you to create a | ||
new requirements, specification, or use case. | ||
|
||
# Usage | ||
|
||
Example: To create a new feature specification, copy the contents of the | ||
feature_specification_template.md file, save it in the folder related to the | ||
feature (e.g., `/eZ Platform/PlatformUI/`), and modify its example content to | ||
reflect your desired/proposed features. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
# Feature Requirements Template | ||
TBD |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,81 @@ | ||
#Page title | ||
|
||
## Introduction | ||
*This part should explain the overall goal of the feature* | ||
|
||
### Goal and Scope | ||
|
||
*Discuss the scope of the document and how it accomplishes its purpose.* | ||
|
||
|
||
### Assumptions & Constraints | ||
|
||
*Provide a list of assumptions and/or constraints that are preconditions to the preparation of the specification document.* | ||
|
||
*Assumptions are future situations beyond the control of the project, whose outcomes influence the success of a project. Constraints are boundary conditions on how the system must be designed and constructed. Examples include legal requirements, technical standards, strategic decisions.* | ||
|
||
## Product Marketing Messaging Framework | ||
|
||
For | (product, solution, offering) | ||
:------------ |:------------- | ||
| *Specify the product(s) the feature should be in e.g.: eZ Platform, eZ Studio, eZ Personalization Service...* | ||
**What** | (purpose) | ||
| *Explain the purpose of the feature* | ||
**How** | (what does it do / differentiators) | ||
| *Explain how it is done, how it differentiate from other way to do* | ||
**Who** | (target audience) | ||
| *Define the persona(s) that will use the feature* | ||
**Why** | (value proposition / business value) | ||
| *Identify business value, this will help product marketing* | ||
|
||
|
||
## Functional Specifications - User stories | ||
*Identify here the user stories that we want to make possible, group them by priority. We can go with only the MVP but it is good to have some perspective on what else could come.* | ||
*Dont forget user story related to extension and integration, such as "As a developer I want to be able to create my custom field type".* | ||
|
||
### User Story subset 1 - minimum VALUABLE product | ||
|
||
User Story ID | User Story Description | ||
:------------ |:------------- | ||
1 | ``` As a user I want to do something with the software ``` | ||
2 | ``` As a user I want to do something else with the software ``` | ||
|
||
|
||
### User Story subset n - minimum VALUABLE product | ||
|
||
User Story ID | User Story Description | ||
:------------ |:------------- | ||
3 | ``` As a user I want to do more thing with the software ``` | ||
4 | ``` As a user I want to do even more thing with the software ``` | ||
|
||
|
||
## Functional Specifications - Detailed behaviors | ||
*Specify here the detailed behaviors using user interface wireframe, business logic specification, business logic, error handling, messages. Behavior should as much as possible come with identified behavior scenario to develop and test, using BDD.* | ||
|
||
### User story n - As a user I want to do xyz | ||
*detailed specifications and wireframe here > We should aim for a set of BDD at the end for each user story.* | ||
|
||
BDD ID | BDD Scenario | ||
:------ |:------------- | ||
3 | Given [Context] <br /> When [Event Occur] <br /> Then [Outcome] | ||
4 | Given [Context] <br /> When [Event Occur] <br /> Then [Outcome] | ||
|
||
|
||
## Non-Functional Requirements | ||
### Performance / Scalability / Caching | ||
*Add here any consideration on performance* | ||
|
||
### System Design | ||
*Add here any consideration on system design* | ||
|
||
### Locales / Translations | ||
*Add here any consideration on localization* | ||
|
||
### Usability / GUI | ||
*Add here any consideration on Usability* | ||
|
||
### Security | ||
*Add here any consideration on Security* | ||
|
||
### Documentation | ||
*Add here any consideration on Documentation* |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
# Feature Use Cases Template | ||
TBD |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
# Pull Request Template | ||
TBD |