devdocs
devdocs copied to clipboard
Update Phalcon version 3 and add Phalcon version 4
- [x] Updated the versions and releases in the scraper file
- [x] Ensured the license is up-to-date and that the documentation's entry in the array in
about_tmpl.coffee
matches it's data inself.attribution
- [x] Ensured the icons and the
SOURCE
file inpublic/icons/your_scraper_name/
are up-to-date if the documentation has a custom icon - [x] Ensured
self.links
contains up-to-date urls ifself.links
is defined - [x] Tested the changes locally to ensure:
- The scraper still works without errors
- The scraped documentation still looks consistent with the rest of DevDocs
- The categorization of entries is still good
Note that version 2 was removed because its documentation pages are no longer available.
Note that version 2 was removed because its documentation pages are no longer available.
If feasible, we should archive the old versions in devdocs nevertheless…
Syntax highlighting is broken:
Syntax highlight added and style improved. Proceed to review
The methods of a class lost their styles…
This lack of style happened because of the html implemented in the page. Now phalcon docs use 'p' and 'table' tags for methods without any particular id or class, as you can see in the images I'm attaching. Style can be implemented but I have to figure out how since traversing through all the 'p' and 'table' tags would break the style.
Wow. The new phalcon documentation is truly terrible. It's perhaps the worst documentation I've seen so far.
It may actually be easier to contact the Phalcon team and work with them to improve their documentation than fix it on our end.