Răsfoiți Sursa

Improve version check methods documentation

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.
Phil Scherer 5 ani în urmă
părinte
comite
5840d8dc29
1 a modificat fișierele cu 11 adăugiri și 0 ștergeri
  1. 11 0
      docs/scraper-reference.md

+ 11 - 0
docs/scraper-reference.md

@@ -190,6 +190,8 @@ More information about how filters work is available on the [Filter Reference](.
 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.
 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.
 
 
 To make life easier, there are a few utility methods that you can use in `get_latest_version`:
 To make life easier, there are a few utility methods that you can use in `get_latest_version`:
+
+### General HTTP methods
 * `fetch(url, opts)`
 * `fetch(url, opts)`
 
 
   Makes a GET request to the url and returns the response body.
   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
   Makes a GET request to the url and returns the JSON body converted to a dictionary.
   Makes a GET request to the url and returns the JSON body converted to a dictionary.
 
 
   Example: [lib/docs/scrapers/mdn/mdn.rb](../lib/docs/scrapers/mdn/mdn.rb)
   Example: [lib/docs/scrapers/mdn/mdn.rb](../lib/docs/scrapers/mdn/mdn.rb)
+
+### Package repository methods
 * `get_npm_version(package, opts)`
 * `get_npm_version(package, opts)`
 
 
   Returns the latest version of the given npm package.
   Returns the latest version of the given npm package.
 
 
   Example: [lib/docs/scrapers/bower.rb](../lib/docs/scrapers/bower.rb)
   Example: [lib/docs/scrapers/bower.rb](../lib/docs/scrapers/bower.rb)
+
+### GitHub methods
 * `get_latest_github_release(owner, repo, opts)`
 * `get_latest_github_release(owner, repo, opts)`
 
 
   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.
   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
   Returns the contents of the requested file in the default branch of the given repository.
   Returns the contents of the requested file in the default branch of the given repository.
 
 
   Example: [lib/docs/scrapers/minitest.rb](../lib/docs/scrapers/minitest.rb)
   Example: [lib/docs/scrapers/minitest.rb](../lib/docs/scrapers/minitest.rb)
+* `get_latest_github_commit_date(owner, repo, opts)`
+
+    Returns the date of the most recent commit in the default branch of the given repository.
+
+    Example: [lib/docs/scrapers/reactivex.rb](../lib/docs/scrapers/reactivex.rb)