Refactor

[sagikazarmark]

Things worth to mention:

• Removed the package overview page. We should readd it at some point if it is necessary, but from the refactoring point of view I just couldn't place it anywhere.
• Moved all HTTPlug related stuff under the HTTPlug group
• Moved all other stuff under the Components group
• Line character limits
• Added some text to the index

Please review as I cannot read any more docs and I am sure it is full of mistakes.

[dbu]

why remove the phpdoc explanation?

[sagikazarmark]

Not sure if it's an addition. The example code is pretty clean I think. I can add it back if you think it adds any value.

[dbu]

i would want my code to have this comment. IDEs don't show you the constructor code, but they show the phpdoc of the constructor, so this would help understand what the semantics of the constructor are.

[dbu]

great job! i commented on quite some places (and github did not see some of the moves, considering whole files as new. so i probably reviewed some text that you did not change at all)

[sagikazarmark]

Thanks for the review. I applied the suggested changes, commented on a few. We will probably have to proofread the whole docs before release.

[dbu]

great. i suggest we merge this and do further proofreading / review / improvements on the doc as people see things. this is a PR that should not stay open for long, or we risk annoying merge conflicts due to all the files moving around.

[sagikazarmark]

Agree.