Skip to content

Commit

Permalink
Merge pull request ezsystems#27 from DavidLiedle/repo-meta
Browse files Browse the repository at this point in the history
Repo meta, template stubs and drafts
  • Loading branch information
DavidLiedle committed Feb 8, 2017
2 parents ac33d3f + a4192a2 commit 44c7501
Show file tree
Hide file tree
Showing 9 changed files with 126 additions and 0 deletions.
10 changes: 10 additions & 0 deletions .editorconfig
@@ -0,0 +1,10 @@
; top-most EditorConfig file
root = true

; Unix-style newlines
[*]
end_of_line = LF

[*.md]
indent_style = space
indent_size = 2
1 change: 1 addition & 0 deletions CONTRIBUTING.md
@@ -0,0 +1 @@
# Contributing to this Repository
1 change: 1 addition & 0 deletions CONTRIBUTORS.md
@@ -0,0 +1 @@
# The contents of this repository are brought to you by:
16 changes: 16 additions & 0 deletions COPYRIGHT
@@ -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.
11 changes: 11 additions & 0 deletions _templates/README.md
@@ -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.
2 changes: 2 additions & 0 deletions _templates/feature_requirements_template.md
@@ -0,0 +1,2 @@
# Feature Requirements Template
TBD
81 changes: 81 additions & 0 deletions _templates/feature_specification_template.md
@@ -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*
2 changes: 2 additions & 0 deletions _templates/feature_use_cases_template.md
@@ -0,0 +1,2 @@
# Feature Use Cases Template
TBD
2 changes: 2 additions & 0 deletions _templates/pull_request_template.md
@@ -0,0 +1,2 @@
# Pull Request Template
TBD

0 comments on commit 44c7501

Please sign in to comment.