This is a temporary repository for developer documentation about the SilverStripe framework, currently located at [http://doc.silverstripe.org].

Note: This repository is used for collaboration during the restructuring phase, and will move elsewhere afterwards

• Mailinglist
• Planning wiki page
• TODO list and bugtracker

• Documentation questions: Ingo Schommer (ingo at silverstripe dot com)
• Markdown Conversion: Mark Stephens (mark at silverstripe dot com)

You'll need to install git, which is quite straightforward on most operating systems.

To edit the files, you just need a text editor. They're written in Markdown, which many editors have syntax highlighting for (e.g. through the Textmate plugin).

To preview changes, you will need to run a local webserver capable of running SilverStripe. XAMPP is a good option.

• master: The new markdown files - please edit in here
• scripts: Helper scripts for conversion and file management

You can fork this project within github, as described on help.github.com. This fork will show up on your own github profile, and can be checked out to your local machine. You don't need a webserver on there, or run any project-specific scripts. Merging back pull requests can either be done straight on github (for simple cases), or through git pull commands (see guide).

Its important to read the documentation guidelines, in order to keep a consistent writing and formatting style. We use a customized version of Markdown and Markdown Extra called "ss-markdown"

The preview/ directory contains a SilverStripe site that you can visit to preview what the documentation site will look like. You will need to create a _ss_environment.php file in the root of your project or in the directory above.

Here is a minimal one. Alter the database settings to suit your set-up.

<?php
define('SS_ENVIRONMENT_TYPE', 'dev');
define('SS_DATABASE_SERVER', 'localhost');
define('SS_DATABASE_USERNAME', 'root');
define('SS_DATABASE_PASSWORD', '');

If you have check out silverstripe-doc-restructuring into your webroot, you should be able to visit a URL such as http://localhost/silverstripe-doc-restructuring/preview/ to preview your changes.

After pushing your changes to your own github fork, you can send us pull requests.

The following scripts should no longer be used, as they were designed for an earlier stage in the project.

Note: This is only possible by SilverStripe staff.

scp -P 2222 -R <username>@doc.silverstripe.org:/sites/ss2doc/www/assets/data/pages/ input/

cd scripts
php TranslateSSDocs.php