Break up documentation of scraper version checking utility methods into different sections based on purpose. Also add missing documentation for get_latest_github_commit_date() method.
Unified · Split
| @@ -190,6 +190,8 @@ More information about how filters work is available on the [Filter Reference](. · 189 unmodified lines | ||
| 190 | 190 | In order to keep scrapers up-to-date the `get_latest_version(opts)` method should be overridden. If `self.release` is defined, this should return the latest version of the documentation. If `self.release` is not defined, it should return the Epoch time when the documentation was last modified. If the documentation will never change, simply return `1.0.0`. The result of this method is periodically reported in a "Documentation versions report" issue which helps maintainers keep track of outdated documentations. |
| 191 | 191 | |
| 192 | 192 | To make life easier, there are a few utility methods that you can use in `get_latest_version`: |
| 193 | + | |
| 194 | +### General HTTP methods | |
| 193 | 195 | * `fetch(url, opts)` |
| 194 | 196 | |
| 195 | 197 | Makes a GET request to the url and returns the response body. |
| @@ -205,11 +207,15 @@ To make life easier, there are a few utility methods that you can use in `get_la · 9 unmodified lines | ||
| 205 | 207 | Makes a GET request to the url and returns the JSON body converted to a dictionary. |
| 206 | 208 | |
| 207 | 209 | Example: [lib/docs/scrapers/mdn/mdn.rb](../lib/docs/scrapers/mdn/mdn.rb) |
| 210 | + | |
| 211 | +### Package repository methods | |
| 208 | 212 | * `get_npm_version(package, opts)` |
| 209 | 213 | |
| 210 | 214 | Returns the latest version of the given npm package. |
| 211 | 215 | |
| 212 | 216 | Example: [lib/docs/scrapers/bower.rb](../lib/docs/scrapers/bower.rb) |
| 217 | + | |
| 218 | +### GitHub methods | |
| 213 | 219 | * `get_latest_github_release(owner, repo, opts)` |
| 214 | 220 | |
| 215 | 221 | Returns the tag name of the latest GitHub release of the given repository. If the tag name is preceded by a "v", the "v" will be removed. |
| @@ -225,3 +231,8 @@ To make life easier, there are a few utility methods that you can use in `get_la · 9 unmodified lines | ||
| 225 | 231 | Returns the contents of the requested file in the default branch of the given repository. |
| 226 | 232 | |
| 227 | 233 | Example: [lib/docs/scrapers/minitest.rb](../lib/docs/scrapers/minitest.rb) |
| 234 | +* `get_latest_github_commit_date(owner, repo, opts)` | |
| 235 | + | |
| 236 | + Returns the date of the most recent commit in the default branch of the given repository. | |
| 237 | + | |
| 238 | + Example: [lib/docs/scrapers/reactivex.rb](../lib/docs/scrapers/reactivex.rb) | |