Added Sami configuration file and .gitattributes that makes Composer ignore non-essentials when preferring distribution;

All documentation generators now generate files in "Reference/{{generator}}/Doc".

Author: boenrobot

.gitattributes

@@ -0,0 +1,15 @@
+*.php text eol=lf
+/docs export-ignore
+/examples export-ignore
+/tests export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+.scrutinizer.yml export-ignore
+.travis.yml export-ignore
+README.md export-ignore
+README export-ignore
+CREDITS export-ignore
+RELEASE-* export-ignore
+package.xml export-ignore
+packagexmlsetup.php export-ignore
+extrasetup.php export-ignore

docs/apigen.neon

@@ -1,6 +1,6 @@
 source: ../src
 
-destination: PEAR2_Net_RouterOS__ApiGen_Documentation
+destination: Reference/ApiGen/Doc
 
 extensions: php
 

docs/doxygen.ini

@@ -52,7 +52,7 @@ PROJECT_LOGO           =
 # If a relative path is entered, it will be relative to the location 
 # where doxygen was started. If left blank the current directory will be used.
 
-OUTPUT_DIRECTORY       = "PEAR2_Net_RouterOS__Doxygen_Documentation"
+OUTPUT_DIRECTORY       = "Reference/Doxygen/Doc"
 
 # If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 
 # 4096 sub-directories (in 2 levels) under the output directory of each output 

docs/phpdoc.dist.xml

@@ -3,7 +3,7 @@
     <title>PEAR2_Net_RouterOS documentation</title>
     <parser>
         <default-package-name>PEAR2_Net_RouterOS</default-package-name>
-        <target>PEAR2_Net_RouterOS__PhpDocumentor_Cache</target>
+        <target>Reference/PhpDocumentor/Cache</target>
         <extensions>
             <extension>php</extension>
         </extensions>
@@ -12,6 +12,6 @@
         <directory>../src/PEAR2/Net/RouterOS</directory>
     </files>
     <transformer>
-        <target>PEAR2_Net_RouterOS__PhpDocumentor_Documentation</target>
+        <target>Reference/PhpDocumentor/Doc</target>
     </transformer>
 </phpdoc>

docs/sami.php

@@ -0,0 +1,20 @@
+<?php
+use Sami\Sami;
+use Sami\Version\GitVersionCollection;
+use Symfony\Component\Finder\Finder;
+
+return new Sami(
+    Finder::create()
+        ->files()
+        ->name('*.php')
+        ->exclude('docs')
+        ->exclude('examples')
+        ->exclude('tests')
+        ->in($dir = dirname(__DIR__)),
+    array(
+        'title'                => 'PEAR2_Net_RouterOS documentation',
+        'build_dir'            => __DIR__ . '/Reference/Sami/Doc',
+        'cache_dir'            => __DIR__ . '/Reference/Sami/Cache',
+        'default_opened_level' => 1
+    )
+);