owen-it / laravel-auditing-doc

Laravel Auditing Documentation
http://laravel-auditing.com
56 stars 62 forks source link

Documentation #66

Closed crashkonijn closed 5 years ago

crashkonijn commented 5 years ago

Hi there!

I've been looking for a way to create documentation similar to yours and I've been trying to search for a package which can do this but I've been unable to find a good one.

My question is, did you make the documentation yourself or are you indeed using something to generate it?

Thanks in advance!

quetzyg commented 5 years ago

The documentation (as you can see from this repo) are just a bunch of markdown files with links to each other. You can check the actual layout/webpage here.

Feel free to steal it.

@anteriovieira is probably a better person to answer more technical questions about that last repo, than I am.

anteriovieira commented 5 years ago

Hi @crashkonijn

The documentation is stored in the owen-it/laravel-auditing-doc repository in markdown format as the @quetzyg mentioned.

My question is, did you make the documentation yourself or are you indeed using something to generate it?

Our application is just a clone of the reposiorio laravel/laravel.com with some modifications. We do not use third party packages to generate the site, we just read the markdown and transform it into html. You can also make the clone of the repository owen-it/laravel-auditing.com and make your modifications.

The only thing I did was point the directory to the repository, so when we update the documentation it automatically reflects on the site.

     // laravel-auditing.com/app/helpers.php
     function base_raw_path($path = '') 
     { 
         return env('RAW_FILE_URL') . $path; 
     } 

RAW_FILE_URL = https://github.com/owen-it/laravel-auditing-doc

Now if you want to use proper tools for building documentation I would recommend the following:

crashkonijn commented 5 years ago

Hi guys,

Thanks for answering my question, that will definitely help!