freeCodeCamp / devdocs

API Documentation Browser
https://devdocs.io
Mozilla Public License 2.0
35.32k stars 2.36k forks source link

Documentation versions report for October 2020 #1284

Closed devdocs-bot closed 3 years ago

devdocs-bot commented 4 years ago

What is this?

This is an automatically created issue which contains information about the version status of the documentations available on DevDocs. The results of this report can be used by maintainers when updating outdated documentations.

Maintainers can close this issue when all documentations are up-to-date. The issue is also automatically closed when the next report is created.

~This issue was created by Travis CI build #1039.~ ~Manually updated on 2020-11-13T23:30:00+00:00.~ ~Manually updated on 2020-11-17T11:00:00+00:00.~ ~Manually updated on 2020-11-18T21:25:00+00:00.~ ~Manually updated on 2020-11-18T23:30:00+00:00.~ Manually updated on 2020-11-19T10:00:00+00:00.

Results

The 168 documentations are divided as follows:

Outdated documentations (76) Documentation | Scraper version | Latest version -|-|- Chef | 12.13 | 16.6.14 CoffeeScript | 2.4.1 | 2.5.1 Composer | 1.9.0 | 2.0.7 CSS | 2020-11-14 | 2020-11-18 D | 2.088.0 | 2.094.2 D3.js | 5.7.0 | 6.2.0 Dart | 2.5.0 | 2.10.4 DOM | 2018-11-25 | 2020-08-06 DOM Events | 2018-11-24 | 2020-11-19 Drupal | 8.1.7 | 9.0.0 Ember.js | 2.15.0 | 3.22 Enzyme | 3.10.0 | 3.11.0 Erlang | 21.0 | 23.1.3 Express | 4.16.3 | 4.17.1 Grunt | 1.0.1 | 1.3.2 Handlebars.js | 4.0.12 | 4.7.6 Haskell | 8.8.3 | 8.10.2 HTML | 2020-11-14 | 2020-11-19 Immutable.js | 3.8.1 | 4.0.0-rc.12 InfluxData | 1.3 | 2.0.1 Jasmine | 3.3.0 | 3.6.0 JavaScript | 2020-11-14 | 2020-11-19 Julia | 1.2.0 | 1.5.3 Knockout.js | 3.4.2 | 3.5.1 Koa | 2.6.1 | 2.13.0 LÖVE | 0.10.2 | 11.3 MariaDB | 10.4.8 | 10.5.8 Marionette.js | 4.0.0 | 4.1.3 Matplotlib | 3.1.1 | 3.3.3 Meteor | 1.5.2 | 1.11 Moment.js | 2.22.1 | 2.29.1 Mongoose | 5.8.5 | 5.10.15 Nim | 0.19.0 | 1.4.0 Node.js | 14.15.0 | 15.2.1 npm | 6.4.0 | 7.0.12 Octave | 5.1.0 | 5.2.0 OpenJDK | 11.0.9 | 15 OpenTSDB | 2.3.0 | 2.4.0 Padrino | 0.14.4 | 0.15.0 pandas | 0.25.0 | 1.1.4 Perl | 5.26.0 | 5.32.0 Phalcon | 3.1.1 | 3.4 Phaser | 2.6.2 | 3.24.1 PHP | 7.2.9 | 7.4 PHPUnit | 6.5 | 9.3 Pony | 0.30.0 | 0.38.1 Puppeteer | 1.20.0 | 5.5.0 Pygame | 1.9.6 | 2.0.0 Qt | 5.13 | 5.15 Ramda | 0.26.1 | 0.27.0 ReactNative | 0.56 | 0.63 Redis | 5.0.0 | 6.0.9 Redux | 3.7.2 | 4.0.5 Relay | 1.4.1 | 10.1.0 RethinkDB | 2.3.5 | 2.4.1 Ruby / Minitest | 5.11.3 | 5.14.2 SaltStack | 2019.2.0 | 3002.2 Sass | 3.5.3 | 3.6.4 scikit-image | 0.14.1 | 0.17.2 scikit-learn | 0.20.0 | 0.23.2 Sequelize | 5.21.1 | 6.3.5 Sinon.JS | 7.1.1 | 9.2.1 Socket.IO | 1.4.5 | 3.0.3 Statsmodels | 0.9.0 | 0.12.1 Support Tables | 2018-11-25 | 2020-10-26 Symfony | 4.1.7 | 5.1.8 Terraform | 0.11.7 | 0.13.5 Trio | 0.12.1 | 0.17.0 Twig | 2.5.0 | 3.1.1 TypeScript | 3.7.4 | 4.0.5 Underscore.js | 1.9.1 | 1.11.0 Vue Router | 3.1.2 | 3.4.9 Vuex | 3.1.1 | 3.5.1 Vulkan | 1.0.59 | 1.2.161 webpack | 4.16.5 | 5.5.1 Yarn | 1.19.0 | 1.22.10
Up-to-date documentations (92) Documentation | Scraper version | Latest version -|-|- Angular | 11.0.0 | 11.0.1 Angular.js | 1.8.2 | 1.8.2 Ansible | 2.10.3 | 2.10 Apache HTTP Server | 2.4.37 | 2.4.46 Apache Pig | 0.17.0 | 0.17.0 Async | 3.2.0 | 3.2.0 Babel | 7.12.6 | 7.12.6 Backbone.js | 1.4.0 | 1.4.0 Bash | 5.0 | 5.0 Bluebird | 3.7.2 | 3.7.2 Bootstrap | 4.5 | 4.5 Bottle | 0.12.13 | 0.12 Bower | 1.8.4 | 1.8.8 C | 2019-09-02 | 2019-06-07 C++ | 2019-09-02 | 2019-06-07 CakePHP | 4.1.6 | 4.1 Chai | 4.2.0 | 4.2.0 Clojure | 1.10 (stable) | 1.10.1 CMake | 3.19.0 | 3.19 Codeception | 4.1.12 | 4.1.12 CodeceptJS | 3.0.2 | 3.0.2 CodeIgniter | 4.0.4 | 4.0.4 Cordova | 9.0.0 | 9 Crystal | 0.35.1 | 0.35.1 Cypress | 5.6.0 | 5.6.0 Django | 3.1.4 | 3.1 Django REST Framework | 3.9.3 | 3.9.3 Docker | 19.03 | 19.03 Dojo | 1.10 | 1.10 Electron | 11.0.1 | 11.0.1 Elisp | 27.1 | 27.1 Elixir | 1.11.2 | 1.11.2 ESLint | 7.13.0 | 7.13.0 Falcon | 2.0.0 | 2.0.0 Fish | 3.1.2 | 3.1.2 Flow | 0.138.0 | 0.138.0 GCC | 10.2.0 | 10.2 Git | 2.29.2 | 2.29.2 GNU Fortran | 10.2.0 | 10.2 GnuCOBOL | 3.1 | 3.1 Gnuplot | 5.2.8 | 5.2 Go | 1.15 | 1.15 Godot | 3.2.3 | 3.2.3 Graphite | 1.1.4 | 1.1.7 Haxe | 4.1.3 | 4.1.3 Homebrew | 2.5.11 | 2.5.11 HTTP | 2020-11-18 | 2020-11-17 Jekyll | 4.1.1 | 4.1.1 Jest | 26.6 | 26.6 jQuery | 3.5.1 | 3.5.1 jQuery Mobile | 1.4.5 | 1.4.5 jQuery UI | 1.12.1 | 1.12.1 JSDoc | 3.5.5 | 3.5.5 Kotlin | 1.4.10 | 1.4.10 Laravel | 8.4.1 | 8.4.2 Leaflet | 1.7.1 | 1.7.1 Less | 3.12.0 | 3.12.0 Liquid | 4.0.0 | 4.0.3 lodash | 4.17.10 | 4.17.15 Lua | 5.4.1 | 5.4 Markdown | 2015-03-15 | 1.0.0 Mocha | 8.2.1 | 8.2.1 Modernizr | 3.11.3 | 3.11.3 nginx | 1.19.3 | 1.19.4 nginx / Lua Module | 0.10.13 | 0.10.19 Nokogiri | 1.10.4 | 1.10.10 NumPy | 1.17.0 | 1.17.0 Phoenix | 1.5.6 | 1.5.6 PostgreSQL | 13.1 | 13.1 Pug | 3.0.0 | 3.0.0 Python | 3.9.0 | 3.9.0 PyTorch | 1.7.0 | 1.7.0 Q | 1.5.1 | 1.5.1 React | 17.0.1 | 17.0.1 ReactiveX | 2019-10-20 | 2019-01-20 RequireJS | 2.3.5 | 2.3.6 Ruby | 2.7.2 | 2.7.2 Ruby on Rails | 6.0.0 | 6.0.3.4 Rust | 1.47.0 | 1.47.0 RxJS | 6.5.2 | 6.5.5 Scala | 2.13.0 | 2.13.3 Spring Boot | 2.4.0 | 2.4.0 SQLite | 3.33.0 | 3.33.0 SVG | 2020-11-14 | 2020-08-06 Tcl/Tk | 8.6.6 | 8.6.10 TensorFlow | 2.3.0 | 2.1.2 TensorFlow C++ | 2.3.0 | 2.1.2 Vagrant | 2.2.0 | 2.2.13 Vue.js | 2.6.10 | 2.6.11 WordPress | 5.5.3 | 5.5.3 XSLT & XPath | 2020-11-14 | 2020-08-06 Yii | 2.0.12 | 2.0.39.2
scherepn commented 4 years ago
Updated 2020-11-19T10:00:00 Documentation Up to date? Working scraper "Trivial" to Update Notes
C Unknown Unknown Unknown Couldn't find zip, didn't look that hard
Chef No No No Site is entirely different
Codeigniter Yes Yes N/A Source documentation has problems that aren't fixable by us
CoffeeScript No Yes Yes Only very minor changes
Composer No Yes Yes Looks trivial
CPP Yes Unknown Unknown Didn't check
Cypress No Yes Yes Looks trivial to update
D No Yes Yes Looks trivial to update
D3 No No* No Entity extractor needs fixing, versioning could improved
Dart No Unknown Unknown Filesystem scraper, didn't test
Docker No No No changed layout and markup on site
Dojo Yes No No Unknown how much work to update
Drupal No No No Looks nontrivial
Ember No No No Pages generated without errors, but scraper/entity extractor needs updating
Enzyme No Yes Yes trivial to update
Erlang No Unknown Unknown File Scraper, didn't check
Express No Yes Yes Trivial to update
Gnuplot Unknown Unknown Unknown Filescraper, did not check
Graphite No Yes No Entity extractor goofs on a small number of items
Grunt No Yes Yes Trivial to update
Handlebars No No No Doesn't look that hard, but still nontrivial
Haskell No Yes Yes Trivial to update, needed extremely small modification to Scraper
ImmutableJS No No No Looks simple-ish to fix though
InfluxData No No No Site completely changed
Jasmine No Yes Yes trivial to update
JSDoc Yes No Yes Trivial to fix. Domain name changed. github function for determining release isn't correct.
Julia No No No Entity extractor works, HTML cleaner and CSS need human review/fixing
Knockout No No No Seems simple, but HTML has changed
Koa No Yes Yes trivial to update
Lodash No Yes Yes trivial to update
Love No Yes Yes Trivial to update
MariaDB No Yes No entity extractor/filtering needs updating
Marionette No Yes Yes latest documentation is 4.1.2, which is not the same as latest software version
Markdown No No No html has changed, probably not that hard
Matplotlib No Yes Yes add two minor versions
Meteor No No Yes* Errors during generation, closer look needed
Moment No No No HTML on site appears to have changed
Mongoose No No Yes* Errors during generation, closer look needed
Nim No Yes No Entity extractor needs fixing/addressing with some human eyes
Nokogiri Unknown Unknown Unknown Filescraper, didn't check
Npm No No No HTML changed, Unknown amount of work to fix
Octave Yes No No HTML changed, unknown about of work to fix
OpenJDK No Unknown Unknown FileScraper, did not check
OpenTSDB No Yes Yes* The 'types' list changed, needs human review
Padrino No Yes Yes trivial to update
Pandas No No No Page layout and content changed
Perl No Unknown No* FileScraper, so I didn't check, but the HTML on the website doesn't appear to have changed.
Phalcon No No No Page layout and content changed, needs human review
Phaser No No No Website is completely different
Phoenix No Yes Yes looks trivial to update
PHP No Unknown Unknown FileScraper, didn't check
PHP Unit No No No Moved to ReadTheDocs, will require rewrite
Pony No Yes Yes Looks trivial
Pug No Yes Yes* Errors during generation, could use some human eyes just in case
Puppeteer No No Yes Path changed, easy to fix
PyGame No Yes Yes trivial to update
QT No Yes Yes Checked 5.14 and 5.15
Ramda No Yes Yes Trivial to update
ReactNative No No No website completely changed
Redux No No No website completely changed
Relay No No No website completely changed
RequireJS Yes No Unknown Not sure what happened here, the page is the same
RethinkDB No Yes Yes Trivial to update
Salt Stack No Unknown Unknown File scraper, didn't test
SASS No No No Page layout changed
Scala Yes Unknown Unknown FileScraper, didn't test
ScikitImage No No No page layout changed
ScikitLearn No No No Page layout changed
Sequelize No Yes Yes trivial to update. This would also be an easy candidate for multiversion
Sinon No No Yes* The entity extractor needs human eyes, the HTML format changed slightly
SocketIO No No No HTML on the pages changed
SQLite Yes Unknown N/A FileScraper, didn't check
Statsmodels No No No layout and content changed
SupportTables No Yes Yes Trivial to update
Symfony No No No Website completely changed
TclTk Yes Yes Yes Trivial to update. Our custom CSS could be improved a bit for some API Pages
Terraform No Yes? Maybe? Results look fine, but page scraper generated errors, should be looked at closer. Also, Categories are completely different, a Terraform domain expert should review.
Trio No Yes? Yes? Scraper worked, but a type disappeared between versions. Domain expert should look into this further
Twig No Yes Yes Looks trivial to update
TypeScript No No No Website changed
Vagrant Yes No No Website changed
VueRouter No No No Website changed
Vuex No No No website changed
Vulkan No Maybe No Looks like a minor change, shouldn't be much work. Also, it's a great candidate for multiversion
Webpack No N/A N/A Capybara load issue, couldn't test
Yarn No No No Website layout and content changed
Yii No No No Website layout and content changed
simon04 commented 4 years ago

I've manually updated the analysis in https://github.com/freeCodeCamp/devdocs/issues/1284#issue-725145872 based on the @jmerle's get_latest_version fixes from #1294.

@scherepn, thank you; the triviality assessments seem to be very helpful!

Eventually, we might have to find a way so synchronise the lists as well as open GitHub issues, open PRs…

simon04 commented 4 years ago

@jmerle via https://gitter.im/FreeCodeCamp/DevDocs?at=5faedbae74152347c2318a7f

As far as statistics go, nothing official but I did happen to have the same question some days ago so compiled this list of off the MaxCDN cache hits (https://cp.maxcdn.com/reporting/files?zone_dropdown=devdocs-s3&zone_id=222982&daterangetype=custom&date_from=01%2F01%2F2020&date_to=11%2F30%2F2020&_csrf=449e77b89bf4526c5943f8185e5808070493843af19be5ea133fcfe60cad69fc):

file hits amount of total
/javascript/index.json 348664 12.42%
/dom/index.json 323611 11.53%
/css/index.json 317926 11.33%
/html/index.json 316319 11.27%
/dom_events/index.json 305211 10.88%
/http/index.json 302786 10.79%
/javascript/index.html 64744 2.31%
/c/index.json 58658 2.09%
/html/index.html 58256 2.08%
/css/index.html 43531 1.55%
/cpp/index.json 40974 1.46%
/dart~2/index.json 38249 1.36%
/cpp/index.html 36703 1.31%
/php/index.json 32459 1.16%
/puppeteer/index.html 27994 1.00%
/c/index.html 27733 0.99%
/puppeteer/index.json 26951 0.96%
/dart~1/index.json 26588 0.95%
/node/index.json 25571 0.91%
/git/index.json 22093 0.79%
/drupal~8/index.json 22088 0.79%
/d/index.json 18405 0.66%
/wordpress/index.json 16670 0.59%
/go/index.json 15782 0.56%
/markdown/index.json 15412 0.55%
simon04 commented 4 years ago

Again, I've manually updated the analysis in https://github.com/freeCodeCamp/devdocs/issues/1284#issue-725145872

devdocs-bot commented 3 years ago

This report was superseded by #1359.