Skip to content

Commit 18237ac

Browse files
(v2) README updated - screenshots added
1 parent 1795a67 commit 18237ac

File tree

1 file changed

+35
-40
lines changed

1 file changed

+35
-40
lines changed

README.md

Lines changed: 35 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,6 @@
1-
# MODERNIZATION OF UI RENEWAL is in PROGRESS https://github.com/rakutentech/laravel-request-docs/pull/103
2-
We request to have code freeze on new pull requests, and request to please submit issues with regards to the UI that we can cover in the new UI renewal.
3-
41
<p align="center">
52
<a href="https://github.com/rakutentech/laravel-request-docs">
6-
<img alt="Laravel Request Docs" src="https://imgur.com/9eDTUaI.png" width="360">
3+
<img alt="Laravel Request Docs" src="https://imgur.com/2NvLKn2.png">
74
</a>
85
</p>
96

@@ -23,13 +20,18 @@ We request to have code freeze on new pull requests, and request to please submi
2320

2421
## Features
2522

23+
- Light and Dark mode
24+
- Automatic rules fetching from injected Request and by regexp
2625
- Automatic routes fetching from Laravel Routes
27-
- Automatic rules fetching from injected Request
26+
- Support for Laravel logs
27+
- Support for SQL query and query time
28+
- Support for HTTP response time and memory consumption
2829
- Support for Authorization Headers
29-
- Support for SQL query, response time and memory consumption by request on Laravel
30-
- Intelligent auto request builder using ``faker.js``
3130
- Display extra documentation using markdown
31+
- Uses localstorage to save history of previous requests
32+
- Added filters to sort, group and filter routes by methods, controllers, middlewares, routes (also see Roadmap 2.x)
3233
- Export laravel API, routes, rules and documentation to Postman and OpenAPI 3.0.0
34+
3335
# Read on Medium
3436

3537
Automatically generate api documentation for Laravel without writing annotations.
@@ -64,18 +66,6 @@ php artisan vendor:publish --tag=request-docs-config
6466

6567
View in the browser on ``/request-docs/``
6668

67-
Generate a static HTML and open api specification
68-
69-
```php
70-
php artisan lrd:generate
71-
```
72-
73-
Docs HTML is generated inside ``docs/``.
74-
75-
## Just want Open API
76-
77-
View in the browser on ``/request-docs/?openapi=true``
78-
7969
# Design pattern
8070

8171
In order for this plugin to work, you need to follow the design pattern by injecting the request class inside the controller.
@@ -85,25 +75,31 @@ For extra documentation you can use markdown inside your controller method as we
8575

8676
# Screenshots
8777

88-
**Generated API documentation**
78+
**Light and Dark Modes**
79+
80+
Light mode
81+
![Preview](https://imgur.com/2s1SrKm.png)
8982

90-
![Preview](https://imgur.com/8DvBBhs.png)
83+
Dark mode
84+
![Preview](https://imgur.com/76sk7Lq.png)
9185

9286
**Try API**
9387

94-
![Preview](https://imgur.com/kcKVSzm.png)
88+
Uses localstorage to save history of previous requests and request headers
89+
90+
![Preview](https://imgur.com/q3d7pw2.png)
9591

9692
**SQL query profile**
9793

98-
![Preview](https://imgur.com/y8jT3jj.png)
94+
![Preview](https://imgur.com/8PLLlHv.png)
9995

10096
**Response profile**
10197

102-
![Preview](https://imgur.com/U0Je956.png)
98+
![Preview](https://imgur.com/fd09jw1.png)
10399

104-
**Customize Headers**
100+
**Settings to sort, group and filter**
105101

106-
![Preview](https://imgur.com/5ydtRd8.png)
102+
![Preview](https://imgur.com/qHq1pjr.png)
107103

108104

109105
# Extra
@@ -114,29 +110,22 @@ Example of using it in controller
114110
```php
115111
/**
116112
* @lrd:start
117-
* #Hello markdown
118-
* ## Documentation for /my route
113+
* Hello markdown
114+
* ## Free text to write documentation in markdown
119115
* @lrd:end
120116
*/
121117
public function index(MyIndexRequest $request): Resource
122118
{
123119
```
124120

125-
# Custom Params
126-
127-
You write extra params with rules with @QAparam comment line
121+
# Params not in rules
128122

129-
```php
130-
/**
131-
* @QAparam search string
132-
*/
133-
public function index(MyIndexRequest $request): Resource
134-
{
135-
```
123+
You write extra params with rules with @LRDparam in comment line as one line
136124

137125
```php
138126
/**
139-
* @QAparam search string nullable max:32
127+
* @LRDparam username string|max:32
128+
* @LRDparam nickaname string|nullable|max:32
140129
*/
141130
public function index(MyIndexRequest $request): Resource
142131
{
@@ -161,6 +150,12 @@ Fixing lints
161150
./vendor/bin/php-cs-fixer fix config/
162151
```
163152

153+
# Roadmap for v2.x
154+
155+
- [DONE] UI renewal
156+
- [WIP] Introduce groupby controller names, routes, middlewares
157+
- [WIP] Introduce fetch rules from PHP doc annotations
158+
164159
# Changelog
165160

166161
- Initial Release
@@ -179,5 +174,5 @@ Fixing lints
179174
- v1.22 Boolean|File|Image support
180175
- v1.23 Bug fix for lrd doc block #76
181176
- v1.27 A few fixes on width and added request_methods
182-
- v1.30 Minor search box filter added
177+
- v2.0 UI Renewal to React static
183178

0 commit comments

Comments
 (0)