diff options
author | Pedro Alvarez <pedro.alvarez@codethink.co.uk> | 2016-02-29 20:18:23 +0000 |
---|---|---|
committer | Baserock Gerrit <gerrit@baserock.org> | 2016-02-29 20:18:23 +0000 |
commit | 51196d28f1cbfba2f4289175d53ae80e404c0425 (patch) | |
tree | 22e6c9e6f0f0b4b372a8b318831869a4cf54b8b4 /index.mdwn | |
parent | 8a32abdedbd1c203100cfe10018356f90be10412 (diff) | |
parent | 29457450049b50dca16b33d65ef6dfff2d92d27c (diff) | |
download | spec-51196d28f1cbfba2f4289175d53ae80e404c0425.tar.gz |
Merge "Allow rendering the spec as a website"
Diffstat (limited to 'index.mdwn')
-rw-r--r-- | index.mdwn | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/index.mdwn b/index.mdwn new file mode 100644 index 0000000..7f5dd63 --- /dev/null +++ b/index.mdwn @@ -0,0 +1,42 @@ +# Welcome to the Baserock Project's documentation! + +Baserock is about improving how we build, integrate and maintain collections of +software. + +For more information, see these pages on the wiki: + + - <http://wiki.baserock.org/overview/> + - <http://wiki.baserock.org/moving-parts/> + +## The Baserock definitions format + +The Baserock definitions format is a way of specifying components that +need to be built, deployed and distributed in some way. + +The current format is described in the [Spec](spec) section. + +Historical changes are listed in the [Changelog](changelog). + +To propose changes to the version, please submit patches against 'master' of +the [spec.git repo](http://git.baserock.org/cgit/baserock/baserock/spec.git). +See the [contributing](http://wiki.baserock.org/contributing/) page for +information. If you send a patch to Gerrit for a major change, please notify +the baserock-dev@baserock.org mailing list too. + +The wiki has more [information on the Definitions +format](http://wiki.baserock.org/definitions/), including a [comparison with +other +formats](http://wiki.baserock.org/definitions/comparison-with-other-formats), +and a [style guide](http://wiki.baserock.org/definitions/best-practices). + +## The Baserock reference definitions + +We maintain a collection of definitions describing how to build lots of popular +free software components. These are in a repository at +[git.baserock.org/baserock/baserock/definitions](http://git.baserock.org/cgit/baserock/baserock/definitions.git/tree/). + +When modifying or defining your own Baserock systems, normally you will 'fork' +this repository and use Git tooling to keep your changes in sync with ours. + +It's also possible to write definitions completely independently of ours, if +you want. |