You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+22-7Lines changed: 22 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,10 +4,27 @@
4
4
5
5
We all document our code with PHP [DocBlocks](https://en.wikipedia.org/wiki/PHPDoc) but we never seem to actually generate the documentation and add it to our project. Why? It simply takes too much time (over a minute), so we put it off till later, and later never comes.
6
6
7
-
But with PHPFUI\InstaDoc, you can document your site in about a minute (OK, maybe 5). The steps involved:
8
-
* Install PHPFUI\InstaDoc via Composer
9
-
* Run installation script
10
-
* Create document page
7
+
But with PHPFUI\InstaDoc, you can document your site in about a minute (OK, maybe 2). The steps involved:
8
+
* Install PHPFUI\InstaDoc via Composer (30 seconds)
9
+
* Run installation script (30 seconds)
10
+
* Create document page (1 minute, 4 lines of code)
11
+
12
+
Two minutes to usable documentation with the following features:
13
+
14
+
## PHPFUI\InstaDoc Features
15
+
* Always up to date, even with code that is not yet checked in
16
+
* Documents all projects loaded via Composer automatically
17
+
* Add any local repo directories
18
+
* Remove any Composer project you don't care about
19
+
* Custom ordering of types (const, static, public, protected, etc.)
20
+
* Alphabetized everything, no more searching unalphabetized pages!
21
+
* Support for markdown and custom markdown pages
22
+
* Quick access to highlighed PHP source with user selectable highlighting
23
+
* Quick access to the file's git history for the local repo
24
+
* Ability to generate static html files for high volume sites
25
+
* 4+ line config compatible with all PHP frameworks, or standalone
26
+
* Completely configureable UI if you don't like the default
27
+
* Uses [Foundation CSS framework](https://get.foundation) for a great experience on mobile
11
28
12
29
### Install PHPFUI\InstaDoc
13
30
composer require phpfui/InstaDoc
@@ -17,7 +34,7 @@ Once installed, you need to run an installation script to copy static files to t
Example: php vendor/phpfui/InstaDoc/install.php public/PHPFUI will add all needed files to public/PHPFUI, which will avoid any conflicts with your current files. You can specify any directory, but PHPFUI is recomended to keep things simple.
37
+
Example: php vendor/phpfui/instadoc/install.php public/PHPFUI will add all needed files to public/PHPFUI, which will avoid any conflicts with your current files. You can specify any directory, but PHPFUI is recomended to keep things simple.
21
38
22
39
### Create Document Page
23
40
PHPFUI\InstaDoc does not reply on any framework and can run on a standalone page. It is recommended that you do not make your documentation public, as PHPFUI\InstaDoc will display PHP source files. How you restrict access to the page is up to you. The following does not restrict access and is simply an example:
@@ -35,9 +52,7 @@ That is it. You are done!
35
52
36
53
#### To Do List:
37
54
38
-
* Generate static files
39
55
* Create Doc page (the whole point, but do the easy stuff first!)
0 commit comments