Clean old & unuseful files

[Progi1984]

Some old files created by @maartenba could be deleted. No ?

phpdoc-home.ini 
phpdoc.ini
setpath.bat
start_shell.bat
Documentation/assets/*
Build/old/*

A file is duplicate

Diff between README.md and readme.md

And others which contains samples and tests for JAMA

Classes/PHPExcel/Shared/JAMA/examples
Classes/PHPExcel/Shared/JAMA/tests

[Progi1984]

@MarkBaker Is it possible to not include help for JAMA ?

[maartenba]

The old files can go, Documentation/assets may contain some that we want to keep (basically architectural schemas)

[Progi1984]

@maartenba But with PHPDoc, normally, we have a class hierarchy (like that : http://demo.phpdoc.org/Responsive/graph_class.html) which can replace that ?

[maartenba]

Indeed. In that case, I think it's safe to remove those files

[MarkBaker]

The assets images appear in the documentation and are a lot easier to read because they show just the few relevant elements from the phpdoc mapping, in the context of the documentation. As such, I think they should remain.

[Progi1984]

@MarkBaker : Are they uptodate ?

[MarkBaker]

The ones I'm looking at are up to date, though they may not all be.... I'll check later. Most are simply xml files, or images created from those xml files.
It might be an idea to switch them to a different (more generic) format like GraphViz which would make them easier to edit.

[Progi1984]

In the directory, we can include a phpdoc of PHPExcel correctly generated with graphviz (the render is perfect, i try it this morning)

OR

We can create a branch (or a repo) dedicated to the doc (including Users documentation and PHPDoc for developpers) which permit to answer in part to the bug GH-#1

[Progi1984]

@MarkBaker In this zip (http://dl.free.fr/vqf8kX2if), there is the generation of PHPExcel's documentation with PHPDoc.

You can see the generated graphviz.

[Progi1984]

@MarkBaker Another idea : I create GitHub Pages for managing pages for PHPExcel (GH #17) which create a branch gh-pages... and in a directory of this branch, we store a generation of PHPExcel documenation with PHPDoc...

This permits developers to see it online easily and solve in part the GH #1

[Progi1984]

With commits f2803e8 and 9907ef9, @MarkBaker has cleaned JAMA.

[Progi1984]

Could we move documentation in phpoffice.github.com repo ?

[Progi1984]

@MarkBaker & @maartenba : What do you think about putting documentation in a dedicated branch, or a dedicated repo ? And why not in repo https://github.com/PHPOffice/phpoffice.github.com which manages http://phpoffice.github.com/ ?

[maartenba]

Sounds good

[Progi1984]

@maartenba for which one ? 😜

[maartenba]

Both :-)