Requirements and Specifications for eZ Platform v2.x Development, in Markdown format
Latest commit 44c7501 Feb 8, 2017 @DavidLiedle DavidLiedle committed on GitHub Merge pull request #27 from DavidLiedle/repo-meta
Repo meta, template stubs and drafts

eZ Platform Requirements and Specifications Repository

Welcome to our new Requirements and Specifications (specs, for short) repository for eZ Platform development! eZ's Product Management team shares our work here, storing specs in Markdown documents for easy access. You may also find PDF files, Word Docs, BDD, RAML... :)


Do you have some ideas you'd like to contribute to a spec? It's easy! Simply fork this repository to your own GitHub account, checkout the branch you want to work with, then make your own branch (with a useful and informative name) from that. Make any changes or additions you'd like to propose, add, and commit. Push to your fork, then send a Pull Request back here to the branch you're targeting where we can discuss things together.

Target the Right Version!

The master branch will always represent eZ's current recommended product. Right now, that's eZ Platform v1.7 LTS. If you submit a Pull Request to master, you're asking for the requirements and specifications to be updated for v1.7 (probably not the one you meant, unless your Pull Request is just fixing a typo for that version).

Start by checking out the branch representing the version you do want to work with, and send your Pull Request back to that branch so it goes into the right place. For example, if you want to propose edits to the requirements and specifications for v1.9, you would make your branch based on this repository's v1.9 branch: and send your PRs there.


If you'd like a good Markdown editor that can import, edit, and save MD files on GitHub, check out


Our Product Management (PM) team is using GitHub Projects to track our work in this repository, so you can follow along too:

We have a label, "epic", to signify epics we're working on. You can track along as the issues are moved through the different columns in the boards. Click an issue to view and comment.

About eZ Platform

eZ Platform is the Symfony CMS, written in PHP and released under the GPLv2 open source license.

eZ Platform Enterprise Edition is available with additional features and full support from If you are an existing eZ Enterprise customer and would like to report an issue with the Enterprise Edition, please use:


GitHub has a ridiculously easy-to-use integration with Jekyll to convert Markdown to HTML (heck, it goes even further and makes a website from Markdown files). Here's where we're playing with that functionality: GitHub Pages Site for eZ Platform v2 Specs

Copyright (c) 1999-2017 eZ Systems Repository contents are licensed under the Creative Commons Attribution-ShareAlike 4.0 International Public License