View Issue Details
ID | Project | Category | View Status | Date Submitted | Last Update |
---|---|---|---|---|---|
0001808 | Xdebug | Documentation | public | 2020-06-23 20:03 | 2021-03-15 15:10 |
Reporter | derick | Assigned To | derick | ||
Priority | normal | Severity | feature | Reproducibility | have not tried |
Status | closed | Resolution | no change required | ||
Target Version | 3.0dev | ||||
Summary | 0001808: Improve step debugging documentation and flow | ||||
Description | https://twitter.com/EricMueller/status/1274593839752327168 Cool, I submitted a small change. So question - on the file I edited (https://github.com/xdebug/xdebug.org/blob/xdebug3/html/docs/include/features/remote.html), it starts with "Xdebug interacts with IDEs to provide step debugging functionality" and then the 1st header is "Configuring Step Debugging" --would it be better/more direct to make this "Configuring Xdebug"? For example: I'd add a paragraph at the beginning explaining what "Xdebug interacts with IDEs to provide step debugging functionality" means in plain English. I'd also add a graf with a context/"big picture" overview of how Xdebug works. Again, in very simple/plain English. The "Activating Step Debugging" section should have a graf at the top saying "Since most PHP coders use an IDE, here are links to config VSC/phpStorm for Xdebug. Follow those instructions and skip everything below." [or whatever] This, again, helps 0000037:0000090% of folks immediately. Etc etc. The idea is that I would expand slightly on what you have, talk in simpler language, and provide more context (as well as more direct help for the IDE users). These changes make it MASSIVELY more accessible to beginners. And of course, this is all to support the goals of having more people use Xdebug and make entry much easier. If you say "it's fine like it is," sure. But my suggestions definitely support those goals and wouldn't take away from anything there now. | ||||
Tags | No tags attached. | ||||
Operating System | |||||
PHP Version | 7.4.0-7.4.4 | ||||
Date Modified | Username | Field | Change |
---|---|---|---|
2020-06-23 20:03 | derick | New Issue | |
2020-06-23 20:04 | derick | Severity | minor => feature |
2020-06-23 20:04 | derick | Status | new => confirmed |
2021-03-15 15:10 | derick | Assigned To | => derick |
2021-03-15 15:10 | derick | Status | confirmed => closed |
2021-03-15 15:10 | derick | Resolution | open => no change required |
2021-03-15 15:10 | derick | Note Added: 0005712 |